Skip to content

离开频道

离开频道用于结束当前的 RTC 通信会话,释放相关资源。

leaveChannel

离开当前频道的方法。

方法签名

typescript
leaveChannel(): Promise<void>

使用示例

javascript
try {
  await engine.leaveChannel();
  console.log('成功离开频道');
} catch (error) {
  console.error('离开频道失败:', error);
}

离开频道的影响

1. 本地资源释放

  • 停止本地音视频采集
  • 释放本地媒体流
  • 清理本地渲染资源

2. 远端通知

  • 其他用户会收到 remoteUserOffLineNotify 事件
  • 远端用户的订阅流会被自动停止

3. 连接状态变化

  • 连接状态会变为 AliRtcConnectionStatusDisconnected
  • 触发 connectionStatusChange 事件

注意事项

  1. 资源清理: 离开频道后,确保清理所有相关的 UI 元素和事件监听器
  2. 异步操作: leaveChannel 是异步方法,需要正确处理 Promise
  3. 页面卸载: 在页面卸载时应该主动离开频道,避免资源泄漏
  4. 网络异常: 网络异常时可能导致离开频道失败,需要有相应的处理机制