API概要

最終更新日:2021-10-20 11:30:02

    C++ 全プラットフォームインターフェースの紹介

    バージョン8.0より、従来のWindows(C++)インターフェースをベースとした、新しいC++ インターフェースを提供しています。Windows、iOS、Mac、Androidプラットフォームに適用します。
    C++ インターフェースを統合する方法がわからない場合は、各プラットフォームの統合ガイドをご参照ください。

    説明:

    • 現在C++インターフェースは簡易版(TRTC)の中でのみ提供されています。
    • Windowsプラットフォームでは、TRTCヘッダーファイルで自動的に「trtc」ネームスペースを使用するようになっていますので、あらためて指定する必要はありません。

    ITRTCCloud @ TXLiteAVSDK

    インスタンスの作成およびイベントコールバック

    API 説明
    getTRTCShareInstance TRTCCloudインスタンスの作成(シングルトンモード)
    destroyTRTCShareInstance TRTCCloudインスタンスを破棄 (シングルトンモード)
    addCallback TRTCイベントコールバックを設定
    removeCallback TRTCイベントコールバックを削除

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

    API 説明
    enterRoom ルームに入室
    exitRoom ルームを退室
    switchRole ロールの切り替え
    switchRoom ルームの切り替え
    connectOtherRoom ルーム間通話のリクエスト
    disconnectOtherRoom ルーム間通話を退出
    setDefaultStreamRecvMode サブスクライブモードを設定(有効にするには入室前に設定する必要があります)
    createSubCloud サブルーム事例の作成(複数のルームで同時視聴するために使用されます)
    destroySubCloud サブルーム事例の破棄

    CDN関連インターフェース関数

    API 説明
    startPublishing Tencent Cloud CSS CDNへのオーディオビデオストリーミングの公開を開始
    stopPublishing Tencent Cloud CSS CDNへのオーディオビデオストリーミングの公開を停止
    startPublishCDNStream 非Tencent Cloud CDNへのオーディオビデオストリーミングの公開を開始
    stopPublishCDNStream 非Tencent Cloud CDNへのオーディオビデオストリーミングの公開を停止
    setMixTranscodingConfig クラウドミクスストリーミングのレイアウトおよびトランスコードパラメータを設定

    ビデオ関連インターフェース関数

    API 説明
    startLocalPreview ローカルカメラのプレビュー画面を有効化(モバイル端末)
    startLocalPreview ローカルカメラのプレビュー画面を有効化(デスクトップ)
    updateLocalView ローカルカメラのプレビュー画面を更新
    stopLocalPreview カメラのプレビューを停止
    muteLocalVideo ローカルのビデオストリームの公開を一時停止/再開
    startRemoteView リモートユーザーのビデオストリームをサブスクライブし、ビデオレンダリングウィジェットをバインド
    updateRemoteView リモートユーザーのビデオレンダリングウィジェットを更新
    stopRemoteView リモートユーザーのビデオストリームのサブスクライブを停止し、レンダリングウィジェットをリリース
    stopAllRemoteView すべてのリモートユーザーのビデオストリームのサブスクライブを停止し、すべてのレンダリングリソースをリリース
    muteRemoteVideoStream リモートユーザーのビデオストリームのサブスクライブを一時停止/再開
    muteAllRemoteVideoStreams すべてのリモートユーザーのビデオストリームのサブスクライブを一時停止/再開
    setVideoEncoderParam ビデオエンコーダのエンコードパラメータを設定
    setNetworkQosParam ネットワーク品質モニタリングの関連パラメータを設定
    setLocalRenderParams ローカル画面のレンダリングパラメータを設定
    setRemoteRenderParams リモート画面のレンダリングモードを設定
    setVideoEncoderRotation ビデオエンコーダが出力する画面の方向を設定
    setVideoEncoderMirror エンコーダが出力する画面のイメージモードを設定
    enableSmallVideoStream 大小画面のデュアルチャンネルコーディングモードを有効化
    setRemoteVideoStreamType 指定リモートユーザーの大小画面を切り替え
    snapshotVideo ビデオ画面のスクリーンキャプチャ

    オーディオ関連インターフェース関数

    API 説明
    startLocalAudio ローカルオーディオのキャプチャおよび公開を有効化
    stopLocalAudio ローカルオーディオのキャプチャおよび公開を停止
    muteLocalAudio ローカルのオーディオストリームの公開を一時停止/再開
    muteRemoteAudio リモートのオーディオストリームの再生を一時停止/再開
    muteAllRemoteAudio すべてのリモートユーザーのオーディオストリームの再生を一時停止/再開
    setRemoteAudioVolume 特定リモートユーザーの音声再生音量を設定
    setAudioCaptureVolume ローカルオーディオのキャプチャ音量を設定
    getAudioCaptureVolume ローカルオーディオのキャプチャ音量を取得
    setAudioPlayoutVolume リモートオーディオの再生音量を設定
    getAudioPlayoutVolume リモートオーディオの再生音量を設定
    enableAudioVolumeEvaluation 音量レベルのプロンプトを起動
    startAudioRecording 録音を開始
    stopAudioRecording 録音を停止
    startLocalRecording ローカルメディアのレコーディングを有効化
    stopLocalRecording ローカルメディアのレコーディングを停止

    デバイス管理関連インターフェース

    API 説明
    getDeviceManager デバイス管理タイプ(TXDeviceManager)を取得

    美顔特殊効果および画像のウォーターマーク

    API 説明
    setBeautyStyle 美顔、美白および肌の色調補正エフェクトレベルを設定
    setWaterMark ウォーターマークの追加

    BGMおよび音声の特殊効果

    API 説明
    getAudioEffectManager オーディオエフェクトマネージャー(TXAudioEffectManager)を取得
    startSystemAudioLoopback システム音声キャプチャを有効化(デスクトップシステムのみに適用)
    stopSystemAudioLoopback システム音声キャプチャを停止(デスクトップシステムのみに適用)
    setSystemAudioLoopbackVolume システム音声のキャプチャ音量を設定

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

    API 説明
    startScreenCapture デスクトップ画面共有を開始(このインターフェースはデスクトップシステムのみをサポート)
    stopScreenCapture 画面共有を停止
    pauseScreenCapture 画面共有を一時停止
    pauseScreenCapture 画面共有を再開
    getScreenCaptureSources 共有可能な画面およびウィンドウを列挙(このインターフェースはデスクトップシステムのみをサポート)
    selectScreenCaptureTarget 共有したい画面またはウィンドウを選択(このインターフェースはデスクトップシステムのみをサポート)
    setSubStreamEncoderParam 画面共有(サブストリーム)のビデオコーデックパラメータを設定(このインターフェースはデスクトップシステムのみをサポート)
    setSubStreamMixVolume 画面共有時の音声ミキシングの音量レベルを設定(このインターフェースはデスクトップシステムのみをサポート)
    addExcludedShareWindow 指定のウィンドウを画面共有のexcludeリストに追加(このインターフェースはデスクトップシステムのみをサポート)
    removeExcludedShareWindow 指定のウィンドウを画面共有のexcludeリストから削除(このインターフェースはデスクトップシステムのみをサポート)
    removeAllExcludedShareWindow すべてのウィンドウを画面共有のexcludeリストから削除(このインターフェースはデスクトップシステムのみをサポート)
    addIncludedShareWindow 指定のウィンドウを画面共有のincludeリストに追加(このインターフェースはデスクトップシステムのみをサポート)
    removeIncludedShareWindow 指定のウィンドウを画面共有のincludeリストから削除(このインターフェースはデスクトップシステムのみをサポート)
    removeAllIncludedShareWindow すべてのウィンドウを画面共有のincludeリストから削除(このインターフェースはデスクトップシステムのみをサポート)

    ユーザー定義キャプチャおよびカスタムレンダリング

    API 説明
    enableCustomVideoCapture ビデオユーザー定義キャプチャモードの起動/終了
    sendCustomVideoData 自身がキャプチャしたビデオフレームをSDKに送信
    enableCustomAudioCapture オーディオのユーザー定義キャプチャモードを起動
    sendCustomAudioData 自身がキャプチャしたオーディオデータをSDKに送信
    enableMixExternalAudioFrame ユーザー定義のオーディオトラックの起動/終了
    mixExternalAudioFrame ユーザー定義のオーディオトラックをSDKにミキシング
    setMixExternalAudioVolume プッシュ時にミキシングする外部オーディオのプッシュ音量および再生音量を設定
    generateCustomPTS ユーザー定義キャプチャ時のタイムスタンプを発行
    setLocalVideoProcessCallback サードパーティによる美顔のビデオデータコールバックを設定
    setLocalVideoRenderCallback ローカルビデオカスタムレンダリングコールバックを設定
    setRemoteVideoRenderCallback リモートビデオカスタムレンダリングコールバックを設定
    setAudioFrameCallback オーディオデータカスタムコールバックを設定
    enableCustomAudioRendering オーディオカスタム再生を有効化
    getCustomAudioRenderingFrame 再生可能なオーディオデータを取得

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

    API 説明
    sendCustomCmdMsg UDPチャネルを利用してカスタムメッセージをルーム内のすべてのユーザーに送信
    sendSEIMsg SEIチャネルを利用して送信カスタムメッセージをルーム内のすべてのユーザーに送信

    ネットワークテストインターフェース

    API 説明
    startSpeedTest ネットワークスピードテストを開始(ルーム入室前に使用)
    stopSpeedTest ネットワークスピードテストを停止

    デバック関連インターフェース

    API 説明
    getSDKVersion SDKのバージョン情報を取得
    setLogLevel Log出力レベルを設定
    setConsoleEnabled コンソールのログプリントを有効化/無効化
    setLogCompressEnabled ログのローカル圧縮を有効化/無効化
    setLogDirPath ローカルログの保存パスを設定
    setLogCallback ログコールバックを設定
    showDebugView ダッシュボードを表示
    callExperimentalAPI 試験的インターフェースの呼び出し

    破棄されたインターフェース

    API 説明
    enableCustomVideoCapture ビデオのユーザー定義キャプチャモード を起動
    sendCustomVideoData 自身がキャプチャしたビデオデータを送信
    muteLocalVideo ローカルのビデオストリームの公開を一時停止/再開
    muteRemoteVideoStream リモートユーザーのビデオストリームのサブスクライブを一時停止 / 再開

    エラーおよび警告イベント

    API 説明
    onError エラーイベントコールバック
    onWarning 警告イベントコールバック

    ルーム関連イベントコールバック

    API 説明
    onEnterRoom 入室成功または失敗のイベントコールバック
    onExitRoom 退室のイベントコールバック
    onSwitchRole ロール切り替えのイベントコールバック
    onSwitchRoom ルーム切り替え結果のコールバック
    onConnectOtherRoom ルーム間通話リクエスト結果のコールバック
    onDisconnectOtherRoom ルーム間通話終了結果のコールバック

    ユーザー関連イベントコールバック

    API 説明
    onRemoteUserEnterRoom ユーザーが現在のルームに入室
    onRemoteUserLeaveRoom ユーザーが現在のルームを退室
    onUserVideoAvailable リモートユーザーが公開/キャンセルしたビッグストリームのビデオ画面
    onUserSubStreamAvailable リモートユーザーが公開/キャンセルしたサブストリームのビデオ画面
    onUserAudioAvailable リモートユーザーが公開/キャンセルした自身のオーディオ
    onFirstVideoFrame SDKが自身のローカルユーザーまたはリモートユーザーの最初のフレーム画面のレンダリングを開始
    onFirstAudioFrame SDKがリモートユーザーの最初のフレームのオーディオの再生を開始
    onSendFirstLocalVideoFrame 自身のローカルの最初のビデオフレームが公開済み
    onSendFirstLocalAudioFrame 自身のローカルの最初のオーディオフレームが公開済み
    onRemoteVideoStatusUpdated リモートビデオステータス変更のイベントコールバック

    ネットワークおよび技術指標統計のコールバック

    API 説明
    onNetworkQuality ネットワーク品質のリアルタイム統計のコールバック
    onStatistics オーディオビデオ技術指標のリアルタイム統計のコールバック

    クラウドとの接続状況のイベントコールバック

    API 説明
    onConnectionLost SDKがクラウドとの接続を切断済み
    onTryToReconnect SDKがクラウドとの再接続を試行中
    onConnectionRecovery SDKがクラウドとの接続を再開済み
    onSpeedTest サーバースピードテストの結果のコールバック

    ハードウェアデバイス関連イベントコールバック

    API 説明
    onCameraDidReady カメラの準備完了
    onMicDidReady マイクの準備完了
    onUserVoiceVolume 音量レベルフィードバックのコールバック
    onDeviceChange ローカルデバイスのオン/オフステータスに変更発生(デスクトップシステムのみに適用)
    onAudioDeviceCaptureVolumeChanged 現在のマイクのシステムキャプチャ音量に変更発生
    onAudioDevicePlayoutVolumeChanged 現在のシステムの再生音量に変更発生
    onSystemAudioLoopbackError システム音声キャプチャが正常に開始されたかどうかのイベントコールバック(Macシステムのみに適用)
    onTestMicVolume マイクテスト時の音量のコールバック
    onTestSpeakerVolume スピーカーテスト時の音量のコールバック

    カスタムメッセージ受信イベントコールバック

    API 説明
    onRecvCustomCmdMsg カスタムメッセージ受信のイベントコールバック
    onMissCustomCmdMsg カスタムメッセージ消失のイベントコールバック
    onRecvSEIMsg SEIメッセージ受信のコールバック

    CDN関連イベントコールバック

    API 説明
    onStartPublishing Tencent Cloud CSS CDNへのオーディオビデオストリーミングのイベントコールバックの公開を開始
    onStopPublishing Tencent Cloud CSS CDNへのオーディオビデオストリーミングの公開停止のイベントコールバック
    onStartPublishCDNStream 非Tencent Cloud CDNへのオーディオビデオストリーミングのイベントコールバックの公開を開始
    onStopPublishCDNStream 非Tencent Cloud CDNへのオーディオビデオストリーミングの公開停止のイベントコールバック
    onSetMixTranscodingConfig クラウドミクスストリーミングのレイアウトおよびトランスコードパラメータ設定のイベントコールバック

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

    API 説明
    onScreenCaptureStarted 画面共有開始のイベントコールバック
    onScreenCapturePaused 画面共有一時停止のイベントコールバック
    onScreenCaptureResumed 画面共有再開のイベントコールバック
    onScreenCaptureStoped 画面共有停止のイベントコールバック
    onScreenCaptureCovered 画面共有のターゲットウィンドウブロックのイベントコールバック(Windows OSのみに適用)

    ローカルレコーディングおよびローカルスクリーンキャプチャのイベントコールバック

    API 説明
    onLocalRecordBegin ローカルレコーディングタスク開始済みのイベントコールバック
    onLocalRecording ローカルレコーディングタスク実行中の進捗のイベントコールバック
    onLocalRecordComplete ローカルレコーディングタスク完了済みのイベントコールバック
    onSnapshotComplete ローカルスクリーンキャプチャ完了のイベントコールバック

    破棄されたイベントコールバック

    API 説明
    onUserEnter キャスターが現在のルームに入室(破棄済み)
    onUserExit キャスターが現在のルームを退室(破棄済み)
    onAudioEffectFinished オーディオエフェクト再生が完了済み(破棄済み)
    onPlayBGMBegin BGMの再生を開始(破棄済み)
    onPlayBGMProgress BGMの再生進捗のコールバック(破棄済み)
    onPlayBGMComplete BGMの再生が完了済み(破棄済み)

    ビデオデータカスタムコールバック

    API 説明
    onRenderVideoFrame カスタムビデオレンダリングのコールバック
    onProcessVideoFrame サードパーティによる美顔コンポーネントを結合するためのビデオ処理のコールバック

    オーディオデータカスタムコールバック

    API 説明
    onCapturedRawAudioFrame ローカルマイクがキャプチャしたオリジナルオーディオデータのコールバック
    onLocalProcessedAudioFrame ローカルがキャプチャし、オーディオモジュールで前処理したオーディオデータのコールバック
    onPlayAudioFrame 音声ミキシング前のリモートユーザーごとのオーディオデータ
    onMixedPlayAudioFrame 各再生待ちオーディオをミキシングし、最終的にシステムに送信して再生する前のデータコールバック

    その他イベントコールバックインターフェース

    API 説明
    onLog ローカルLOGのプリントコールバック

    ビデオ関連列挙値の定義

    API 説明
    TRTCVideoResolution ビデオ解像度
    TRTCVideoResolutionMode ビデオアスペクト比モード
    TRTCVideoStreamType ビデオストリームタイプ
    TRTCVideoFillMode ビデオ画面塗りつぶしモード
    TRTCVideoRotation ビデオ画面回転方向
    TRTCBeautyStyle 美顔(美肌)アルゴリズム
    TRTCVideoPixelFormat ビデオピクセル形式
    TRTCVideoBufferType ビデオデータ伝達方式
    TRTCVideoMirrorType ビデオのイメージタイプ
    TRTCSnapshotSourceType ローカルビデオスクリーンキャプチャのデータソース

    ネットワーク関連列挙値の定義

    API 説明
    TRTCAppScene ユースケース
    TRTCRoleType ロール
    TRTCQosControlMode トラフィックコントロールモード(破棄済み)
    TRTCVideoQosPreference 画質の好み
    TRTCQualityInfo ネットワーク品質
    TRTCAVStatusType ビデオステータスタイプ
    TRTCAVStatusChangeReason ビデオステータス変更理由のタイプ

    オーディオ関連列挙値の定義

    API 説明
    TRTCAudioQuality 音声音質

    その他列挙値の定義

    API 説明
    TRTCLogLevel Logレベル
    TRTCScreenCaptureSourceType 画面共有のターゲットタイプ(デスクトップのみに適用)
    TRTCTranscodingConfigMode クラウドミクスストリーミングのレイアウトモード
    TRTCLocalRecordType メディアレコーディングタイプ
    TRTCMixInputType ミクスストリーミング入力タイプ
    TRTCDeviceType デバイスタイプ(デスクトッププラットフォームのみに適用)
    TRTCAudioRecordingContent オーディオレコーディングコンテンツタイプ

    TRTCコアタイプの定義

    API 説明
    TRTCParams 入室パラメータ
    TRTCVideoEncParam ビデオコーデックパラメータ
    TRTCNetworkQosParam ネットワークトラフィックコントロール(Qos)パラメータセット
    TRTCRenderParams ビデオ画面のレンダリングパラメータ
    TRTCQualityInfo ネットワーク品質
    TRTCVolumeInfo 音量レベル
    TRTCSpeedTestResult ネットワークスピードテスト結果
    TRTCVideoFrame ビデオフレーム情報
    TRTCAudioFrame オーディオフレームデータ
    TRTCMixUser クラウドミクスストリーミングにおける各画面の説明情報
    TRTCTranscodingConfig クラウドミクスストリーミングのレイアウトおよびトランスコードパラメータ
    TRTCPublishCDNParam 非Tencent Cloud CDNへのオーディオビデオストリーミングの公開時に設定が必要な転送パラメータ
    TRTCAudioRecordingParams ローカルオーディオファイルのレコーディングパラメータ
    TRTCLocalRecordingParams ローカルメディアファイルのレコーディングパラメータ
    TRTCAudioEffectParam オーディオエフェクトパラメータ(破棄済み)
    TRTCSwitchRoomConfig ルーム切り替えパラメータ
    TRTCScreenCaptureSourceInfo 画面共有のターゲット情報(デスクトップのみに適用)