Docs Overview/
RTC Engine/
SDK/
Electron/
インテグレーション/
6. ルームからの退出/

6. ルームからの退出

このドキュメントでは、主に現在のTRTCからの自発的な退室方法を紹介し、どのような状況で強制的に退室するかについても紹介します：



呼び出しガイド

手順1：事前手順の完了

1. SDKのプロジェクトへのインポートを参照して、SDKのインポートおよびApp権限の設定を完了します。
2. ドキュメント入室を参照して、入室プロセスを完了してください。

手順2：現在のルームからの自発的な退室

exitRoomインターフェースを呼び出すことで現在のルームから退室できます。SDKは、退室後にonExitRoom(int reason)コールバックイベントを介して通知します。
import TRTCCloud from 'trtc-electron-sdk';
const trtcCloud = new TRTCCloud();

// 現在のルームから退室します
trtcCloud.exitRoom();
exitRoomインターフェースを呼び出すと、SDKは、退室プロセスに入ります。これには、2つの非常に重要なタスクがあります：
キータスク1：退室の公開 ルーム内の他のユーザーに、現在のルームを離れようすることを通知します。ルーム内の他のユーザーは、ユーザーからonRemoteUserLeaveRoomコールバックを受け取ります。そうしないと、他のユーザーは当該ユーザーが「デッドロック」していると誤解する可能性があります。
キータスク2：デバイス権限のリリース ユーザーが退室する前にオーディオビデオストリームを公開している場合、退室プロセスでは、カメラとマイクをオフにしたり、デバイスの使用権をリリースしたりする必要もあります。
したがって、TRTCCloudインスタンスをリリースしたい場合は、onExitRoomコールバックを受信してからリリースすることをお勧めします。


手順3：現在のルームからの強制退出

ユーザーの自発的な退室を除いて、onExitRoomコールバックを受け取る2つのケースがあります：
ケース1：現在のルームからの強制退室 サービス側のRemoveUser | RemoveUserByStrRoomIdインターフェースを介して、特定のユーザーを特定のTRTCルームから強制退室させます。当該ユーザーを強制退室させると、当該ユーザーはonExitRoom(1)のコールバックを受け取ります。
ケース2：現在のルームが解散される サーバー側のDismissRoom | DismissRoomByStrRoomIdインターフェースを介して、特定のTRTCルームを解散できます。ルームを解散すると、ルーム内のすべてのユーザーはonExitRoom(2)のコールバックを受け取ります。
// onExitRoomコールバックを監視することで、退室の理由を確認できます
function onExitRoom(reason) {
  console.log(`onExitRoom reason: ${reason}`);
}
trtcCloud.on('onExitRoom', onExitRoom);