Method
离开频道。
调用该方法后,SDK 会终止音视频互动、离开当前频道,并会释放会话相关的所有资源。
调用 joinChannelEx 成功加入频道后,必须调用本方法或 leaveChannelEx 结束通话,否则无法开始下一次通话。
注意
- 该方法是异步操作,调用返回时并没有真正退出频道。
- 如果你调用了 api_irtcengine_leavechannel.html 或 leaveChannel 后,会同时离开 joinChannel 或 joinChannelWithOptions 及 joinChannelEx 加入的频道。
适用场景
该方法适用于多频道场景。
调用时机
该方法需要在 joinChannelEx 后调用。
调用限制
如果你调用了该方法后立即调用 destroy 方法,SDK 将不会触发 onLeaveChannel 回调。
相关回调
成功调用该方法离开频道后会触发以下回调:
- 本地:onLeaveChannel 回调。
- 远端:主播离开频道后,远端会触发 onUserOffline 回调。
参数
- connection
- Connection 信息。详见 RtcConnection。
返回值
- 0: 方法调用成功。
- < 0: 方法调用失败。详见错误码了解详情和解决建议。