クラウドレコーディング（TUICallKit）

Recent Pages

クラウドレコーディング（TUICallKit）

最終更新日:2024-07-19 14:53:21

ここではTUICallKitのクラウドレコーディングを起動し、重要な通話の保存、審査などに役立てる方法についてご説明します。自動レコーディングソリューションとREST APIレコーディングソリューションという2つのソリューションをご用意しています。
説明：
TUICallKitはTencent Cloudの基本的なPaaSサービスを複数統合しています。このうち、オーディオビデオ関連機能はTRTCに依存しています。このためTUICallKitのクラウドレコーディング機能はTRTCコンソールで設定する必要があります。
方法1：自動レコーディングソリューション（推奨）
自動レコーディングソリューションの使用を推奨します。業務側でレコーディングを起動および停止する必要がなく、レコーディングタスクはTencent Cloud TRTCバックエンドが管理します。通話中にオーディオビデオストリームのアップストリームがあれば自動的にレコーディングし、スピーディーかつ簡単にアクセスできます。次のいくつかの手順で完成させることができます。 
1. TRTCコンソール > アプリケーション管理でSDKAppIdに対応するアプリケーションを見つけ、機能設定ページに進みます。
2. 機能設定ページでクラウドレコーディング設定のカードを確認できます。クラウドレコーディング機能を有効にした後、Global Auto-Recordingテンプレートの作成をクリックします。
﻿
﻿
3. オーディオビデオ通話の業務シナリオ（1v1通話、グループ通話）に応じて、次のようにパラメータを設定することを推奨しますが、ご自身の業務ニーズに応じてカスタムレコーディングテンプレートを設定することも可能です。
﻿
﻿
ご注意：
グローバルレコーディングがサポートする最大ミクスストリーミング人数は8人です。通話人数が8人を超える場合（自分を含めて）、最後のユーザーのストリームはレコーディングされません。
Global Auto-Recording機能を有効にすると、通話応答後かつオーディオビデオアップストリームが存在する場合にレコーディングタスクの自動起動がトリガーされ、通話終了後に自動的にレコーディングが停止します。ネットワークまたはその他の異常によって退室になった場合、ご自身の設定したMaxIdleTime値（アイドル状態の待機時間。デフォルトでは5秒）に基づいてバックエンドが自動的にレコーディングタスクを停止し、それ以上の料金ロスが発生しないようにします。
4. テンプレートの作成が完了した後、Global Auto-Recordingにチェックを入れれば完了です。
方法2：REST APIレコーディングソリューション
自動レコーディングソリューションで業務ニーズを満たせない場合は、よりフレキシブルなREST APIレコーディングソリューションを使用することもできます。レコーディングサブスクリプションルーム内のキャスターの指定、ミクスストリーミングレイアウトのカスタマイズ、レコーディング中のレイアウトおよびサブスクリプション更新などが可能ですが、業務バックエンドサービスとの組み合わせが必要で、接続がより複雑になり、機能は強力になります。重要な手順は次のとおりです。
1. TRTCコンソール > アプリケーション管理でSDKAppIdに対応するアプリケーションを見つけ、機能設定ページに進みます。
2. 機能設定ページでクラウドレコーディング設定のカードを確認できます。クラウドレコーディング機能を有効にすると、この時点でレコーディングを手動でカスタマイズ、すなわちREST APIモードにデフォルトでチェックが入っています。
﻿
﻿
3. その後、REST API（CreateCloudRecording）を呼び出してクラウドレコーディングを起動することができます。ここではTUICallObserverの通知イベントを監視することで、オーディオビデオ通話の開始時にレコーディングを起動できるようにすることをお勧めします。Javaコードの例を挙げます。
TUICallEngine.createInstance(context).addObserver(new TUICallObserver() {
    @Override
    public void onCallBegin(TUICommonDefine.RoomId roomId, TUICallDefine.MediaType callMediaType, TUICallDefine.Role callRole) {
        // REST APIを使用してレコーディングタスクを起動することを業務バックエンドに通知します。
    }
});
4. クライアントにネットワーク不良、プロセスキルなどが発生して通話が異常終了する可能性を考慮し、レコーディング終了の方法については、TRTCルームステータスのコールバック（詳細についてはサーバーイベントコールバックの監視をご参照ください）をサブスクライブし、TRTCルームのステータスが解散となったコールバックを受信した時点でREST API （DeleteCloudRecording）を呼び出してクラウドのレコーディングタスクを停止するようにすることをお勧めします。
よくあるご質問
1. レコーディング時間の明細を確認するにはどうすればよいですか。
TRTCコンソール > クラウドレコーディングでレコーディングの時間明細を確認できます。
2. レコーディングしたファイルを確認するにはどうすればよいですか。
VODコンソールにログインし、左側ナビゲーションバーでメディア資産管理を選択し、リスト上方のプレフィックス検索をクリックしてプレフィックス検索を選択し、検索ボックスにキーワードを入力します。レコーディングファイルの命名ルールは次のとおりです。
シングルストリーミングレコーディングMP4ファイル名のルール： <SdkAppId>_<RoomId>_UserId_s_<UserId>_UserId_e_<MediaId>_<Index>.mp4
ミクスストリーミングレコーディングMP4ファイル名のルール： <SdkAppId>_<RoomId>_<Index>.mp4