TUIRoomは、Tencent CloudのTencent Real-Time Communication(TRTC)およびIMサービスを基に組み合わせたコンポーネントで、以下の機能をサポートしています。
説明:TUIKitシリーズコンポーネントはTencent CloudのTRTCとIMという2つの基本的なPaaSサービスを同時に使用し、TRTCをアクティブにした後、IMサービスを同期してアクティブ化することができます。 IMサービスの課金ルールの詳細については、Instant Messagingの料金説明をご参照ください。TRTCをアクティブ化すると、関連するIM SDKの体験版がデフォルトでアクティブ化されます。これは100 DAUのみをサポートします。
TUIRoomはオープンソースのClassであり、Tencent Cloudの2つのクローズドソースのSDKに依存しています。具体的な実装プロセスについては、 多人数オーディオビデオルーム(Windows&Mac)をご参照ください。
API | 説明 |
---|---|
GetInstance | シングルトンオブジェクトを取得します。 |
DestroyInstance | シングルトンオブジェクトを破棄します。 |
SetCallback | イベントコールバックを設定します。 |
API | 説明 |
---|---|
login | ログイン。 |
logout | ログアウト。 |
CreateRoom | ルームの作成(キャスターが呼び出し)。 |
DestroyRoom | ルームの破棄(キャスターが呼び出し)。 |
EnterRoom | 入室(参加者が呼び出し)。 |
LeaveRoom | 退室(参加者が呼び出し)。 |
GetRoomInfo | ルーム情報の取得。 |
GetRoomUsers | ルーム内全メンバー情報の取得。 |
GetUserInfo | 特定ユーザーの情報の取得。 |
TransferRoomMaster | キャスター権限の移転(キャスターが呼び出し)。 |
API | 説明 |
---|---|
StartCameraPreview | ローカルビデオのプレビュー画面を立ち上げます。 |
StopCameraPreview | ローカルビデオキャプチャおよびプレビューを停止します。 |
UpdateCameraPreview | ローカルビデオレンダリングウィンドウを変更します。 |
StartLocalAudio | マイクキャプチャを起動します。 |
StopLocalAudio | マイクキャプチャを停止します。 |
StartSystemAudioLoopback | システム音声のキャプチャを起動/停止します。 |
StopSystemAudioLoopback | システム音声のキャプチャを起動/停止します。 |
SetVideoMirror | ローカル画面のイメージプレビューモードを設定します。 |
API | 説明 |
---|---|
StartRemoteView | 指定メンバーのリモートビデオ画面をサブスクリプションし再生します。 |
StopRemoteView | リモートビデオ画面のサブスクリプションをキャンセルし再生を停止します。 |
UpdateRemoteView | リモートユーザーのビデオレンダリングウィンドウを変更します。 |
API | 説明 |
---|---|
SendChatMessage | チャットメッセージを送信します。 |
SendCustomMessage | カスタムメッセージを送信します。 |
API | 説明 |
---|---|
MuteUserMicrophone | 特定ユーザーのマイクを無効化/再有効化します。 |
MuteAllUsersMicrophone | 全ユーザーのマイクを無効化/再有効化し、ステータスをルーム情報に同期させます。 |
MuteUserCamera | 特定ユーザーのカメラを無効化/再有効化します。 |
MuteAllUsersCamera | 全ユーザーのカメラを無効化/再有効化し、ステータスをルーム情報に同期させます。 |
MuteChatRoom | チャットルームのミュートを開始/停止します(キャスターが呼び出し)。 |
KickOffUser | ルーム内の特定ユーザーをリムーブします(キャスターが呼び出し)。 |
StartCallingRoll | キャスターが点呼を開始します。 |
StopCallingRoll | キャスターが点呼を終了します。 |
ReplyCallingRoll | メンバーがキャスターの点呼に応答します。 |
SendSpeechInvitation | キャスターが参加者の発言を要請します。 |
CancelSpeechInvitation | キャスターが参加者の発言要請をキャンセルします。 |
ReplySpeechInvitation | 参加者がキャスターの発言申請に同意/拒否します。 |
SendSpeechApplication | 参加者が発言を申請します。 |
CancelSpeechApplication | 参加者が発言申請をキャンセルします。 |
ReplySpeechApplication | キャスターが参加者の発言申請に同意/拒否します。 |
ForbidSpeechApplication | キャスターが発言申請を禁止します。 |
SendOffSpeaker | キャスターが参加者に発言を停止するよう命令します。 |
SendOffAllSpeakers | キャスターが全員に発言を停止するよう命令します。 |
ExitSpeechState | 参加者は発言を停止し、視聴者になります。 |
API | 説明 |
---|---|
GetDeviceManager | ローカル設定管理オブジェクトITXDeviceManagerを取得します。 |
GetScreenShareManager | 画面共有管理オブジェクトIScreenShareManagerを取得します。 |
API | 説明 |
---|---|
StartCloudRecord | クラウドレコーディングを開始します 。 |
StopCloudRecord | クラウドレコーディングを停止します 。 |
API | 説明 |
---|---|
SetBeautyStyle | 美顔を設定します。 |
API | 説明 |
---|---|
SetVideoQosPreference | ネットワークトラフィックコントロール関連パラメータを設定します。 |
API | 説明 |
---|---|
GetSDKVersion | SDKバージョンを取得します。 |
API | 説明 |
---|---|
OnError | エラーのコールバック。 |
API | 説明 |
---|---|
OnLogin | ログインコールバック。 |
OnLogout | ログアウトコールバック。 |
OnCreateRoom | ルーム作成のコールバック。 |
OnDestroyRoom | ルーム解散のコールバック。 |
OnEnterRoom | 入室のコールバック。 |
OnExitRoom | 退室のコールバック。 |
OnFirstVideoFrame | 最初のフレーム画面のコールバック。 |
OnUserVoiceVolume | 音量の大きさのコールバック。 |
OnRoomMasterChanged | キャスター変更のコールバック。 |
API | 説明 |
---|---|
OnRemoteUserEnter | リモートユーザー入室コールバック。 |
OnRemoteUserLeave | リモートユーザー退室コールバック。 |
OnRemoteUserCameraAvailable | リモートユーザーがカメラビデオを起動するかどうかのコールバック。 |
OnRemoteUserScreenAvailable | リモートユーザーが画面共有を開始するかどうかのコールバック。 |
OnRemoteUserAudioAvailable | リモートユーザーがマイクをオンにしているかどうかのコールバック。 |
OnRemoteUserEnterSpeechState | リモートユーザーの発言開始のコールバック。 |
OnRemoteUserExitSpeechState | リモートユーザーの発言終了のコールバック。 |
API | 説明 |
---|---|
OnReceiveChatMessage | テキストメッセージ受信のコールバック。 |
OnReceiveCustomMessage | テキストメッセージ受信のコールバック。 |
API | 説明 |
---|---|
OnReceiveSpeechInvitation | ユーザーがキャスターの発言要請を受信した場合のコールバック。 |
OnReceiveInvitationCancelled | ユーザーがキャスターの発言要請キャンセルを受信する場合のコールバック。 |
OnReceiveReplyToSpeechInvitation | キャスターがユーザーの発言要請への同意を受信する場合のコールバック。 |
OnReceiveSpeechApplication | キャスターがユーザーの発言申請を受信する場合のコールバック。 |
OnSpeechApplicationCancelled | ユーザーが発言申請をキャンセルする場合のコールバック。 |
OnReceiveReplyToSpeechApplication | キャスターが発言申請に同意する場合のコールバック。 |
OnSpeechApplicationForbidden | キャスターが発言申請を禁止する場合のコールバック。 |
OnOrderedToExitSpeechState | 参加者が発言の停止をリクエストされる場合のコールバック。 |
OnCallingRollStarted | キャスターが点呼を開始し、参加者が受信する場合のコールバック。 |
OnCallingRollStopped | キャスターが点呼を終了し、参加者が受信する場合のコールバック。 |
OnMemberReplyCallingRoll | 参加者が点呼に応答し、キャスターが受信する場合のコールバック。 |
OnChatRoomMuted | キャスターがチャットルームのミュートを変更する場合のコールバック。 |
OnMicrophoneMuted | キャスターがマイクの無効化を設定する場合のコールバック。 |
OnCameraMuted | キャスターがカメラの無効化を設定する場合のコールバック。 |
API | 説明 |
---|---|
OnStatistics | 技術指標統計のコールバック。 |
OnNetworkQuality | ネットワーク品質のコールバック。 |
API | 説明 |
---|---|
OnScreenCaptureStarted | 画面共有開始のコールバック。 |
OnScreenCaptureStopped | 画面共有停止のコールバック。 |
API | 説明 |
---|---|
OnRecordError | レコーディングエラーのコールバック。 |
OnRecordComplete | レコーディング完了のコールバック。 |
OnRecordProgress | レコーディング進捗のコールバック。 |
API | 説明 |
---|---|
OnTestSpeakerVolume | スピーカー音量のコールバック。 |
OnTestMicrophoneVolume | マイク音量のコールバック。 |
OnAudioDeviceCaptureVolumeChanged | システムキャプチャ音量調節のコールバック。 |
OnAudioDevicePlayoutVolumeChanged | システム再生音量調節のコールバック。 |
TUIRoomCore シングルトンオブジェクトを取得します。
static TUIRoomCore* GetInstance();
static void DestroyInstance();
TUIRoomCoreイベントコールバック。TUIRoomCoreCallbackを介してTUIRoomCoreの各種ステータス通知を取得できます。
virtual void SetCallback(const TUIRoomCoreCallback* callback) = 0;
ログイン。
virtual int Login(int sdk_appid, const std::string& user_id, const std::string& user_sig) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
sdk_appid | int | TRTCコンソール > アプリケーション管理> アプリケーション情報の中でSDKAppIDを確認できます。 |
user_id | string | 現在のユーザーID。文字列タイプでは、英語のアルファベット(a-z、A-Z)、数字(0-9)、ハイフン(-)とアンダーライン(_)のみ使用できます。業務の実際のアカウントシステムと組み合わせてご自身で設定することをお勧めします。 |
user_sig | string | Tencent Cloudによって設計されたセキュリティ保護署名。取得方法については、 UserSigの計算、使用方法をご参照ください。 |
ログアウト。
virtual int Logout() = 0;
ルームの作成(キャスターが呼び出し)。
virtual int CreateRoom(const std::string& room_id, TUISpeechMode speech_mode) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
room_id | string | ルームIDは、ご自身でアサインし、一元管理する必要があります。 |
speech_mode | TUISpeechMode | 発言モード。 |
キャスターの通常の呼び出しフローは以下のとおりです。
CreateRoom()
を呼び出し、ルームを作成します。ルームの作成の成否はOnCreateRoomを介してキャスターに通知されます。EnterRoom()
を呼び出し、入室します。StartCameraPreview()
を呼び出し 、カメラキャプチャとプレビューを起動します。StartLocalAudio()
を呼び出し、ローカルマイクを起動します。ルームの破棄(キャスターが呼び出し)。キャスターは、ルームの作成後、この関数を呼び出して、ルームを破棄できます。
virtual int DestroyRoom() = 0;
入室(参加者が呼び出し)。
virtual int EnterRoom(const std::string& room_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
room_id | string | ルームID。 |
参加者が入室する場合の通常の呼び出し手順は次のとおりです。
EnterRoom
を呼び出し、room_idを渡せば、入室できます。startCameraPreview()
を呼び出して、カメラプレビューを起動し、StartLocalAudio()
を呼び出して、マイクキャプチャを起動します。OnRemoteUserCameraAvailable
のイベントを受信し、StartRemoteView()
を呼び出して、ビデオ再生を開始します。退室(参加者が呼び出し)。
virtual int LeaveRoom() = 0;
ルーム情報を取得します。
virtual TUIRoomInfo GetRoomInfo() = 0;
ルームの全メンバー情報を取得します。
virtual std::vector<TUIUserInfo> GetRoomUsers() = 0;
メンバー情報を取得します。
virtual const TUIUserInfo* GetUserInfo(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザーID。 |
ユーザーの属性を設定します。
virtual int SetSelfProfile(const std::string& user_name, const std::string& avatar_url) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_name | string | ユーザー氏名。 |
avatar_url | string | ユーザーのプロフィール画像URL。 |
グループを他のユーザーに引き渡します。
virtual int TransferRoomMaster(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザーID。 |
ローカルカメラプレビューを起動します。
virtual int StartCameraPreview(const liteav::TXView& view) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
view | liteav::TXView | ウィンドウハンドル。 |
ローカルカメラプレビューを停止します。
virtual int StopCameraPreview() = 0;
ローカルビデオプレビュー画面のウィンドウを更新します。
virtual int UpdateCameraPreview(const liteav::TXView& view) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
view | liteav::TXView | ウィンドウハンドル。 |
ローカルオーディオデバイスを起動します。
virtual int StartLocalAudio(const liteav::TRTCAudioQuality& quality) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
view | liteav::TXView | ウィンドウハンドル。 |
ローカルオーディオデバイスを停止します。
virtual int StopLocalAudio() = 0;
システム音声のキャプチャを開始します。
virtual int StartSystemAudioLoopback() = 0;
システム音声のキャプチャを停止します。
virtual int StopSystemAudioLoopback() = 0;
イメージを設定します。
virtual int SetVideoMirror(bool mirror) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
mirror | bool | ミラーオン/オフ。 |
リモートユーザーのビデオストリームのサブスクリプション。
virtual int StartRemoteView(const std::string& user_id, const liteav::TXView& view,
TUIStreamType type = TUIStreamType::kStreamTypeCamera) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | 再生が必要なユーザー ID。 |
liteav::TXView | TXView | ビデオ画像をロードするviewウィジェット。 |
type | TUIStreamType | ストリームのタイプ。 |
サブスクリプションをキャンセルし、リモートビデオ画面の再生を停止します。
virtual int StopRemoteView(const std::string& user_id,
TUIStreamType type = TUIStreamType::kStreamTypeCamera) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | 再生の停止が必要なユーザー ID。 |
type | TUIStreamType | ストリームのタイプ。 |
リモートビデオレンダリングウィンドウを更新します。
virtual int UpdateRemoteView(const std::string& user_id, TUIStreamType type, liteav::TXView& view) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
type | TUIStreamType | ストリームのタイプ。 |
view | liteav::TXView | レンダリングウィンドウハンドル。 |
テキストメッセージを送信します。
virtual int SendChatMessage(const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
message | string | メッセージの内容。 |
カスタムメッセージを送信します。
virtual int SendCustomMessage(const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
message | string | メッセージの内容。 |
特定ユーザーのマイクを無効化/再有効化します。
virtual int MuteUserMicrophone(const std::string& user_id, bool mute, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
mute | bool | 無効にするかどうか。 |
callback | Callback | インターフェースコールバック。 |
全ユーザーのマイクを無効化/再有効化します。
virtual int MuteAllUsersMicrophone(bool mute) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
mute | bool | 無効にするかどうか。 |
特定ユーザーのカメラを無効化/再有効化します。
virtual int MuteUserCamera(const std::string& user_id, bool mute, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
mute | bool | 無効にするかどうか。 |
callback | Callback | インターフェースコールバック。 |
全ユーザーのカメラを無効化/再有効化します。
virtual int MuteAllUsersCamera(bool mute) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
mute | bool | 無効にするかどうか。 |
チャットルームのミュートを開始/停止します。
virtual int MuteChatRoom(bool mute) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
mute | bool | 無効にするかどうか。 |
キャスターがキックアウトします。
virtual int KickOffUser(const std::string& user_id, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
callback | Callback | インターフェースコールバック。 |
キャスターが点呼を開始します。
virtual int StartCallingRoll() = 0;
キャスターが点呼を終了します。
virtual int StopCallingRoll() = 0;
参加者がキャスターの点呼に応答します。
virtual int ReplyCallingRoll(Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
callback | Callback | インターフェースコールバック。 |
キャスターが参加者の発言を要請します。
virtual int SendSpeechInvitation(const std::string& user_id, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
callback | Callback | インターフェースコールバック。 |
キャスターが参加者の発言要請をキャンセルします。
virtual int CancelSpeechInvitation(const std::string& user_id, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
callback | Callback | インターフェースコールバック。 |
参加者がキャスターの発言要請に同意/拒否します。
virtual int ReplySpeechInvitation(bool agree, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
agree | bool | 同意するかどうか。 |
callback | Callback | インターフェースコールバック。 |
参加者が発言を申請します。
virtual int SendSpeechApplication(Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
callback | Callback | インターフェースコールバック。 |
参加者が発言申請をキャンセルします。
virtual int CancelSpeechApplication(Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
callback | Callback | インターフェースコールバック。 |
キャスターが参加者の発言申請に同意/拒否します。
virtual int ReplySpeechApplication(const std::string& user_id, bool agree, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
callback | Callback | インターフェースコールバック。 |
キャスターが発言申請を禁止します。
virtual int ForbidSpeechApplication(bool forbid) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
forbid | bool | 禁止するかどうか。 |
キャスターが参加者に発言の停止を命令します。
virtual int SendOffSpeaker(const std::string& user_id, Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
callback | Callback | インターフェースコールバック。 |
キャスターが全メンバーに発言の停止を命令します。
virtual int SendOffAllSpeakers(Callback callback) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
callback | Callback | インターフェースコールバック。 |
参加者が発言を停止し、視聴者になります。
virtual int ExitSpeechState() = 0;
デバイス管理のオブジェクトポインタを取得します。
virtual liteav::ITXDeviceManager* GetDeviceManager() = 0;
画面共有管理のオブジェクトポインタを取得します。
virtual IScreenShareManager* GetScreenShareManager() = 0;
クラウドレコーディングを開始します。
virtual int StartCloudRecord() = 0;
クラウドレコーディングを停止します。
virtual int StopCloudRecord() = 0;
美顔、美白、肌の色調補正効果のランクを設定します。
virtual int SetBeautyStyle(liteav::TRTCBeautyStyle style, uint32_t beauty_level,
uint32_t whiteness_level, uint32_t ruddiness_level) = 0;
美顔管理では、次の機能を使用できます。
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
style | liteav::TRTCBeautyStyle | 美顔スタイル。 |
beauty_level | uint32_t | 美顔レベル。 |
whiteness_level | uint32_t | 美白レベル。 |
ruddiness_level | uint32_t | 肌色補正レベル。 |
ネットワークトラフィックコントロール関連パラメータを設定します。
virtual int SetVideoQosPreference(TUIVideoQosPreference preference) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
preference | TUIVideoQosPreference | ネットワークトラフィックコントロールポリシー。 |
SDKバージョン情報を取得します。
virtual const char* GetSDKVersion() = 0;
void OnError(int code, const std::string& message);
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
code | int | エラーコード。 |
message | string | エラー情報。 |
virtual void OnLogin(int code, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
code | int | エラーコード。 |
message | string | ログイン情報またはログイン失敗のエラー情報。 |
virtual void OnLogout(int code, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
code | int | エラーコード。 |
message | string | エラー情報。 |
ルーム作成のコールバックです。
virtual void OnCreateRoom(int code, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
code | int | エラーコード。 |
message | string | エラー情報。 |
ルーム解散のコールバックです。
virtual void OnDestroyRoom(int code, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
code | int | エラーコード。 |
message | string | エラー情報。 |
入室コールバックです。
virtual void OnEnterRoom(int code, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
code | int | エラーコード。 |
message | string | エラー情報。 |
退室コールバックです。
virtual void OnExitRoom(TUIExitRoomType type, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
type | TUIExitRoomType | 退室のタイプ。 |
message | string | エラー情報。 |
自身のローカルまたはリモートユーザーの最初のフレーム画面のレンダリングを開始します。
virtual void OnFirstVideoFrame(const std::string& user_id, const TUIStreamType stream_type) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
stream_type | TUIStreamType | ストリームのタイプ。 |
ユーザー音量の大きさのコールバック。
virtual void OnUserVoiceVolume(const std::string& user_id, int volume)
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
volume | int | ユーザーの音量の大きさ、値の範囲0~100。 |
キャスター変更のコールバック。
virtual void OnRoomMasterChanged(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
リモートユーザー入室コールバック。
virtual void OnRemoteUserEnter(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
リモートユーザー退室コールバック。
virtual void OnRemoteUserLeave(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
リモートユーザーが、カメラ、ビデオを起動しているかどうか。
virtual void OnRemoteUserCameraAvailable(const std::string& user_id, bool available) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
available | bool | true:ビデオストリームデータあり;false:ビデオストリームデータなし。 |
リモートユーザーが画面共有を開始しているかどうか。
virtual void OnRemoteUserScreenAvailable(const std::string& user_id, bool available) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
available | bool | true:ビデオストリームデータあり;false:ビデオストリームデータなし。 |
リモートユーザーがマイクをオンにしているかどうか。
virtual void OnRemoteUserAudioAvailable(const std::string& user_id, bool available) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
available | bool | true:オーディオストリームデータあり、false:オーディオストリームデータなし。 |
リモートユーザーが発言を開始します。
virtual void OnRemoteUserEnterSpeechState(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
リモートユーザーが発言を終了します。
virtual void OnRemoteUserExitSpeechState(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
テキストメッセージの受信。
virtual void OnReceiveChatMessage(const std::string& user_id, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
message | string | テキストメッセージ。 |
カスタムメッセージの受信。
virtual void OnReceiveCustomMessage(const std::string& user_id, const std::string& message) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
message | string | カスタムメッセージ。 |
ユーザーがキャスターの発言要請を受信する場合のコールバック。
virtual void OnReceiveSpeechInvitation() = 0;
ユーザーがキャスターの発言要請キャンセルを受信する場合のコールバック。
virtual void OnReceiveInvitationCancelled() = 0;
キャスターがユーザーの発言要請への同意を受信する場合のコールバック。
virtual void OnReceiveReplyToSpeechInvitation(const std::string& user_id, bool agree) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
agree | bool | 同意するかどうか。 |
キャスターがユーザーの発言申請を受信する場合のコールバック。
virtual void OnReceiveSpeechApplication(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
ユーザーが発言申請をキャンセルする場合のコールバック。
virtual void OnSpeechApplicationCancelled(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
キャスターが発言申請に同意する場合のコールバック。
virtual void OnReceiveReplyToSpeechApplication(bool agree) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
agree | bool | 同意するかどうか。 |
キャスターが発言申請を禁止する場合のコールバック。
virtual void OnSpeechApplicationForbidden(bool forbidden) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
forbidden | bool | 禁止するかどうか。 |
参加者が発言を停止するようリクエストされる場合のコールバック。
virtual void OnOrderedToExitSpeechState() = 0;
キャスターが点呼を開始し、メンバーが受信する場合のコールバック。
virtual void OnCallingRollStarted() = 0;
キャスターが点呼を終了し、参加者が受信する場合のコールバック。
virtual void OnCallingRollStopped() = 0;
参加者が点呼に応答し、キャスターが受信する場合のコールバック。
virtual void OnMemberReplyCallingRoll(const std::string& user_id) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
user_id | string | ユーザー ID。 |
キャスターがチャットルームのミュートを変更する場合のコールバック。
virtual void OnChatRoomMuted(bool muted) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
muted | bool | 無効にするかどうか。 |
キャスターがマイクの無効化を設定する場合のコールバック。
virtual void OnMicrophoneMuted(bool muted) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
muted | bool | 無効にするかどうか。 |
キャスターがカメラの無効化を設定する場合のコールバック。
virtual void OnCameraMuted(bool muted) = 0;
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
muted | bool | 無効にするかどうか。 |
技術指標統計のコールバック。
virtual void OnStatistics(const liteav::TRTCStatistics& statis) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
statis | liteav::TRTCStatistics | 統計データ。 |
ネットワーク状況のコールバック。
virtual void OnNetworkQuality(const liteav::TRTCQualityInfo& local_quality, liteav::TRTCQualityInfo* remote_quality,
uint32_t remote_quality_count) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
local_quality | liteav::TRTCQualityInfo | ローカルユーザー品質情報。 |
remote_quality | liteav::TRTCQualityInfo* | リモートユーザー品質情報ポインタ。 |
remote_quality_count | uint32_t | リモートユーザー数。 |
画面共有開始のコールバック。
virtual void OnScreenCaptureStarted() {}
画面共有停止のコールバック。
void OnScreenCaptureStopped(int reason) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
reason | int | 停止の理由。0:ユーザーの自発的な停止。1:その他アプリケーションに占有されたことによる停止。 |
レコーディングエラーのコールバック。
virtual void OnRecordError(TXLiteAVLocalRecordError error, const std::string& messgae) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
error | TXLiteAVLocalRecordError | エラー情報。 |
messgae | string | エラー説明。 |
レコーディング完了のコールバック。
virtual void OnRecordComplete(const std::string& path) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
path | string | エラーの説明。 |
レコーディング進捗のコールバック。
virtual void OnRecordProgress(int duration, int file_size) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
duration | int | ファイルの長さ。 |
file_size | int | ファイルのサイズ。 |
スピーカー音量の大きさのコールバック。
virtual void OnTestSpeakerVolume(uint32_t volume) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
volume | uint32_t | 音量の大きさ。 |
マイク音量の大きさのコールバック。
virtual void OnTestMicrophoneVolume(uint32_t volume) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
volume | uint32_t | 音量の大きさ。 |
システムキャプチャ音量調節のコールバック。
virtual void OnAudioDeviceCaptureVolumeChanged(uint32_t volume, bool muted) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
volume | uint32_t | 音量の大きさ。 |
muted | bool | 無効にされるかどうか |
システム再生音量調節のコールバック。
virtual void OnAudioDevicePlayoutVolumeChanged(uint32_t volume, bool muted) {}
パラメータは下表に示すとおりです。
パラメータ | タイプ | 意味 |
---|---|---|
volume | uint32_t | 音量の大きさ。 |
muted | bool | 無効にされるかどうか |
この記事はお役に立ちましたか?