本文档主要介绍如何主动退出当前 TRTC 房间,同时还会介绍在什么情况下会被迫退出房间。
调用指引
步骤1:完成前序步骤
参考文档 导入 SDK 到项目中 完成 SDK 的导入和 App 权限的配置。
参考文档 进入房间 完成进房流程。
步骤2:主动退出当前房间
import TrtcCloud from "@/TrtcCloud/lib/index";this.trtcCloud = TrtcCloud.createInstance();// 退出当前房间this.trtcCloud.exitRoom();
关键任务一:通告自己的离开
通知房间中的其他用户自己将要退出当前的这个房间,房间中的其他用户会收到来自该用户的 onRemoteUserLeaveRoom 回调,否则其他用户可能误以为该用户已经“卡死了”。
关键任务二:释放设备权限
如果用户在退房之前正在发布音视频流,则退房流程中还需要关闭摄像头和麦克风并释放设备的使用权限。
步骤3:被迫退出当前房间
情况一:被踢出当前房间
用户被踢出后,该用户会收到 onExitRoom(1) 的回调。
情况二:当前房间被解散
解散房间后,该房间的所有用户都会收到 onExitRoom(2) 的回调。
import TrtcCloud from "@/TrtcCloud/lib/index";this.trtcCloud = TrtcCloud.createInstance();// 监听 onExitRoom 回调即可获知自己的退房原因this.trtcCloud.on('onExitRoom', (reason) => {console.log(`onExitRoom reason = ${reason}`);});