在加入频道前,请确保你已完成环境准备、安装包获取等步骤,详见客户端集成

实现方法

App 在加入频道前,需要先设置频道模式,再加入频道。

设置频道模式为直播

创建实例后,调用 setChannelProfile 方法设置频道模式。SDK 会根据所设置的频道模式使用不同的优化手段。 在该方法中,将频道模式设置为直播模式。直播模式用于频道内有主播和观众两种角色的直播场景。主播收发语音和视频消息,观众只收不发。

  • 该方法必须在加入频道前调用才能生效。
  • 同一频道只能设置一种频道模式。如果需要切换频道模式,请先调用 destroy 方法销毁后重新创建一个 Engine 实例,再调用该方法将频道设置为其他模式。
mRtcEngine.setChannelProfile(Constants.CHANNEL_PROFILE_LIVE_BROADCASTING);

加入直播频道

调用 joinChannel 方法加入频道。在该方法中:

在该方法中:

  • 传入能标识用户角色和权限的 Token。如果安全要求不高,也可以将值设为 null。Token 需要在应用程序的服务器端生成,具体生成办法,详见 密钥说明
  • 传入能标识频道的频道 ID。输入相同频道 ID 的用户会进入同一个频道。
  • 频道内每个用户的 UID 必须是唯一的。如果将 UID 设为 0,系统将自动分配一个 UID。

如果已在频道中,用户必须调用 leaveChannel 方法退出当前频道,才能进入下一个频道。

 private void joinChannel() {
    mRtcEngine.joinChannel(null, "demoChannel1", "Extra Optional Data", 0); // if you do not specify the uid, Agora will assign one.
}

相关文档

成功加入频道后,你可以使用 Agora SDK,实现如下功能进行互动直播:

在直播过程中,如果对音量、音效、视频分辨率等有特殊需求,你还可以: