クラウドレコーディングと再生の実現

[TRTCコンソール]にログインして、左側のナビゲーションバーで【アプリケーション管理】を選択します。
ターゲットアプリケーションが所在する行の【機能設定】をクリックして、機能設定ページカードに進みます。アプリケーションを作成したことがない場合は、【アプリケーションの作成】をクリックしてアプリケーション名を入力し、【OK】をクリックして新しいアプリケーションを作成します。
【クラウドレコーディングの起動】の右側のをクリックすると、クラウドレコーディング設定ページ画面がポップアップされます。

レコーディング形式の選択

TRTCのクラウドレコーディングサービスは、「Global Auto-Recording」および「指定ユーザーレコーディング」という2種類の異なるレコーディング形式を提供しています。

Global Auto-Recording
各TRTCルームの各ユーザーのアップストリームのオーディオとビデオは自動的にレコーディングされます。レコーディングタスクの開始と停止は自動的に行われるため、心配する必要はありません。操作は比較的シンプルで使いやすいです。具体的な使用方法については、方法1：Global Auto-Recordingをご参照ください。
指定ユーザーレコーディング
一部ユーザーのオーディオ・ビデオストリーミングのみをレコーディングするように指定できます。これには、クライアントのSDKAPIまたはサーバーのRESTAPIを介して制御する必要があり、追加の開発作業が必要になります。具体的な使用方法については、方法2：指定ユーザーレコーディング（SDK API）および方法3：指定ユーザーレコーディング（REST API）をご参照ください。

ファイルのフォーマットの選択

クラウドレコーディングでは、HLS、MP4、FLV 、AACという4種類の異なるファイルフォーマットをサポートしています。4種類のフォーマットの違いと適用ケースを表形式でリストアップしているので、ご自分の業務のニーズに合わせて選択することができます。

パラメータ	パラメータ説明
ファイルタイプ	以下のファイルタイプをサポートします。 HLS：このファイルタイプは、ほとんどのブラウザのオンライン再生をサポートしており、ビデオの再生シーンに適しています。このファイルタイプを選択したときは、ブレークポイントでの連続レコーディングをサポートし、単一ファイルの最大時間が制限されません。 FLV：このファイルタイプは、ブラウザでのオンライン再生をサポートしていませんが、フォーマットはシンプルでフォールトトレラント性に優れています。レコーディングしたファイルをVODプラットフォームに保存する必要がない場合は、このファイルタイプを選択し、レコーディングが完了したらすぐにレコーディングファイルをダウンロードして、ソースファイルを削除できます。 MP4：このファイルタイプはWebブラウザのオンライン再生をサポートしていますが、このフォーマットのフォールトトレラント性は劣ります。ビデオ通話のプロセスでは、どのようなパケットロスが生じても、レコーディングファイルの再生画質に影響します。 AAC：オーディオレコーディングだけ必要な場合は、このファイルタイプを選択しても構いません。
1ファイルの最大時間（分）	実際の業務ニーズに応じて、1ビデオファイルの最大時間制限を設定できます。制限時間を超過すると、システムはビデオファイルを自動的に分単位で分割します。数値範囲は1～120です。この【ファイルタイプ】を【HLS】に設定するとき、1ファイルの最大時間を制限しなければ、そのパラメータは無効になります。
ファイル保存時間（日）	実際の業務ニーズに応じて、ビデオファイルをVODプラットフォームの日数の間保存します。日数単位で数値範囲は0～1500。期限後は、ファイルはVODプラットフォームによって自動的に削除され、回復できなくなります。 0は永久保存を表します。
連続レコーディングタイムアウト（秒）	デフォルトでは、通話（またはライブストリーミング）プロセスが、ネットワークの変動またはその他の原因によって切断された場合、レコーディングファイルは複数のファイルに分割されます。「1回の通話（またはライブストリーミング）で1つしか再生リンクが生成されない」ようにしたい場合は、実情に応じて連続レコーディングタイムアウト時間を設定できます。切断間隔が設定した連続レコーディングタイムアウト時間を超えない場合、1回の通話（またはライブストリーミング）で1ファイルしか生成されません。ただし、レコーディングファイルは連続レコーディング時間がタイムアウトしてからでなければ受信できません。単位は秒で、数値範囲は1～1800です。0は、ブレークポイント後にレコーディングが再開されないことを表します。

説明：

HLSは最長で30分間の連続レコーディングをサポートしており、「1講義に1つしか再生リンクが生成されないように」することができます。また、ほとんどのブラウザのオンライン視聴をサポートしており、eラーニングにおけるビデオ再生のユースケースに大変適しています。

保存場所の選択

TRTCクラウドレコーディングファイルは、デフォルトではTencent Cloud VODサーバーに保存されます。プロジェクトで多くの業務が一つのTencent Cloud VODアカウントを共有している場合、レコーディングファイルの隔離が必要になることがあります。Tencent Cloud VODの「サブアプリ」機能によって、TRTCのレコーディングファイルをその他の業務エリアと切り離すことができます。

VODのメインアプリとサブアプリとは何ですか。
メインアプリとサブアプリとは、VODの1種類のリソース分割方式です。メインアプリはVODのメインアカウントに相当し、サブアプリは複数作成できます。各サブアプリは、ルートアカウント下の1個のサブアカウントに相当し、独立したリソース管理を備えています。ストレージ領域では、その他のサブアプリと相互に隔離することができます。
VODサービスのサブアプリケーションを有効にする方法とは。
ドキュメント「VODサブアプリケーションを有効にする方法」にもとづき、新規サブアプリケーションを追加することができます。このステップではVODコンソールに移動して操作する必要があります。

レコーディングコールバックの設定

レコーディングコールバックアドレス：
新しいファイルのランディング通知をリアルタイムで受信する必要がある場合は、サーバーがレコーディングファイルのコールバックを受け取るアドレスをここに入力できます。このアドレスは、HTTP（またはHTTPS）プロトコルに適合する必要があります。新しいレコーディングファイルが生成されたら、Tencent Cloudはこのアドレスを介して、サーバーに通知を送信します。
レコーディングコールバックキー：
コールバックキーは、コールバックイベントの受信時に署名認証を生成するために使用します。このキーはアルファベットの大文字・小文字と数字で構成し、32文字を超えないようにしてください。使用については、レコーディングイベントパラメータの説明をご参照ください。

説明：

詳細なレコーディングコールバックの受信と解読方法については、ドキュメント後半部分のレコーディングファイルの受け取りをご参照ください。

レコーディングの制御方法

TRTCでは、Global Auto-Recording、指定ユーザーレコーディング（SDK APIによる制御）、指定ユーザーレコーディング（REST APIによる制御）という3種類のクラウドレコーディング制御方法を提供しています。これらの方法を一つずつ、詳しくご紹介します。

コンソールでこの方式の使用設定をする方法とは。
レコーディングタスクを開始する方法とは。
レコーディングタスクを終了する方法とは。
ルームのマルチチャネル画面を1チャネルにミックスする方法とは。
レコーディングしたファイルをどのように命名しますか。
この方法をサポートするプラットフォームには何がありますか。

方法1：Global Auto-Recording

コンソールでの設定
このレコーディング方法を使用したい場合は、コンソールのレコーディング形式の選択で「Global Auto-Recording」に設定してください。
レコーディングタスクの開始
TRTCルームの各ユーザーのオーディオ・ビデオストリーミングは、すべてファイルに自動レコーディングされるので、追加の操作は必要ありません。
レコーディングタスクの終了
自動停止。各キャスターがオーディオ・ビデオのアップストリームを停止すると、このキャスターのクラウドレコーディングは自動的に停止します。ファイルフォーマットの選択のときに「連続レコーディング時間」を設定すると、レコーディングファイルを受信する前に、連続レコーディング時間がタイムアウトするのを待つ必要が出てきます。
マルチ画面のミックス
Global Auto-Recordingモードでのクラウドミクスストリーミングには、「サーバーREST API方式」と「クライアントSDK API方式」という2つの方式があります。この2つの方式を混合して使用しないでください。
- サーバーREST APIミクスストリーミング方式：お客様のサーバーからAPI呼び出しを起動する必要があります。クライアントのプラットフォームバージョンの制限は受けません。
- クライアントSDK APIミクスストリーミング方式：直接クライアントからミクスストリーミングを開始できます。現在サポートしているのは、iOS、Android、Windows、Mac、Electronなどのプラットフォームであり、WeChat Mini ProgramおよびWebブラウザは現在サポートしていません。
レコーディングファイルの命名
- キャスターが入室時に userDefineRecordId パラメータを指定した場合、レコーディングファイルは userDefineRecordId_streamType_開始時刻_終了時刻 で命名されます（streamTypeにはmainおよびauxの2つの値があり、mainはメインパスを、auxはサブパスを表します。サブパスは通常、画面共有に利用されます）。
- キャスターが入室時に userDefineRecordId パラメータを指定していなかったが、 streamId パラメータを指定していた場合は、レコーディングファイルはstreamId_開始時刻_終了時刻 で命名されます。
- キャスターが入室時に userDefineRecordId パラメータ、 streamId パラメータをいずれも指定していない場合は、レコーディングファイルは sdkappid_roomid_userid_streamType_開始時刻_終了時刻 で命名されます（streamTypeにはmainおよびauxの2つの値があり、mainはメインパスを、auxはサブパスを表します。サブパスは通常、画面共有に利用されます）。
サポート済みのプラットフォーム
お客様側のサーバーで制御し、クライアント側プラットフォームの制限は受けません。

方法2：指定ユーザーレコーディング（SDK API）

TRTC SDKが提供するいくつかのAPIインターフェースとパラメータを呼び出すことで、クラウドミクスストリーミング、クラウドレコーディング、Relayed live streamingという3つの機能が実装可能です。

クラウド機能	開始方法とは。	停止方法とは。
クラウドレコーディング	入室時にパラメータ`TRTCParams`の中の`userDefineRecordId`フィールドを指定します	キャスター退室時に自動停止します
クラウドミクスストリーミング	SDK API setMixTranscodingConfig() を呼び出してクラウドミクスストリーミングを起動	クラウドミクスを発出したキャスターが退室したら、ミクスストリーミングは自動的に停止するか、途中で setMixTranscodingConfig() を呼び出してパラメータを `null/nil` 手動停止に設定します
Relayed live streaming	入室時にパラメータ`TRTCParams`の中の`streamId`フィールドを指定します	キャスター退室時に自動停止します

コンソールでの設定
このレコーディング方法を使用したい場合は、コンソールのレコーディング形式の選択のときに、「指定ユーザーレコーディング」に設定してください。

レコーディングタスクの開始
キャスターが入室時に入室パラメータ TRTCParams の userDefineRecordId フィールドを指定すると、その後、同キャスターのアップストリームのオーディオ・ビデオデータがクラウドレコーディングされます。このパラメータを指定していないキャスターはレコーディングタスクを起動することはありません。

// サンプルコード：レコーディングユーザーrexchangのオーディオ・ビデオストリーミングを指定し、ファイルidを1001_rexchangにします
TRTCCloud *trtcCloud = [TRTCCloud sharedInstance];
TRTCParams *param = [[TRTCParams alloc] init];
param.sdkAppId = 1400000123;     // TRTCのSDKAppIDは、アプリケーション作成後に取得できます
param.roomId   = 1001;           // ルームナンバー
param.userId   = @"rexchang";    // ユーザー名
param.userSig  = @"xxxxxxxx";    // ログイン署名
param.role     = TRTCRoleAnchor; // ロール：キャスター
param.userDefineRecordId = @"1001_rexchang";  // レコーディングID。そのユーザーのレコーディング開始を指定します。
[trtcCloud enterRoom:params appScene:TRTCAppSceneLIVE]; // LIVEモードを使用してください

レコーディングタスクの終了
自動停止。入室時にuserDefineRecordIdパラメータのキャスターを指定してオーディオ・ビデオのアップストリームを停止すると、クラウドレコーディングは自動的に停止します。ファイルフォーマットの選択のときに「連続レコーディング時間」を設定すると、レコーディングファイルを受信する前に、連続レコーディング時間がタイムアウトするのを待つ必要が出てきます。
マルチ画面のミックス
SDK APIsetMixTranscodingConfig()を呼び出すことによって、ルーム内の他のユーザーの画面や音声をカレントユーザーのチャネルのオーディオ・ビデオストリーミングにミックスすることができます。この部分の詳細については、次のドキュメントCloud MixTranscodingをご参照ください。

注意：

1つのTRTCルーム内では、1人のキャスター（配信を開始したキャスターを推奨）のみがsetMixTranscodingConfigを呼び出せばOKです。複数のキャスターが呼び出すと、ステータスの混乱を生じて、エラーが起きる可能性があります。
レコーディングファイルの命名
レコーディングファイルは、userDefineRecordId_開始時間_終了時間 のフォーマットで命名されます。
サポート済みのプラットフォーム
iOS、Android、Windows、Mac、Electronなどの端末でレコーディング制御の開始をサポートしていますが、現時点ではWeChat Mini ProgramおよびWebブラウザからの制御はサポートしていません。

方法3：指定ユーザーレコーディング（REST API）

TRTCのサーバーはREST APIのペア（ StartMCUMixTranscodeおよびStopMCUMixTranscode）を提供し、クラウドミクスストリーミング、クラウドレコーディング、Relayed live streamingという3つの機能を実装するために使用します。

クラウド機能	開始方法とは。	停止方法とは。
クラウドレコーディング	StartMCUMixTranscodeを呼び出す時に、`OutputParams.RecordId`パラメータを指定すれば、レコーディングを開始できます	自動停止、または途中でStopMCUMixTranscodeを呼び出して停止します
クラウドミクスストリーミング	StartMCUMixTranscodeを呼び出す時に`LayoutParams` パラメータを指定すれば、レイアウトテンプレートとレイアウトパラメータを設定できます	全ユーザーが退室した後自動停止、または途中でStopMCUMixTranscodeを呼び出して手動停止します
Relayed live streaming	StartMCUMixTranscodeを呼び出す時に`OutputParams.StreamId`パラメータを指定すれば、CDNへのRelayed live streamingを起動できます	自動停止、または途中でStopMCUMixTranscode を呼び出して停止します

説明：

これらのREST APIに対する制御は、TRTCクラウドサービスの中のコアのミクスストリーミングモジュール（MCU）となり、MCU ミクスストリーミング後の結果はレコーディングシステムとライブCDNに送信されるため、APIの名前を Start/StopMCUMixTranscodeとしています。このため、機能の点からいうと、Start/StopMCUMixTranscode はミクスストリーミングの機能を実装できるだけでなく、クラウドレコーディングとRelayed live streaming CDNの機能も実装できます。

コンソールでの設定
このレコーディング方法を使用したい場合は、コンソールのレコーディング形式の選択のときに、「指定ユーザーレコーディング」に設定してください。

レコーディングタスクの開始
サーバーからStartMCUMixTranscodeを呼び出して、OutputParams.RecordIdパラメータを指定すると、ミクスストリーミングおよびレコーディングを起動することができます。

// コードサンプル： REST APIによってクラウドミクスストリーミングおよびクラウドレコーディングのタスクを起動します
https://trtc.tencentcloudapi.com/?Action=StartMCUMixTranscode
&SdkAppId=1400000123
&RoomId=1001
&OutputParams.RecordId=1400000123_room1001
&OutputParams.RecordAudioOnly=0
&EncodeParams.VideoWidth=1280
&EncodeParams.VideoHeight=720
&EncodeParams.VideoBitrate=1560
&EncodeParams.VideoFramerate=15
&EncodeParams.VideoGop=3
&EncodeParams.BackgroundColor=0
&EncodeParams.AudioSampleRate=48000
&EncodeParams.AudioBitrate=64
&EncodeParams.AudioChannels=2
&LayoutParams.Template=1
&<パブリックリクエストパラメータ>

注意：

このREST APIは、ルーム内の少なくとも1人のユーザーが入室（enterRoom）に成功した場合に有効になります。

REST APIを使用すると、シングルストリームのレコーディングはサポートされません。シングルストリームをレコーディングしたい場合は、方法1または方法2を選択してください。

レコーディングタスクの終了
自動停止。途中でStopMCUMixTranscodeを呼び出してミクスストリーミングおよびレコーディングタスクを停止することもできます。
マルチ画面のミックス
StartMCUMixTranscodeを呼び出す時に、同時に LayoutParams パラメータを指定すれば、クラウドミクスストリーミングを実装できます。このAPIは、ライブストリーミング全時間内での複数回呼び出しをサポートしていますので、必要に応じて LayoutParams パラメータを修正し、このAPIを再度呼び出して合成画面のレイアウトを調整することができます。ただし、注意が必要なのは、パラメータ OutputParams.RecordId と OutputParams.StreamIdが複数回呼び出しの中で一致性を維持する必要があることです。そうしない場合、ストリームが切断され、複数のレコーディングファイルが生成されてしまいます。

説明：

クラウドミクスストリーミングのより詳しい紹介については、Cloud MixTranscodingをご参照ください。

レコーディングファイルの命名
レコーディングファイルは、StartMCUMixTranscode を呼び出すときに指定したOutputParams.RecordIdパラメータで命名します。命名フォーマットは、OutputParams.RecordId_開始時間_終了時間です。
サポート済みのプラットフォーム
お客様側のサーバーで制御し、クライアント側プラットフォームの制限は受けません。

レコーディングファイルの検索

レコーディング機能を起動させた後、TRTCシステムからレコーディングしたファイルは、Tencent CloudのVODサーバーから探し出せます。VODコンソールから手動で直接探し出したり、バックエンドサーバーからREST APIを使用して所定の時間にフィルタリングを行うこともできます。

方法1：VODコンソールで手動で検索

VODコンソールにログインし、左側ナビゲーションバーで【メディア資産管理】を選択します。
リスト上側の【プレフィックス検索】をクリックして【プレフィックス検索】を選択し、検索ボックスにキーワードを入力します。例えば、1400000123_1001_rexchang_mainの場合、をクリックすると、ビデオ名のプレフィックスに一致するビデオファイルが表示されます。
作成時間に基づき、必要なターゲットファイルをフィルタリングすることができます。

方法2：VOD REST APIによる検索

Tencent CloudのVODシステムは、一連のREST APIを提供してその上のオーディオ・ビデオファイルを管理します。メディア情報検索のこのREST APIによって、VODシステム上のファイルを検索します。パラメータ表のTextパラメータをリクエストすることで、あいまい一致や、StreamIdパラメータをもとに正確な検索を行うこともできます。
RESTリクエスト例：

https://vod.tencentcloudapi.com/?Action=SearchMedia
&StreamId=stream1001
&Sort.Field=CreateTime
&Sort.Order=Desc
&<パブリックリクエストパラメータ>

レコーディングファイルの受け取り

レコーディングファイルの検索のほかにも、コールバックアドレスを設定することによって、Tencent Cloudに新たにレコーディングしたファイル情報をサーバーに自動的にプッシュさせることもできます。
ルームの最後の1チャネルのオーディオ・ビデオストリーミングが終了すると、Tencent Cloudはレコーディングを終了し、ファイルをVODプラットフォームに転送して保存します。このプロセスには、デフォルトで約30秒から2分かかります（連続レコーディング時間を300秒に設定した場合、待ち時間はデフォルトの時間に300秒を加えた時間になります）。転送と保存が完了すると、Tencent Cloudはレコーディングコールバック設定で設定したコールバックアドレス（HTTP/HTTPS）を介してサーバーに通知を送信します。

Tencent Cloudは、レコーディングおよびレコーディング関連のイベントを、設定したコールバックアドレスを介して、サーバーにプッシュします。コールバックメッセージの例を次の図に示します。

下表のフィールドによって、現在のコールバックがどの通話（またはCSS）に対応するかを確定することができます。

番号	フィールド名	説明
	event_type	メッセージタイプ。event_typeが100のときは、このコールバックメッセージが、レコーディングファイルが生成したメッセージであることを表します。
	stream_id	ライブCDNのstreamIdです。入室時にTRTCParamsのstreamIdフィールドを設定することで指定でき（推奨）、また、TRTCCloudのstartPublishingを呼び出すときにパラメータstreamIdで指定することもできます。
	stream_param.userid	ユーザー名のBase64コード。
	stream_param.userdefinerecordid	カスタムフィールド。 TRTCParams の userDefineRecordId フィールドを設定することで指定できます。
	video_url	レコーディングファイルの視聴アドレスは、VOD再生に使用できます。

説明：

コールバックフィールドに関するその他の説明については、CSS-レコーディングイベントの通知をご参照ください。

レコーディングファイルの削除

Tencent CloudのVODシステムは、一連のシステムREST APIを提供して、その上のオーディオ・ビデオファイルを管理します。メディアAPIの削除によって任意の指定したファイルを削除することができます。
RESTリクエスト例：

https://vod.tencentcloudapi.com/?Action=DeleteMedia
&FileId=52858907988664150587
&<パブリックリクエストパラメータ>

レコーディングファイルの再生

オンライン教育などのユースケースでは、通常CSSが終了後、何度もレコーディングファイルを再生し、教育リソースを十分に活用しやすくする必要があります。

ファイルフォーマットの選択（HLS）

レコーディングフォーマットの設定では、ファイルフォーマットをHLSに選択します。
HLSは最長30分間のブレークポイントでの連続レコーディングをサポートしており、「1つのライブストリーミング（または1回の授業）で1つしか再生リンクが生成されないように」することができます。また、HLSファイルは、ほとんどのブラウザのオンライン再生をサポートしており、ビデオ再生のユースケースに大変適しています。

VODアドレス（video_url）の取得

レコーディングファイルの受け取りのときに、コールバック情報のvideo_urlフィールドを取得できます。このフィールドは、現在のレコーディングファイルのTencent CloudにおけるVODアドレスになります。

VODプレーヤーとの接続

使用するプラットフォームに基づいてVODプレーヤーと接続します。具体的な操作は以下をご参照ください。

注意：

プロフェッショナル版TRTC SDKの使用を推奨します。プロフェッショナル版には Super Player（Player+）、モバイルライブストリーミングなどの機能が統合され、基盤モジュールを高度に再利用することにより、プロフェッショナル版の容量増加は同時に2つの独立したSDKを統合させたよりも小さくなっています。さらにシンボル重複（symbol duplicate）の問題も回避できます。

Recent Pages