功能描述

通常来说,如果直播观众希望切换到另外一个直播频道,需要依次调用如下方法:

  • leaveChannel,用以离开当前频道
  • joinChannel,用以加入新的频道

Agora Native SDK 从 v2.9.0 开始,提供新接口 switchChannel,帮助直播频道的观众更快实现直播频道切换。

实现方法

实现快速切换频道前,请确保你已在项目中实现了互动直播功能,详见开始互动直播

互动直播过程中,观众加入频道后只需调用 switchChannel 方法,就可以快速切换到另外一个直播频道。你需要在该方法中传入想要加入的新频道的 Token 和频道名。

成功调用 switchChannel 方法切换到其他频道后,本地会先收到离开原频道的回调 onLeaveChannel,再收到成功加入新频道的回调 onJoinChannelSuccess

API 调用时序

下图展示切换频道的 API 调用时序:

示例代码

你可以参考下面的示例代码片段,调用 switchChannel 在项目中实现快速切换频道:

m_lpAgoraEngine->switchChannelChannel(YOUR_TOKEN, channelName)

API 参考

开发注意事项

switchChannel 方法仅适用于直播频道中的观众用户。