乐趣区

关于音视频:教你30分钟快速搭建直播间

jiezi

秀场直播既能够实现单人视频直播，也能够邀请观众上麦、进行多人连麦互动。您能够通过如下视频疾速理解秀场直播的次要性能演示和接口调用。

1 架构设计

秀场直播场景的次要架构如下图所示（以多人连麦直播互动为例）：

2 筹备环境

在开始集成 ZEGO Express SDK 前，请确保开发环境满足以下要求：

  • Android Studio 2020.3.1 或以上版本。

Android Studio 版本编号零碎的变更请参考 Android Studio 版本阐明。

  • Android SDK 25、Android SDK Build-Tools 25.0.2、Android SDK Platform-Tools 25.x.x 或以上版本。
  • Android 4.4 或以上版本，且反对音视频的 Android 设施。
  • Android 设施曾经连贯到 Internet。

3 集成 SDK

3.1（可选）新建我的项目

此步骤以如何创立新我的项目为例，如果是集成到已有我的项目，可疏忽此步。

  1. 关上 Android Studio，抉择“File > New > New Project”菜单。

  1. 填写我的项目名及我的项目存储门路。

  1. 其它依照默认设置，单击“Next”，最初单击“Finish”实现新工程创立。

3.2 导入 SDK

目前反对的平台架构包含：armeabi-v7a、arm64-v8a、x86、x86_64。

开发者可通过以下任意一种形式实现集成 SDK。

形式一：应用 JitPack 主动集成 SDK

  1. 进入我的项目根目录，关上“build.gradle”文件，在“allprojects”中退出如下代码。

    ...
allprojects {
    repositories {maven { url 'https://www.jitpack.io'}
        google()
        jcenter()}
}

  2. 进入“app”目录，关上“build.gradle”文件，在“dependencies”中增加 implementation 'com.github.zegolibrary:express-video:2.+'，这样能获取到最新的版本，如果须要下载指定版本，请从 https://jitpack.io/#zegolibrary/express-video 查问具体版本号，并将2.+ 批改为指定的版本号。

    ...
dependencies {
    ...
    implementation 'com.github.zegolibrary:express-video:2.+'
}
    • 从 2.7.0 版本开始，Zego 将应用 JitPack 代替 JCenter 作为 SDK 托管服务器，因而开发者需手动将 build.gradle 里的配置变更为'com.github.zegolibrary:express-video:2.+'
    • JCenter2021-03-31之后进行上传新版本 SDK，该服务将于2021-05-01 停用，详情请参考 Service End for JCenter。

    • 从 1.11.0 版本开始，依赖的命令从 implementation 'im.zego:express-engine-video:x.y.z' 改为 implementation 'im.zego:express-video:x.y.z'。应用1.11.0 以下 的版本不受影响，但后续不再从“express-engine-video”里更新，倡议所有应用旧版本的开发者切换到 1.11.0 或以上 的版本进行集成。

      形式二：复制 SDK 文件手动集成

  3. 请参考 下载 SDK 包，下载最新版本的 SDK。
  4. 解压 SDK 至我的项目目录，如“app/libs”。

  1. 增加 SDK 援用，进入到“app”目录，关上“build.gradle”文件。

    • 在“defaultConfig”节点增加“ndk”节点，指定反对的平台类型。

    ndk {abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'}
    • 在“android”节点增加“sourceSets”节点，指定“libs”所在目录。

    <div class=”mk-hint”>

示例代码中“libs”目录仅为举例，开发者可依据理论门路填写。

implementation fileTree(dir: 'libs', include: ['*.jar'])

4 设置权限

依据理论利用须要，设置利用所需权限。

进入“app/src/main”目录，关上“AndroidManifest.xml”文件，增加权限。

<!-- SDK 必须应用的权限 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- App 须要应用的局部权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

<uses-feature
    android:glEsVersion="0x00020000"
    android:required="true" />

<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

<div class=”mk-warning”>

因为 Android 6.0 在一些比拟重要的权限上要求必须申请动静权限，不能只通过“AndroidMainfest.xml”文件申请动态权限。因而还须要参考执行如下代码，其中“requestPermissions”是“Activity”的办法。
</div>

String[] permissionNeeded = {
    "android.permission.CAMERA",
    "android.permission.RECORD_AUDIO"};

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {if (ContextCompat.checkSelfPermission(this, "android.permission.CAMERA") != PackageManager.PERMISSION_GRANTED ||
        ContextCompat.checkSelfPermission(this, "android.permission.RECORD_AUDIO") != PackageManager.PERMISSION_GRANTED) {requestPermissions(permissionNeeded, 101);
    }
}

具体的权限阐明如下：

<colgroup>
</colgroup>
必要性 权限 权限阐明 申请起因
必要权限 INTERNET 拜访网络权限。 SDK 基本功能都须要在联网的状况下才能够应用。
ACCESS_WIFI_STATE 获取以后 WiFi 状态权限。 SDK 会依据网络状态的扭转执行不同的操作。例如当网络重连的时候，SDK 外部会将网络断开时的状态都复原，用户不需做额定的操作。
ACCESS_NETWORK_STATE 获取以后网络状态权限。
CAMERA 拜访相机权限。 预览和发送视频的时候须要应用该权限。
RECORD_AUDIO 录制音频权限。 发送音频的时候须要应用该权限。
BLUETOOTH 连贯蓝牙设施权限。 连贯蓝牙设施时须要应用该权限。
MODIFY_AUDIO_SETTINGS 批改音频配置权限。 批改音频设备配置时须要应用该权限。
WRITE_EXTERNAL_STORAGE 内置 SDK 写权限。 SDK 会将日志和相干配置文件保留在内置 SDK 内。
非必要权限 READ_PHONE_STATE 容许以只读形式拜访电话状态，包含以后的呼叫状态。 SDK 会依据以后的呼叫状态，启停音频设备。如监听到以后为呼叫状态，则 SDK 会主动停止使用音频设备，直到通话完结。

<div class=”mk-hint”>

其中非必要权限“android.permission.READ_PHONE_STATE”仅用于实现 SDK 的打断事件处理，因而只需在 AndroidMainfest.xml 文件中进行申明即可，不须要动静申请（业务方有需要则另外解决）。
</div>

5 避免混同代码

在“proguard-rules.pro”文件中，为 SDK 增加 -keep 类的配置，避免混同 SDK 公共类名称。

-keep class **.zego.**{*;}

6 实现流程

秀场直播场景的整体流程如下：

  1. 主播、观众均通过信令模块进行连贯，信令模块能够管制以后业务房间内的直播流程，同步并告诉各端以后的直播状态。
  2. 无论是否有连麦观众, 主播和观众均通过 ZEGO 音视频云服务进行推拉流。
  3. 观众申请与主播连麦后，信令模块会告诉主播，并同步连麦者的个人信息。
  4. 主播承受连麦申请后，连麦观众开始推流，房间内所有成员将会接管到流更新告诉，并拉取连麦观众的音视频流。
  5. 若连麦观众不再须要连麦，则向业务后盾发动下麦申请。收到信令模块的下麦告诉后，连麦观众进行推流，主播进行拉取该观众流，房间内的其余观众也进行拉流。

单主播推流，观众拉流、申请连麦、推流、下麦的具体流程图如下：

6.1 初始化 SDK

在应用 Express Video SDK 进行视频通话之前，须要初始化 SDK。因为初始化操作 SDK 时，外部解决的操作较多，倡议开发者在 App 启动的时候进行。

/** 定义 SDK 引擎对象 */
ZegoExpressEngine engine;

ZegoEngineProfile profile = new ZegoEngineProfile();
/** 请通过官网注册获取，格局为 123456789L */
profile.appID = appID;
/** 64 个字符，请通过官网注册获取，格局为 "0123456789012345678901234567890123456789012345678901234567890123" */
profile.appSign = appSign;
/** 通用场景接入 */
profile.scenario = ZegoScenario.GENERAL;
/** 设置 app 的 application 对象 */
profile.application = getApplication();
/** 创立引擎 */
engine = ZegoExpressEngine.createEngine(profile, null);

更多初始化 SDK 的细节请参考：疾速开始 – 实现流程 的“3.1 创立引擎”。

6.2 登录直播房间

主播开始直播或观众观看直播前，须要先登录到直播房间，在收到登录房间胜利的回调之后能够间接调用 SDK 的接口进行推拉流操作。

/** 创立用户 */
ZegoUser user = new ZegoUser("Anchor1");

/** 开始登录房间 */
engine.loginRoom("LiveRoom", user);

更多应用 SDK 实现登录直播房间的细节请参考：疾速开始 – 实现流程 的“3.2 登录房间”。

6.3 单主播直播

6.3.1 主播开启预览并推流

主播向 ZEGO 音视频云服务推流，须要本人生成惟一的“StreamID”，而后开始预览并推流。

// 开启预览
engine.startPreview(new ZegoCanvas(preview_view));

// 推流
engine.startPublishingStream("Anchor1");

更多应用 SDK 实现预览和推流的细节请参考：疾速开始 – 实现流程 的“3.3 推流”。

6.3.2 观众拉流

观众进入房间后，会收到 SDK 的流更新告诉，从中筛选出主播流的“StreamID”进行拉流。

// 观众拉流
ZegoCanvas zegoCanvas = new ZegoCanvas(view);
zegoCanvas.viewMode = ZegoViewMode.ASPECT_FILL;
engine.startPlayingStream("Anchor1",zegoCanvas);

更多应用 SDK 实现拉流的细节请参考：疾速开始 – 实现流程 的“3.4 拉流”。

6.4 观众连麦

6.4.1 观众推流

观众调用业务后盾申请连麦接口，调用胜利后，业务后盾向主播发送申请连麦自定义信令。主播收到信令后，调用业务后盾批准连麦接口，调用胜利后，业务后盾向房间内所有成员发送连麦胜利的播送信令，连麦观众收到信令后，开始推流。

// 连麦观众推流
engine.startPublishingStream("Audience1");

6.4.2 主播拉流

连麦观众推流后，房间内所有成员会收到 SDK 的流更新告诉，主播获取连麦观众流的 StreamID 进行拉流。

房间内其余观众也在收到流更新回调时，获取连麦观众流的 StreamID 进行拉流。

// 主播拉流 
ZegoCanvas zegoCanvas = new ZegoCanvas(view);
zegoCanvas.viewMode = ZegoViewMode.ASPECT_FILL;
engine.startPlayingStream("Audience1",zegoCanvas);

6.4.3 观众下麦

连麦观众调用业务后盾的下麦接口，调用胜利后，业务后盾向房间内所有成员发送该观众下麦的播送信令。连麦观众收到信令后进行推流，房间内其余观众收到信令后进行拉流。

// 观众进行预览和完结推流
engine.stopPreview();
engine.stopPublishingStream();
// 房间内其余成员完结拉流 
engine.stopPlayingStream("Audience1");

更多应用 SDK 实现进行推拉流的细节请参考：疾速开始 – 实现流程 的“3.6 进行推拉流”。

7 更多功能

7.1 美颜美型

基于 AI 视觉服务，提供美白、磨皮、锐化、红润等根底的美颜性能，反对大眼、瘦脸、小嘴、亮眼、白牙、瘦鼻等美型成果，打造独特天然的直播成果。详情请参考 美颜、美型。

7.2 音乐音效

反对通过获取正版曲库资源，播放背景音乐，并展现变声混响多种趣味成果。详情请参考 在线 KTV、变声 / 混响 / 立体声。

7.3 实时音讯互动

通过 ZEGO 即时通讯服务，实时展现房间内的音讯，例如发消息、进退房提醒、互动告诉等。详情请参考 即时通讯。

7.4 送礼物

用户可向房间内主播或其余指定用户赠送礼物。详情请参考 即时通讯。

获取优惠活动

  • 近期有开发布局的开发者可上即构官网查看，恰逢即构七周年全线音视频产品 1 折的优惠，适宜有估算要求的企业和集体开发工作室。
  • 获取更多商务活动热门产品，也可提交信息分割商务；
退出移动版