tencent cloud

フィードバック

TUIRoom(Android)

最終更新日:2022-03-01 12:29:09
    1. TUIRoomは、Tencent CloudのTencent Real-Time Communication(TRTC)およびIMサービスを基に組み合わせたコンポーネントで、以下の機能をサポートしています。
    • キャスターがルームを作成し、入室者はルームナンバーを入力した後に入室できます。
    • 入室者の間で画面共有を行います。
    • 各種のテキストメッセージとカスタムメッセージの送信をサポートします。
    1. TUIRoomはオープンソースのClassであり、Tencent Cloudの2つのクローズドソースのSDKに依存しています。具体的な実装プロセスについては、 多人数オーディオビデオルーム(Android)をご参照ください。
    • TRTC SDK:TRTC SDKを低遅延のオーディオビデオルームコンポーネントとして使用します。
    • IM SDK:IM SDK を利用してチャットルームの機能(IM SDKはAndroidバージョンを使用)を実装します。

    TUIRoom API概要

    TUIRoomCore基本関数

    API 説明
    getInstance シングルトンオブジェクトを取得します。
    destroyInstance シングルトンオブジェクトを破棄します。
    setListener イベントコールバックを設定します。

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

    API 説明
    createRoom ルームの作成(キャスターが呼び出し)。
    destroyRoom ルームの破棄(キャスターが呼び出し)。
    enterRoom 入室(入室メンバーが呼び出し)。
    leaveRoom 退室(その他のルームメンバーが呼び出し)。
    getRoomInfo ルーム情報の取得。
    getRoomUsers ルーム内全メンバー情報の取得。
    getUserInfo 特定ユーザーの情報の取得。
    transferRoomMaster キャスター権限の移転(キャスターが呼び出し)。

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

    API 説明
    startCameraPreview ローカルビデオのプレビュー画面を立ち上げます。
    stopCameraPreview ローカルのビデオキャプチャおよびプレビューを停止します。
    startLocalAudio マイクキャプチャを起動します。
    stopLocalAudio マイクキャプチャを停止します。
    setVideoMirror ローカル画面のミラーモードのプレビューを設定します。
    setSpeaker スピーカーの起動を設定します。

    リモートユーザーに関するインターフェース

    API 説明
    startRemoteView 指定メンバーのリモートビデオ画面をサブスクリプションし再生します。
    stopRemoteView リモートビデオ画面のサブスクリプションをキャンセルし再生を停止します。

    チャットメッセージ送信インターフェース

    API 説明
    sendChatMessage チャットメッセージを送信します。
    sendCustomMessage カスタムメッセージを送信します。

    フィールドコントロール関連インターフェース

    API 説明
    muteUserMicrophone 特定ユーザーのマイクを無効化/再有効化します。
    muteAllUsersMicrophone 全ユーザーのマイクを無効化/再有効化し、ステータスをルーム情報に同期させます。
    muteUserCamera 特定ユーザーのカメラを無効化/再有効化します。
    muteAllUsersCamera 全ユーザーのカメラを無効化/再有効化し、ステータスをルーム情報に同期させます。
    muteChatRoom チャットルームのミュートを開始/停止します(キャスターが呼び出し)。
    kickOffUser ルーム内の特定ユーザーをリムーブします(キャスターが呼び出し)。
    startCallingRoll キャスターが点呼を開始します。
    stopCallingRoll キャスターが点呼を終了します。
    replyCallingRoll メンバーがキャスターの点呼に応答します。
    sendSpeechInvitation キャスターがメンバーに発言するようインビテーションを送信します。
    cancelSpeechInvitation キャスターがメンバーの発言のためのインビテーションをキャンセルします。
    replySpeechInvitation メンバーがキャスターの発言申請に同意/拒否します。
    sendSpeechApplication メンバーが発言を要請します。
    replySpeechApplication キャスターがメンバーの発言申請に同意/拒否します。
    forbidSpeechApplication キャスターが発言申請を禁止します。
    sendOffSpeaker キャスターがメンバーに発言を停止するよう命令します。
    sendOffAllSpeakers キャスターが全員に発言を停止するよう命令します。
    exitSpeechState メンバーは発言を停止し、視聴者になります。

    画面共有インターフェース

    API 説明
    startScreenCapture 画面共有を開始。
    stopScreenCapture 画面キャプチャの停止。

    美顔フィルタに関するインターフェース関数

    API 説明
    getBeautyManager 美顔管理オブジェクトTXBeautyManager。を取得します。

    関連設定インターフェース

    API 説明
    setVideoQosPreference ネットワークトラフィックコントロール関連パラメータを設定します。

    SDKバージョンインターフェース関数の取得

    API 説明
    getSDKVersion SDKバージョンを取得します。

    TUIRoomCoreListener API概要

    エラーイベントコールバック

    API 説明
    onError エラーのコールバック。

    基本イベントコールバック

    API 説明
    onDestroyRoom ルーム解散のコールバック。
    onUserVoiceVolume 音量の大きさのコールバック。
    onRoomMasterChanged キャスター変更のコールバック。

    リモートユーザーイベントコールバック

    API 説明
    onRemoteUserEnter リモートユーザー入室コールバック。
    onRemoteUserLeave リモートユーザー退室コールバック。
    onRemoteUserCameraAvailable リモートユーザーがカメラビデオを起動するかどうかのコールバック。
    onRemoteUserScreenVideoAvailable リモートユーザーが画面共有を開始するかどうかのコールバック。
    onRemoteUserAudioAvailable リモートユーザーがオーディオのアップストリームを開始するかどうかのコールバック。
    onRemoteUserEnterSpeechState リモートユーザーの発言開始のコールバック。
    onRemoteUserExitSpeechState リモートユーザーの発言終了のコールバック。

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

    API 説明
    onReceiveChatMessage テキストメッセージ受信のコールバック。
    onReceiveRoomCustomMsg カスタムメッセージ受信のコールバック。

    フィールドコントロールイベントコールバック

    API 説明
    onReceiveSpeechInvitation ユーザーがキャスターの発言要請を受信した場合のコールバック。
    onReceiveInvitationCancelled ユーザーがキャスターの発言要請キャンセルを受信する場合のコールバック。
    onReceiveSpeechApplication キャスターがユーザーの発言要請を受信する場合のコールバック。
    onSpeechApplicationCancelled ユーザーが発言申請をキャンセルする場合のコールバック。
    onSpeechApplicationForbidden キャスターが発言申請を禁止する場合のコールバック。
    onOrderedToExitSpeechState メンバーが発言の停止をリクエストされる場合のコールバック。
    onCallingRollStarted キャスターが点呼を開始し、メンバーが受信する場合のコールバック。
    onCallingRollStopped キャスターが点呼を終了し、メンバーが受信する場合のコールバック。
    onMemberReplyCallingRoll メンバーが点呼に応答し、キャスターが受信する場合のコールバック。
    onChatRoomMuted キャスターがチャットルームのミュートを変更する場合のコールバック。
    onMicrophoneMuted キャスターがマイクの無効化を設定する場合のコールバック。
    onCameraMuted キャスターがカメラの無効化を設定する場合のコールバック。
    onReceiveKickedOff メンバーがキャスターからキックアウトされた場合のコールバック。

    統計および品質コールバック

    API 説明
    onStatistics 技術指標統計のコールバック。
    onNetworkQuality ネットワーク品質のコールバック。

    画面共有関連コールバック

    API 説明
    onScreenCaptureStarted 画面共有開始のコールバック。
    onScreenCaptureStopped 画面共有停止のコールバック。

    TUIRoomCore基本関数

    getInstance

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

    public static TUIRoomCore getInstance(Context context);
    

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

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

    destroyInstance

    void destroyInstance();
    

    setListener

    TUIRoomCore イベントコールバック。TUIRoomCoreListener を介してTUIRoomCoreの各種ステータス通知を取得できます。

    void setListener(TUIRoomCoreListener listener);
    

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

    パラメータ タイプ 意味
    listener TUIRoomCoreListener イベントコールバッククラスを受信します。

    createRoom

    ルームの作成(キャスターが呼び出し)。

    void createRoom(String roomId, TUIRoomCoreDef.SpeechMode speechMode, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    roomId String ルームID。ご自身でアサインし、一元管理する必要があります。
    speechMode TUIRoomCoreDef.SpeechMode 発言モード。
    callback TUIRoomCoreCallback.ActionCallback ルームの作成結果のコールバック。

    キャスターの通常の呼び出しフローは以下のとおりです。

    1. キャスターcreateRoom()を呼び出し、ルームを作成します。ルーム作成の成否はTUIRoomCoreCallback.ActionCallbackでキャスターに通知されます。
    2. キャスターstartCameraPreview()を呼び出し 、カメラキャプチャとプレビューを起動します。
    3. キャスターstartLocalAudio()を呼び出し、ローカルマイクを起動します。

    destroyRoom

    ルームの破棄(キャスターが呼び出し)。キャスターは、ルームの作成後、この関数を呼び出して、ルームを破棄できます。

    void destroyRoom(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback UIRoomCoreCallback.ActionCallback ルームの破棄結果のコールバック。

    enterRoom

    入室(ルーム参加メンバーが呼び出し)。

    void enterRoom(String roomId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    roomId String ルームID。
    callback UIRoomCoreCallback.ActionCallback 結果のコールバック。

    ルーム参加メンバーが入室する場合の通常の呼び出し手順は次のとおりです。

    1. 入室メンバーenterRoomを呼び出し、roomIdを渡せば入室できます。
    2. 入室メンバーstartCameraPreview()を呼び出してカメラプレビューを起動し、startLocalAudio()を呼び出して、マイクキャプチャを起動します。
    3. 入室メンバーonRemoteUserCameraAvailableのイベントを受信し、startRemoteView()を呼び出して、ビデオ再生を開始します。

    leaveRoom

    退室(入室メンバーが呼び出し)。

    void leaveRoom(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback UIRoomCoreCallback.ActionCallback 結果のコールバック。

    getRoomInfo

    ルーム情報を取得します。

    TUIRoomCoreDef.RoomInfo getRoomInfo();
    

    getRoomUsers

    ルームの全メンバー情報を取得します。

    List getRoomUsers();
    

    getUserInfo

    ルームのメンバー情報を取得します。

    void getUserInfo(String userId, TUIRoomCoreCallback.UserInfoCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    callback UIRoomCoreCallback.UserInfoCallback ルームメンバーの詳細情報のコールバック。

    setSelfProfile

    ユーザー情報を設定します。

    void setSelfProfile(String userName, String avatarURL, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userName String ユーザーの氏名。
    avatarURL String ユーザーのプロフィール画像URL。
    callback TUIRoomCoreCallback.ActionCallback 設定が成功したかどうかの結果のコールバック。

    transferRoomMaster

    グループを他のユーザーに引き渡します。

    void transferRoomMaster(String userId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    ローカルプッシュインターフェース

    startCameraPreview

    ローカルカメラプレビューを起動します。

    void startCameraPreview(boolean isFront, TXCloudVideoView view);
    

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

    パラメータ タイプ 意味
    isFront boolean true:フロントカメラ、false:リアカメラ。
    view TXCloudVideoView ビデオ画像をロードするウィジェット。

    stopCameraPreview

    ローカルカメラプレビューを停止します。

    void stopCameraPreview();
    

    startLocalAudio

    マイクの集音開始。

    void startLocalAudio(int quality);
    

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

    パラメータ タイプ 意味
    quality int キャプチャの音質:
  • TRTC_AUDIO_QUALITY_MUSIC
  • TRTC_AUDIO_QUALITY_DEFAULT
  • TRTC_AUDIO_QUALITY_SPEECH
  • stopLocalAudio

    マイクの集音停止。

    void stopLocalAudio();
    

    setVideoMirror

    ローカル画面のミラーモードのプレビューを設定します。

    void setVideoMirror(int type);
    

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

    パラメータ タイプ 意味
    type int イメージタイプ。

    setSpeaker

    スピーカーの起動設定。

    void setSpeaker(boolean isUseSpeaker);
    

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

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

    リモートユーザーに関するインターフェース

    startRemoteView

    リモートユーザーのビデオストリームのサブスクリプション。

    void startRemoteView(String userId, TXCloudVideoView view, TUIRoomCoreDef.SteamType streamType, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String 再生が必要なユーザーのID。
    view TXCloudVideoView ビデオ画像をロードするviewウィジェット。
    streamType TUIRoomCoreDef.SteamType ストリームのタイプ。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    stopRemoteView

    サブスクリプションをキャンセルし、リモートビデオ画面の再生を停止します。

    void stopRemoteView(String userId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String 再生停止が必要なユーザーのID。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    switchCamera

    フロント/リアカメラを切り替えます。

    void switchCamera(boolean isFront);
    

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

    パラメータ タイプ 意味
    isFront boolean true:フロントカメラ、false:リアカメラ。

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

    sendChatMessage

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

    void sendChatMessage(String message, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    message String メッセージの内容。
    callback TUIRoomCoreCallback.ActionCallback 送信結果のコールバック。

    sendCustomMessage

    カスタムメッセージを送信します。

    void sendCustomMessage(String data, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    data String メッセージの内容。
    callback TUIRoomCoreCallback.ActionCallback 送信結果のコールバック。

    フィールドコントロール関連インターフェース

    muteUserMicrophone

    特定ユーザーのマイクを無効化/再有効化します。

    void muteUserMicrophone(String userId, boolean mute, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    mute boolean 無効にするかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    muteAllUsersMicrophone

    全ユーザーのマイクを無効化/再有効化します。

    void muteAllUsersMicrophone(boolean mute, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    mute boolean 無効にするかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    muteUserCamera

    特定ユーザーのカメラを無効化/再有効化します。

    void muteUserCamera(String userId, boolean mute, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    mute boolean 無効にするかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    muteAllUsersCamera

    全ユーザーのカメラを無効化/再有効化します。

    void muteAllUsersCamera(boolean mute, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    mute boolean 無効にするかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    muteChatRoom

    テキストチャットのミュート/再有効化。

    void muteChatRoom(boolean mute, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    mute boolean 無効にするかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    kickOffUser

    キャスターがキックアウトします。

    void kickOffUser(String userId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    startCallingRoll

    キャスターが点呼を開始します。

    void startCallingRoll(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    stopCallingRoll

    キャスターが点呼を終了します。

    void stopCallingRoll(TUIRoomCoreCallback.ActionCallback callback);
    
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    replyCallingRoll

    メンバーがキャスターの点呼に応答します。

    void replyCallingRoll(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    sendSpeechInvitation

    キャスターがメンバーの発言を要請します。

    void sendSpeechInvitation(String userId, TUIRoomCoreCallback.InvitationCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    callback TUIRoomCoreCallback.InvitationCallback 結果のコールバック。

    cancelSpeechInvitation

    キャスターがメンバーへの発言要請をキャンセルします。

    void cancelSpeechInvitation(String userId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    replySpeechInvitation

    メンバーがキャスターの発言要請に同意/を拒否します。

    void replySpeechInvitation(boolean agree, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    agree boolean 同意するかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    sendSpeechApplication

    メンバーが発言を要請します。

    void sendSpeechApplication(TUIRoomCoreCallback.InvitationCallback callback);
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.InvitationCallback 結果のコールバック。

    cancelSpeechApplication

    メンバーが発言申請をキャンセルします。

    void cancelSpeechApplication(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    replySpeechApplication

    キャスターがメンバーの発言申請に同意/を拒否します。

    void replySpeechApplication(boolean agree, String userId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    agree boolean 同意するかどうか。
    userId String ユーザーID。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    forbidSpeechApplication

    キャスターが発言申請を禁止します。

    void forbidSpeechApplication(boolean forbid, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    forbid boolean 禁止するかどうか。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    sendOffSpeaker

    キャスターがメンバーに発言の停止を命令します。

    void sendOffSpeaker(String userId, TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    sendOffAllSpeakers

    キャスターが全メンバーに発言の停止を命令します。

    void sendOffAllSpeakers(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    exitSpeechState

    メンバーが発言を停止し、視聴者になります。

    void exitSpeechState(TUIRoomCoreCallback.ActionCallback callback);
    

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

    パラメータ タイプ 意味
    callback TUIRoomCoreCallback.ActionCallback 結果のコールバック。

    画面共有インターフェース

    startScreenCapture

    画面共有を開始。

    void startScreenCapture(TRTCCloudDef.TRTCVideoEncParam encParams, TRTCCloudDef.TRTCScreenShareParams screenShareParams);
    

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

    パラメータ タイプ 意味
    encParams TRTCCloudDef.TRTCVideoEncParam 画面共有時のエンコードパラメータを設定します。上記の推奨設定を採用することをお勧めします。encParamsにnullを指定した場合、startScreenCaptureを呼び出す前のエンコードパラメータ設定が使用されます。
    screenShareParams TRTCCloudDef.TRTCScreenShareParams 画面共有の特殊なレイアウト設定については、その中のfloatingViewの設定を推奨します。一方で、Appがシステムから強制排除されるのを回避でき、もう一方で、ユーザーのプライバシー保護にも役立ちます。
    説明:

    詳細については、TRTC SDKをご参照ください。 |

    stopScreenCapture

    画面キャプチャの停止。

    void stopScreenCapture();
    

    美顔フィルタに関するインターフェース関数

    getBeautyManager

    美顔管理オブジェクト TXBeautyManagerを取得します。

    TXBeautyManager getBeautyManager();
    

    美顔管理では、次の機能を使用できます。

    • 「美顔のスタイル」、「美白」、「肌色補正(血色・つや感)」、「デカ眼」、「顔痩せ」、「V顔」、「下あご」、「面長補正」、「小鼻」、「キラキラ目」、「白い歯」、「目の弛み除去」、「シワ除去」、「ほうれい線除去」などの美容効果を設定します。
    • 「髪の生え際」、「眼と眼の距離」、「眼角度」、「唇の形」、「鼻翼」、「鼻の位置」、「唇の厚さ」、「顔の形」を調整します。
    • 人の顔のスタンプ(素材)等のダイナミック効果を設定します。
    • メイクアップを追加します。
    • ジェスチャー認識を行います。

    関連設定インターフェース

    setVideoQosPreference

    ネットワークトラフィックコントロール関連パラメータを設定します。

    void setVideoQosPreference(TRTCCloudDef.TRTCNetworkQosParam preference);
    

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

    パラメータ タイプ 意味
    preference TRTCCloudDef.TRTCNetworkQosParam ネットワークトラフィックコントロールポリシー。

    setAudioQuality

    音質の設定。

    void setAudioQuality(int quality);
    

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

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

    setVideoResolution

    解像度の設定。

    void setVideoResolution(int resolution);
    

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

    パラメータ タイプ 意味
    resolution int ビデオの解像度。詳細については、TRTC SDKをご参照ください。

    setVideoFps

    フレームレートの設定。

    void setVideoFps(int fps);
    

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

    パラメータ タイプ 意味
    fps int ビデオキャプチャのフレームレート。
    説明:

    推奨する値:15fpsまたは20fps。5fps以下ではラグ感が目立ち、10fps以下では軽微なラグ感があります。20fps以上は高すぎて浪費になります(映画のフレームレートは24fps)。

    setVideoBitrate

    ビットレートの設定。

    void setVideoBitrate(int bitrate);
    

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

    パラメータ タイプ 意味
    bitrate int ビットレート。SDKは、目標ビットレートに応じてエンコードを行い、ネットワークの状態が良くない場合のみ、ビデオビットレートを動的に引き下げます。詳細については、TRTC SDKをご参照ください。
    説明:

    推奨する値:TRTCVideoResolutionの各クラスに注記する最適ビットレートをご参照ください。これをもとにより高いレートに適宜調整することも可能です。例えば、TRTC_VIDEO_RESOLUTION_1280_720に対応する目標ビットレートが1200kbpsであるならば、設定を1500kbpsにし、より鮮明な画像を得ることができます。

    enableAudioEvaluation

    音量レベルリマインダを有効にします。

    void enableAudioEvaluation(boolean enable);
    

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

    パラメータ タイプ 意味
    enable boolean true:オン、false:オフ。
    説明:

    有効化すると、onUserVolumeUpdateの中でSDKの音量のボリュームに対する評価を取得できます。

    setAudioPlayVolume

    再生音量の設定。

    void setAudioPlayVolume(int volume);
    

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

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

    setAudioCaptureVolume

    マイクの集音音量設定。

    void setAudioCaptureVolume(int volume);
    

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

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

    startFileDumping

    録音の開始。

    void startFileDumping(TRTCCloudDef.TRTCAudioRecordingParams trtcAudioRecordingParams);
    

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

    パラメータ タイプ 意味
    trtcAudioRecordingParams TRTCCloudDef.TRTCAudioRecordingParams 録音パラメータ。詳細については、TRTC SDKをご参照ください。
    説明:

    この方法で呼び出した後、 SDKは通話プロセスの中のすべての音声(ローカル音声、リモート音声、BGMなど)を1つのファイルにレコーディングします。ルームに参加しているか否かにかかわらず、このインターフェースを呼び出せば有効となります。leaveRoomを呼び出した時に録音中であれば、録音は自動的に停止します。

    stopFileDumping

    録音の停止。

    void stopFileDumping();
    

    SDKバージョンインターフェースの取得

    getSdkVersion

    SDKバージョン情報を取得します。

    int getSdkVersion();
    

    エラーイベントコールバック

    onError

    void onError(int code, String message);
    

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

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

    基本イベントコールバック

    onDestroyRoom

    ルーム解散のコールバック。

    void onDestroyRoom();
    

    onUserVoiceVolume

    ユーザー音量の大きさのコールバック。

    void onUserVoiceVolume(String userId, int volume);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    volume int ユーザーの音量の大きさ、値の範囲0~100。

    onRoomMasterChanged

    キャスター変更のコールバック。

    void onRoomMasterChanged(String previousUserId, String currentUserId);
    

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

    パラメータ タイプ 意味
    previousUserId String 変更前のキャスターユーザーID。
    currentUserId String 変更後のキャスターユーザーID。

    リモートユーザーコールバックイベント

    onRemoteUserEnter

    リモートユーザー入室コールバック。

    void onRemoteUserEnter(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    onRemoteUserLeave

    リモートユーザー退室コールバック。

    void onRemoteUserLeave(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    onRemoteUserCameraAvailable

    リモートユーザーが、カメラ、ビデオを起動しているかどうか。

    void onRemoteUserCameraAvailable(String userId, boolean available);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    available boolean true:ビデオストリームデータあり、false:ビデオストリームデータなし。

    onRemoteUserScreenVideoAvailable

    メンバーのビデオ共有オン/オフの通知。

    void onRemoteUserScreenVideoAvailable(String userId, boolean available);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    available boolean 画面共有ストリームデータの有無。

    onRemoteUserAudioAvailable

    リモートユーザーがオーディオアップストリームを開始したかどうかのコールバック。

    void onRemoteUserAudioAvailable(String userId, boolean available);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    available boolean オーディオデータの有無。

    onRemoteUserEnterSpeechState

    リモートユーザーが発言を開始します。

    void onRemoteUserEnterSpeechState(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    onRemoteUserExitSpeechState

    リモートユーザーが発言を終了します。

    void onRemoteUserExitSpeechState(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    チャットルームメッセージイベントコールバック

    onReceiveChatMessage

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

    void onReceiveChatMessage(String userId, String message);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    message String テキストメッセージ。

    onReceiveRoomCustomMsg

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

    void onReceiveRoomCustomMsg(String userId, String data);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。
    message String カスタムメッセージ。

    フィールドコントロールメッセージコールバック

    onReceiveSpeechInvitation

    ユーザーがキャスターの発言要請を受信する場合のコールバック。

    void onReceiveSpeechInvitation(String userId);
    

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

    パラメータ タイプ 意味
    userId String キャスターユーザーID。

    onReceiveInvitationCancelled

    ユーザーがキャスターの発言要請キャンセルを受信する場合のコールバック。

    void onReceiveInvitationCancelled(String userId);
    

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

    パラメータ タイプ 意味
    userId String キャスターユーザーID。

    onReceiveSpeechApplication

    キャスターがユーザーの発言要請を受信する場合のコールバック。

    void onReceiveSpeechApplication(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    onSpeechApplicationCancelled

    ユーザーが発言申請をキャンセルする場合のコールバック。

    void onSpeechApplicationCancelled(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    onSpeechApplicationForbidden

    キャスターが発言申請を禁止する場合のコールバック。

    void onSpeechApplicationForbidden(boolean isForbidden);
    

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

    パラメータ タイプ 意味
    isForbidden boolean 禁止するかどうか。

    onOrderedToExitSpeechState

    メンバーが発言を停止するようリクエストされる場合のコールバック。

    void onOrderedToExitSpeechState(String userId);
    

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

    パラメータ タイプ 意味
    userId String キャスターユーザーID。

    onCallingRollStarted

    キャスターが点呼を開始し、メンバーが受信する場合のコールバック。

    void onCallingRollStarted(String userId);
    

    onCallingRollStopped

    キャスターが点呼を終了し、メンバーが受信する場合のコールバック。

    void onCallingRollStopped(String userId);
    

    onMemberReplyCallingRoll

    メンバーが点呼に応答し、キャスターが受信する場合のコールバック。

    void onMemberReplyCallingRoll(String userId);
    

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

    パラメータ タイプ 意味
    userId String ユーザーID。

    onChatRoomMuted

    キャスターがチャットルームのミュートを変更する場合のコールバック。

    void onChatRoomMuted(boolean muted);
    

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

    パラメータ タイプ 意味
    muted boolean 無効にするかどうか。

    onMicrophoneMuted

    キャスターがマイクの無効化を設定する場合のコールバック。

    void onMicrophoneMuted(boolean muted);
    

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

    パラメータ タイプ 意味
    muted boolean 無効にするかどうか。

    onCameraMuted

    キャスターがカメラの無効化を設定する場合のコールバック。

    void onCameraMuted(boolean muted);
    

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

    パラメータ タイプ 意味
    muted boolean 無効にするかどうか。

    onReceiveKickedOff

    キャスターによるキックアウトのコールバック。

    void onReceiveKickedOff(String userId);
    

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

    パラメータ タイプ 意味
    userId String キャスター/管理者ユーザーID。

    統計および品質コールバック

    onStatistics

    技術指標統計のコールバック。

    void onStatistics(TRTCStatistics statistics);
    

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

    パラメータ タイプ 意味
    statis TRTCStatistics 統計データ。

    onNetworkQuality

    ネットワーク状況のコールバック。

    void onNetworkQuality(TRTCCloudDef.TRTCQuality localQuality, List remoteQuality);
    

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

    パラメータ タイプ 意味
    localQuality TRTCCloudDef.TRTCQuality アップストリームのネットワーク品質。
    remoteQuality List<TRTCCloudDef.TRTCQuality> ダウンストリームのネットワーク品質。
    説明:

    詳細については、 TRTC SDKをご参照ください。

    画面共有イベントコールバック

    onScreenCaptureStarted

    画面共有開始のコールバック。

    void onScreenCaptureStarted();
    

    onScreenCaptureStopped

    画面共有停止のコールバック。

    void onScreenCaptureStopped(int reason);
    

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

    パラメータ タイプ 意味
    reason int 停止の理由。0:ユーザーの自発的な停止。1:その他アプリケーションに占有されたことによる停止。
    お問い合わせ

    カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

    テクニカルサポート

    さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

    電話サポート(24 時間365日対応)