TRTCVoiceRoom (Android)

最終更新日:2021-10-12 09:40:10

    TRTCVoiceRoomは、Tencent CloudのTencent Real-Time Communication(TRTC)およびIMサービスを基に組み合わせたコンポーネントで、以下の機能をサポートしています。

    • 管理者が新しいボイスチャットルームを作成して配信を開始し、リスナーがボイスチャットルームに参加して視聴/インタラクティブなコミュニケーションを行います。
    • 管理者は、リスナーを招待してマイク・オンにしたり、マイク・オンのキャスターをキックアウトしたりすることもできます。
    • 管理者はまた、座席をクローズすることができ、その他のリスナーはマイク・オンを申請することができなくなります。
    • リスナーはマイク・オンを申請して、マイク・オンのキャスターになり、他者と音声インタラクションを行うことができます。また、いつでもマイク・オフにして、通常のリスナーになることも可能です。
    • 各種のテキストメッセージやカスタムメッセージの送信をサポートします。カスタムメッセージは弾幕、「いいね」、ギフトなどを実装するために使用することができます。

    TRTCVoiceRoomは、オープンソースのClassであり、Tencent Cloudの2つのクローズソースであるSDKに依存しています。具体的な実装プロセスは ボイスチャットルーム(Android)をご参照ください。

    • TRTC SDK:TRTC SDKを低遅延のボイスチャットコンポーネントとして使用します。
    • IM SDK:IM SDKのAVChatroomを使用してチャットルーム機能を実装します。同時にIMの属性インターフェースによって、マイクリストなどのルーム情報を保存し、招待シグナリングはマイク・オン/ピックのリクエストに用いることができます。

    TRTCVoiceRoom API 概要

    SDK基本関数

    API 説明
    sharedInstance シングルトンオブジェクトを取得します。
    destroySharedInstance シングルトンオブジェクトを廃棄します。
    setDelegate イベントコールバックを設定します。
    setDelegateHandler イベントのコールバックが配置されているスレッドを設定します。
    login ログイン。
    logout ログアウト。
    setSelfProfile 個人情報を修正します。

    ルーム関連インターフェース関数

    API 説明
    createRoom ルームの作成(管理者が呼び出し)。ルームが存在しない場合は、システムが新しいルームを自動的に作成します。
    destroyRoom ルームの破棄(管理者が呼び出し)。
    enterRoom 入室(リスナーが呼び出し)。
    exitRoom 退室(リスナーが呼び出し)。
    getRoomInfoList ルームリストの詳細情報を取得します。
    getUserInfoList 指定されたuserIdのユーザー情報を取得します。 nullの場合は、ルーム内全員の情報を取得します。

    マイク管理インターフェース

    API 説明
    enterSeat ユーザーが発言者になる(リスナー側/管理者ともに呼び出し可)。
    leaveSeat ユーザーが視聴者になる(キャスターが呼び出し)。
    pickSeat 視聴者が発言できるように招待(管理者が呼び出し)。
    kickSeat キックアウトしてマイク・オフ(管理者が呼び出し)。
    muteSeat 任意のマイクのミュート/ミュート解除(管理者が呼び出し)。
    closeSeat 任意のマイクのクローズ/解除(管理者が呼び出し)。

    ローカルのオーディオ操作インターフェース

    API 説明
    startMicrophone マイクの集音開始。
    stopMicrophone マイクの集音停止。
    setAudioQuality 音質の設定。
    muteLocalAudio ローカルオーディオミュートの開始/停止。
    setSpeaker スピーカーの起動設定。
    setAudioCaptureVolume マイクの集音音量設定。
    setAudioPlayoutVolume 再生音量の設定。
    setVoiceEarMonitorEnable インイヤーモニタリングのオン/オフ。

    リモートユーザーオーディオ操作インターフェース

    API 説明
    muteRemoteAudio 指定メンバーをミュート/ミュート解除。
    muteAllRemoteAudio 全メンバーをミュート/ミュート解除。

    BGMサウンドエフェクト関連インターフェース

    API 説明
    getAudioEffectManager BGMサウンドエフェクト管理オブジェクトTXAudioEffectManagerの取得。

    メッセージ送信関連インターフェース

    API 説明
    sendRoomTextMsg ルーム内でのテキストメッセージのブロードキャスト。通常、弾幕によるチャットに使用します。
    sendRoomCustomMsg カスタマイズしたテキストメッセージを送信します。

    招待シグナリング関連インターフェース

    API 説明
    sendInvitation ユーザーに招待を送信。
    acceptInvitation 招待の同意。
    rejectInvitation 招待の辞退。
    cancelInvitation 招待の取り消し。

    TRTCVoiceRoomDelegate API概要

    一般的なイベントコールバック

    API 説明
    onError エラーのコールバック。
    onWarning 警告のコールバック。
    onDebugLog Logコールバック。

    ルームイベントのコールバック

    API 説明
    onRoomDestroy ルームが廃棄された時のコールバック。
    onRoomInfoChange ボイスチャットルーム情報変更のコールバック。
    onUserVolumeUpdate ユーザー通話音量のコールバック。

    マイク変更コールバック

    API 説明
    onSeatListChange 全量のマイクリストの変更。
    onAnchorEnterSeat 発言者のメンバーがいます(ユーザーが発言者になる/管理者が視聴者を発言できるように招待)。
    onAnchorLeaveSeat 視聴者のメンバーがいます(ユーザーが視聴者になる/管理者がキックアウトしてマイク・オフ)。
    onSeatMute 管理者のマイクミュート。
    onUserMicrophoneMute ユーザーのマイクがミュートされているかどうか。
    onSeatClose 管理者のマイククローズ。

    リスナーの入退室イベントのコールバック

    API 説明
    onAudienceEnter リスナー入室通知の受信。
    onAudienceExit リスナー退室通知の受信。

    メッセージイベントのコールバック

    API 説明
    onRecvRoomTextMsg テキストメッセージの受信。
    onRecvRoomCustomMsg カスタムメッセージの受信。

    シグナリングイベントのコールバック

    API 説明
    onReceiveNewInvitation 新規招待リクエストの受信。
    onInviteeAccepted 被招待者が招待に同意。
    onInviteeRejected 被招待者が招待を拒否。
    onInvitationCancelled 招待者が招待を取り消し。

    SDK基本関数

    sharedInstance

    TRTCVoiceRoom シングルトンオブジェクトを取得します。

    public static synchronized TRTCVoiceRoom sharedInstance(Context context);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    context Context Androidコンテキスト。内部ではApplicationContextに変換してシステムAPIの呼び出しに使用します

    destroySharedInstance

    TRTCVoiceRoom シングルトンオブジェクトを破棄します。

    説明:

    インスタンスの破棄後は、外部にキャッシュされた TRTCVoiceRoomインスタンスの再使用ができません。改めて sharedInstance を呼び出し、インスタンスを新規取得する必要があります。

    public static void destroySharedInstance();
    

    setDelegate

    TRTCVoiceRoom イベントコールバック、 TRTCVoiceRoomDelegate を介して TRTCVoiceRoom の各種ステータス通知を受け取ることができます。

    public abstract void setDelegate(TRTCVoiceRoomDelegate delegate);
    
    説明:

    setDelegate は、 TRTCVoiceRoom のプロキシコールバックです。

    setDelegateHandler

    イベントコールバックが配置されているスレッドを設定します。

    public abstract void setDelegateHandler(Handler handler);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    handler Handler TRTCChatSalonの各種ステータス通知は、指定したhandlerスレッドに発信されます。

    login

    ログイン。

    public abstract void login(int sdkAppId,
    String userId, String userSig,
    TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    sdkAppId int TRTCコンソール> 【[アプリケーション管理](https://console.cloud.tencent.com/trtc/app)】>アプリケーション情報の中でSDKAppIDを確認できます。
    userId String 現在のユーザーID、文字列タイプでは、英語のアルファベット(a-zとA-Z)、数字(0-9)、ハイフン(-)とアンダーライン(_)のみ使用できます。
    userSig String Tencent Cloudによって設計されたセキュリティ保護署名。取得方法についてはUserSigの計算方法をご参照ください。
    callback ActionCallback ログインのコールバック。成功時にcodeは0になります。

    logout

    ログアウト。

    public abstract void logout(TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    callback ActionCallback ログアウトのコールバック。成功時にcodeは0になります。

    setSelfProfile

    個人情報の修正。

    public abstract void setSelfProfile(String userName, String avatarURL, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userName String ニックネーム。
    avatarURL String プロフィール画像のアドレス。
    callback ActionCallback 個人情報設定のコールバック。成功時にcodeは0になります。

    ルーム関連インターフェース関数

    createRoom

    ルームの作成(管理者が呼び出し)。

    public abstract void createRoom(int roomId, TRTCVoiceRoomDef.RoomParam roomParam, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    roomId int ルームIDは、ご自身でアサインし、一元管理する必要があります。複数のroomIDを、1つのボイスチャットルームリストにまとめることができます。Tencent Cloudでは現在、ボイスチャットルームリストの管理サービスを行っていませんので、ご自身でボイスチャットルームリストを管理してください。
    roomParam TRTCCreateRoomParam ルーム情報は、ルーム名、マイク情報、カバー情報など、ルームを説明するために用いる情報に使用します。マイク管理が必要な場合は、ルームのマイク数を記入する必要があります。
    callback ActionCallback ルームの新規作成結果のコールバック。成功時にcodeは0になります。

    管理者が配信を開始する際の通常の呼び出しプロセスは次のとおりです。

    1. 管理者は、createRoomを呼び出して新しいボイスチャットルームを作成します。この時にルームID、マイク・オンに管理者の確認の要否、マイク数などルームのプロパティ情報を渡します。
    2. 管理者は、ルーム作成に成功した後、enterSeatを呼び出して参加します。
    3. 管理者は、コンポーネントのonSeatListChangeマイクリスト変更イベント通知を受信します。この時、マイクリストの変更をUI上に更新することができます。
    4. 管理者は、マイクリストのメンバーが参加したonAnchorEnterSeatというイベント通知も受信します。この時、マイク集音は自動的に開始されます。

    destroyRoom

    ルームの破棄(管理者が呼び出し)。管理者は、ルーム作成後、この関数を呼び出してルームを破棄します。

    public abstract void destroyRoom(TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    callback ActionCallback ルームの廃棄結果のコールバック。成功時にcodeは0になります。

    enterRoom

    入室(リスナーが呼び出し)。

    public abstract void enterRoom(int roomId, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    roomId int ルームID。
    callback ActionCallback 入室結果のコールバック。成功時にcodeは0になります。

    リスナーが入室し聴取する際の通常の呼び出しプロセスは次のとおりです。

    1. リスナーがサーバーから取得する最新のボイスチャットルームリストには、多くのボイスチャットルームのroomIdおよびルーム情報が含まれる場合があります。
      2.リスナーは1つのボイスチャットルームを選択し、enterRoomを呼び出してルームナンバーを渡すと、そのルームに参加できます。
    2. 入室後、コンポーネントのonRoomInfoChangeルーム属性変更イベント通知を受信します。この時、ルーム属性を記録し、それに応じた修正を行うことができます。例:UIに表示するルーム名、マイク・オンの際の管理者への同意リクエストの要否の記録など。
    3. 入室後は、コンポーネントのonSeatListChangeマイクリストの変更イベント通知を受信します。この時、マイクリストの変更をUI上に更新することができます。
    4. 入室後、マイクリストにキャスターが参加した onAnchorEnterSeat のイベント通知も受信します。

    exitRoom

    ルームから退出します。

    public abstract void exitRoom(TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    callback ActionCallback 退室結果のコールバック。成功時にcodeは0になります。

    getRoomInfoList

    ルームリストの詳細情報を取得します。このうち、ルーム名、ルームカバーは、管理者がcreateRoom()作成時にroomInfoによって設定したものになります。

    説明:

    ルームリストおよびルーム情報をご自身で管理する場合は、この関数は無視してもかまいません。

    public abstract void getRoomInfoList(List<Integer> roomIdList, TRTCVoiceRoomCallback.RoomInfoCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    roomIdList List&dxlt;Integer&dxgt; ルームナンバーリスト。
    callback RoomInfoCallback ルーム詳細情報のコールバック。

    getUserInfoList

    指定されたuserIdのユーザー情報を取得します。

    public abstract void getUserInfoList(List<String> userIdList, TRTCVoiceRoomCallback.UserListCallback userlistcallback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userIdList List&dxlt;String&dxgt; 取得すべきユーザーIDリスト。nullの場合は、ルーム内全員の情報を取得します。
    userlistcallback UserListCallback ユーザーの詳細情報のコールバック。

    マイク管理インターフェース

    enterSeat

    ユーザーが発言者になります(リスナー側/管理者ともに呼び出し可)。

    説明:

    マイク・オンの成功後、ルーム内の全メンバーは、onSeatListChangeおよびonAnchorEnterSeatというイベント通知を受信します。

    public abstract void enterSeat(int seatIndex, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    seatIndex int マイク・オンの必要があるマイク番号。
    callback ActionCallback 操作コールバック。

    このインターフェースを呼び出すと、直ちにマイクリストが変更されます。リスナーによるマイク・オンの申請に管理者の同意が必要となるケースの場合は、まずsendInvitationを呼び出してから管理者に申請し、onInvitationAcceptを受信するとこの関数を呼び出せるようになります。

    leaveSeat

    ユーザーが視聴者になる(キャスターが呼び出し)。

    説明:

    マイク・オフの成功後、ルーム内の全メンバーは、onSeatListChangeおよびonAnchorLeaveSeatというイベント通知を受信します。

    public abstract void leaveSeat(TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    callback ActionCallback 操作コールバック。

    pickSeat

    視聴者が発言できるように招待(管理者が呼び出し)。

    説明:

    、管理者が視聴者を発言できるように招待すると、ルーム内の全メンバーは、onSeatListChangeonAnchorEnterSeatというイベント通知を受信します。

    public abstract void pickSeat(int seatIndex, String userId, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    seatIndex int 視聴者が発言できるように招待する必要があるマイク番号。
    userId String ユーザーID。
    callback ActionCallback 操作コールバック。

    このインターフェースを呼び出すと、すぐにマイクリストが修正されます。管理者がリスナーの同意がなければマイク・オンできないケースの場合は、まずsendInvitationを呼び出してからリスナーに申請し、onInvitationAcceptを受信すると、この関数をコールできるようになります。

    kickSeat

    キックアウトしてマイク・オフ(管理者が呼び出し)。

    説明:

    管理者がキックアウトしてマイク・オフにすると、ルーム内の全メンバーは、onSeatListChangeおよびonAnchorLeaveSeatというイベント通知を受信します。

    public abstract void kickSeat(int seatIndex, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    seatIndex int キックアウトしてマイク・オフの必要があるマイク番号。
    callback ActionCallback 操作コールバック。

    このインターフェースを呼び出すと、すぐにマイクリストが修正されます。

    muteSeat

    任意のマイクのミュート/ミュート解除(管理者が呼び出し)。

    説明:

    任意のマイクのミュート/ミュート解除では、ルーム内の全メンバーが onSeatListChange および onSeatMute というイベント通知を受信します。

    public abstract void muteSeat(int seatIndex, boolean isMute, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    seatIndex int 操作の必要があるマイク番号。
    isMute boolean true:該当するマイクのミュート;false:該当するマイクのミュート解除。
    callback ActionCallback 操作コールバック。

    このインターフェースを呼び出すと、直ちにマイクリストが変更されます。seatIndexの座席に該当するキャスターは、muteAudioを自動的に呼び出してミュート/ミュートオフにします。

    closeSeat

    任意のマイクのクローズ/解除(管理者が呼び出し)。

    説明:

    管理者は、該当するマイクをクローズ/解除し、ルーム内の全メンバーはonSeatListChangeおよびonSeatCloseというイベント通知を受信します。

    public abstract void closeSeat(int seatIndex, boolean isClose, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    seatIndex int 操作の必要があるマイク番号。
    isClose boolean true:該当するマイクのクローズ; false:該当するマイクのクローズ解除。
    callback ActionCallback 操作コールバック。

    このインターフェースを呼び出すと、すぐにマイクリストが修正されます。該当するseatIndexの座席上のキャスターはクローズされ、自動的にマイク・オフになります。

    ローカルのオーディオ操作インターフェース

    startMicrophone

    マイクの集音開始。

    public abstract void startMicrophone();
    

    stopMicrophone

    マイクの集音停止。

    public abstract void stopMicrophone();
    

    setAudioQuality

    音質の設定。

    public abstract void setAudioQuality(int quality);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    quality int オーディオ品質。詳細については、TRTC SDKをご参照ください。

    muteLocalAudio

    ローカルのオーディオのミュート/ミュート取り消し。

    public abstract void muteLocalAudio(boolean mute);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    mute boolean ミュート/ミュート取り消し。詳細は TRTC SDKをご参照ください。

    setSpeaker

    スピーカーの起動設定。

    public abstract void setSpeaker(boolean useSpeaker);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    useSpeaker boolean true:スピーカー;false:ヘッドホン。

    setAudioCaptureVolume

    マイクの集音音量設定。

    public abstract void setAudioCaptureVolume(int volume);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    volume int 集音音量、0 - 100、 デフォルト100。

    setAudioPlayoutVolume

    再生音量の設定。

    public abstract void setAudioPlayoutVolume(int volume);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    volume int 再生音量、0 - 100、 デフォルト100。

    muteRemoteAudio

    指定メンバーのミュート/ミュート解除。

    public abstract void muteRemoteAudio(String userId, boolean mute);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userId String 指定ユーザーID。
    mute boolean true:ミュート起動;false:ミュート停止。

    muteAllRemoteAudio

    全メンバーのミュート/ミュート解除。

    public abstract void muteAllRemoteAudio(boolean mute);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    mute boolean true:ミュート起動;false:ミュート停止。

    setVoiceEarMonitorEnable

    インイヤーモニタリングのオン/オフ。

    public abstract void setVoiceEarMonitorEnable(boolean enable);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    enable boolean true:インイヤーモニタリングをオン。false:インイヤーモニタリングをオフ。

    BGMサウンドエフェクト関連インターフェース関数

    getAudioEffectManager

    BGMサウンドエフェクト管理オブジェクト TXAudioEffectManagerの取得。

    public abstract TXAudioEffectManager getAudioEffectManager();
    

    メッセージ送信関連インターフェース関数

    sendRoomTextMsg

    ルーム内でテキストメッセージをブロードキャストします。通常、弾幕によるチャットに使用します。

    public abstract void sendRoomTextMsg(String message, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    message String テキストメッセージ。
    callback ActionCallback 送信結果のコールバック。

    sendRoomCustomMsg

    カスタマイズしたテキストメッセージを送信します。

    public abstract void sendRoomCustomMsg(String cmd, String message, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    cmd String コマンドワードは、開発者がカスタマイズします。主にさまざまなメッセージタイプを区別するために使用されます。
    message String テキストメッセージ。
    callback ActionCallback 送信結果のコールバック。

    招待シグナリング関連インターフェース

    sendInvitation

    ユーザーに招待を送信。

    public abstract String sendInvitation(String cmd, String userId, String content, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    cmd String 業務カスタマイズコマンド。
    userId String 招待ユーザーID。
    content String 招待コンテンツ。
    callback ActionCallback 送信結果のコールバック。

    戻り値:

    戻り値 タイプ 意味
    inviteId String 今回の招待IDの識別に使用。

    acceptInvitation

    招待の同意。

    public abstract void acceptInvitation(String id, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    callback ActionCallback 送信結果のコールバック。

    rejectInvitation

    招待の拒否。

    public abstract void rejectInvitation(String id, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    callback ActionCallback 送信結果のコールバック。

    cancelInvitation

    招待の取り消し。

    public abstract void cancelInvitation(String id, TRTCVoiceRoomCallback.ActionCallback callback);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    callback ActionCallback 送信結果のコールバック。

    TRTCVoiceRoomDelegateイベントのコールバック

    一般的なイベントコールバック

    onError

    エラーのコールバック。

    説明:

    SDKリカバリー不能なエラーは必ず監視し、状況に応じてユーザーに適切なインターフェースプロンプトを表示します。

    void onError(int code, String message);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    code int エラーコード。
    message String エラー情報。

    onWarning

    警告のコールバック。

    void onWarning(int code, String message);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    code int エラーコード。
    message String 警告メッセージ。

    onDebugLog

    Logコールバック。

    void onDebugLog(String message);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    message String ログ情報。

    ルームイベントのコールバック

    onRoomDestroy

    ルーム破棄のコールバック。管理者がルームを解散するとき、ルーム内の全ユーザーはこの通知を受信します。

    void onRoomDestroy(String roomId);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    roomId String ルームID。

    onRoomInfoChange

    入室に成功後、このインターフェースをコールバックします。roomInfoの情報は、管理者がルームを作成するときに渡されます。

    void onRoomInfoChange(TRTCVoiceRoomDef.RoomInfo roomInfo);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    roomInfo RoomInfo ルーム情報。

    onUserMicrophoneMute

    ユーザーのマイクがミュートになっているかどうかについて、ユーザーがmuteLocalAudioを呼び出すと、ルームの他のユーザーがこの通知を受信します。

    void onUserMicrophoneMute(String userId, boolean mute);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userId String ユーザーID。
    mute boolean 音量の大きさ。値:0~100。

    onUserVolumeUpdate

    音量レベルリマインダを有効にして、各メンバーの音量を通知します。

    void onUserVolumeUpdate(List<TRTCCloudDef.TRTCVolumeInfo> userVolumes, int totalVolume);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userVolumes ListList<trtcclouddef.trtcvolumeinfo> ユーザーリスト。
    totalVolume int 音量の大きさ。値:0~100。

    マイクコールバック

    onSeatListChange

    全量のマイクリストの変更は、全てのマイクリストを含みます。

    void onSeatListChange(List<SeatInfo> seatInfoList);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    seatInfoList List&dxlt;SeatInfo&dxgt; 全量のマイクリスト。

    onAnchorEnterSeat

    発言者のメンバーがいます(ユーザーが発言者になる/管理者が視聴者を発言できるように招待)。

    void onAnchorEnterSeat(int index, TRTCVoiceRoomDef.UserInfo user);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    index int メンバーがマイク・オンのマイク。
    user UserInfo マイク・オンのユーザーの詳細情報。

    onAnchorLeaveSeat

    視聴者のメンバーがいます(ユーザーが視聴者になる/管理者がキックアウトしてマイク・オフ)。

    void onAnchorLeaveSeat(int index, TRTCVoiceRoomDef.UserInfo user);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    index int マイク・オフのマイク。
    user UserInfo マイク・オンのユーザーの詳細情報。

    onSeatMute

    管理者のマイクミュート。

    void onSeatMute(int index, boolean isMute);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    index int 操作するマイク。
    isMute boolean true:マイクミュート; false:ミュート解除。

    onSeatClose

    管理者のマイククローズ。

    void onSeatClose(int index, boolean isClose);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    index int 操作するマイク。
    isClose boolean true:マイクのクローズ; false:マイクのクローズ解除。

    リスナーの入退室イベントのコールバック

    onAudienceEnter

    リスナー入室通知の受信。

    void onAudienceEnter(TRTCVoiceRoomDef.UserInfo userInfo);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userInfo UserInfo 入室したリスナーの情報。

    onAudienceExit

    リスナー退室通知の受信。

    void onAudienceExit(TRTCVoiceRoomDef.UserInfo userInfo);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    userInfo UserInfo 退室したリスナーの情報。

    メッセージイベントのコールバック

    onRecvRoomTextMsg

    テキストメッセージの受信。

    void onRecvRoomTextMsg(String message, TRTCVoiceRoomDef.UserInfo userInfo);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    message String テキストメッセージ。
    userInfo UserInfo 送信者のユーザー情報。

    onRecvRoomCustomMsg

    カスタムメッセージの受信。

    void onRecvRoomCustomMsg(String cmd, String message, TRTCVoiceRoomDef.UserInfo userInfo);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    cmd String コマンドワードは、開発者がカスタマイズします。主にさまざまなメッセージタイプを区別するために使用されます。
    message String テキストメッセージ。
    userInfo UserInfo 送信者のユーザー情報。

    招待シグナリングイベントのコールバック

    onReceiveNewInvitation

    新規招待リクエストの受信。

    void onReceiveNewInvitation(String id, String inviter, String cmd, String content);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    inviter String 招待者のユーザーID。
    cmd String 業務指定のコマンドワードは、開発者がカスタマイズします。
    content String 業務指定のコンテンツ。

    onInviteeAccepted

    被招待者が招待に同意。

    void onInviteeAccepted(String id, String invitee);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    inviter String 被招待者のユーザーID。

    onInviteeRejected

    被招待者が招待を拒否。

    void onInviteeRejected(String id, String invitee);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    inviter String 被招待者のユーザーID。

    onInvitationCancelled

    招待者が招待を取り消し。

    void onInvitationCancelled(String id, String inviter);
    

    パラメータは下表に示すとおりです。

    パラメータ タイプ 意味
    id String 招待ID。
    inviter String 招待者のユーザーID。
    </trtcclouddef.trtcvolumeinfo>