本文档主要介绍如何主动退出当前 TRTC 房间,同时还会介绍在什么情况下会被迫退出房间:
调用指引
步骤1:完成前序步骤
步骤2:主动退出当前房间
调用 exitRoom 接口即可退出当前的房间,SDK 会在退房结束后通过 onExitRoom(int reason) 回调事件通知您。
await trtcCloud.exitRoom();
当您调用了 exitRoom 接口之后,SDK 会进入退房流程,其中有两项非常重要的任务:
关键任务一:通告自己的离开
通知房间中的其他用户自己将要退出当前的这个房间,房间中的其他用户会收到来自该用户的 onRemoteUserLeaveRoom 回调,否则其他用户可能误以为该用户已经“卡死了”。
关键任务二:释放设备权限
如果用户在退房之前正在发布音视频流,则退房流程中还需要关闭摄像头和麦克风并释放设备的使用权限。
因此,如果您希望释放 TRTCCloud 实例,建议等收到 onExitRoom 回调之后再释放。
步骤3:被迫退出当前房间
除了用户主动退出房间,还有两种情况下您也会收到 onExitRoom(int reason) 回调:
onRtcListener(type, param) async {
if (type == TRTCCloudListener.onExitRoom) {
if (param == 0) {
log('Exit current room by calling the 'exitRoom' api of sdk ...');
} else if (param == 1) {
log('Kicked out of the current room by server through the restful api...');
} else if (param == 2) {
log('Current room is dissolved by server through the restful api...');
}
}
}
本页内容是否解决了您的问题?