COSに保存
最終更新日:2025-11-12 15:39:28
CSSは、ライブストリーミングの画面をレコーディングし、レコーディングファイルをVODまたはCOSに保存する機能を提供します。本書では、レコーディングファイルをCOSに保存する方法を説明します。
注意事項
1.レコーディングしたビデオをCOSコンソールに保存するには、COSサービスをアクティブ化しておくこと、また、ストレージ業務が支払い延滞によって停止することを防ぐために、ストレージ容量パックを事前に購入することをお勧めします。詳しくは、COSクイックスタートをご参照ください。
2.レコーディング機能を有効にした後、COSサービスが正常な使用状態にあることを確認してください。COSサービスの非アクティブ状態またはアカウントの支払い延滞によりサービス停止になるなどが起きた場合、ライブストリーミングに影響し、レコーディングができなくなります。この間はレコーディングファイルとレコーディング料金は発生しません。
3.ライブストリーミング中に、レコーディングが終了して約5分後に該当する時間帯のファイルを取得できます。例えば、あるライブストリーミングに対して12:00からレコーディングを開始し、12:30にレコーディングを終了とした場合、約12:35に12:00～12:30の映像を取得できます。
4.レコーディングテンプレートを正常に作成した後、プッシュドメイン名でバインドすることができます。関連するドキュメントはレコーディング設定をご参照ください。バインドが完了して約5分～10分後に反映されます。
5.ミクスストリーミングのレコーディングは、レコーディングファイルエラーが発生し、視聴とプレイバックに支障が出るため、中国大陸とグローバル/中国香港・マカオ・台湾のライブミクスストリーミングをサポートしません。
6.レコーディング後にストレージ機能を使用するには、COSのAPI権限が必要なので、レコーディングファイルの保存に失敗しないように、ストレージ機能を使用する前にCSSへ権限を付与していることを確認してください。権限回収によって保存に失敗した場合、ビデオを復元できません。権限については、CSSにCOSへのアクセス権限を付与しレコーディングの保存を実装することをご参照ください。
7.レコーディングタスクをリクエストする時、レコーディングテンプレートを指定しなかった場合、レコーティングファイルはデフォルトではVODに保存されます。
前提条件
Tencent CSSサービスをアクティブ化し、プッシュドメイン名を追加していること。
COSサービスをアクティブ化していること。
レコーディングテンプレートの作成
1. CSSコンソールにログインし、機能設定>ライブブロードキャストレコーディングに進みます。
2. ライブブロードキャストレコーディングで「レコーディングファイルをCOSに保存」を選択します。
3. レコーディングテンプレート作成をクリックし、以下のようにテンプレートの情報を設定します。
設定項目 | 設定の説明 | |
テンプレート名 | | ライブブロードキャストレコーディングテンプレート名。カスタマイズ可能です（中国語、英語、数字、「_」、「-」のみ対応）。 |
テンプレートの説明 | | ライブブロードキャストレコーディングテンプレートの説明。カスタマイズ可能です（中国語、英語、数字、「_」、「-」のみ対応）。 |
コンテンツのレコーディング | オリジナルストリームのレコーディング | この設定を選択すると、CSSストリームをトランスコーディング（トランスコーディング、ウォーターマーク追加、ミックスストリーミングを含む）する前にレコーディングを行います。レコーディングされたビデオにはトランスコーディング、ウォーターマーク、ミクスストリーミングのエフェクトがありません。WebRTCを介してオリジナルストリームをレコーディングすると、オーディオが失われますので、他のレコーディングコンテンツを選択することをお勧めします。 |
| ウォーターマーク付きレコーディング | この設定を選択すると、ウォーターマークテンプレートに設定されたウォーターマークがライブストリーミングに追加された後にレコーディングされます。 |
| 指定されたトランスコードストリームのレコーディング | 指定されたトランスコードストリームのレコーディングをクリックすると、設定済みのトランスコーディングテンプレートを選択するか、テンプレート名をクリックしてトランスコーディングテンプレートの設定を変更できます。この設定を選択すると、ストリーミングプッシュ後にトランスコーディングテンプレートidで自動的にトランスコーディングをリクエストしてレコーディングを行います。トランスコーディングテンプレートが誤って削除された場合、ウォーターマークを付けてレコーディングします。 |
レコーディング形式 | | ビデオレコーディングの出力形式にはHLS、MP4、FLV、AACの4種類があります。そのうち、AACはオーディオのみのレコーディングです。 |
ご注意：
WebRTCストリーミングプッシュでオリジナルストリームをレコーディングするとき、オーディオが失われるため、他のレコーディングコンテンツを選択することを推奨します。
タイムシフトの運用シーンでは、トランスコードストリーミングのレコーディング機能は使用できません。レコーディングテンプレートにタイムシフトの設定が関連付けられている場合、オリジナルストリームでレコーディングされます。
指定されたトランスコードストリームのレコーディングにおいて、オーディオのみのトランスコードテンプレートを選択した場合、レコーディング形式はオーディオ形式のみ選択できます。
トランスコーディングストリームをレコーディングするには、トランスコーディングタスクをリクエストしておく必要がありますので、トランスコーディング料金が発生します。同一のトランスコーディングテンプレートを使用して再生する場合、重複して課金されません。
4. レコーディングコンテンツを選択し、必要なレコーディング形式にチェックを入れると、選択した形式の設定画面が表示され、1つまたは複数のレコーディング形式を同時に選択できます。以下のように設定してください：
設定項目 | 設定の説明 |
レコーディングファイルあたりの長さ（分） | HLS形式でレコーディングするファイル１つあたりのレコーディング時間は無制限です。レコーディング継続の待機時間を超えた場合、ファイルを新規作成し、レコーディングを継続します。 FLV形式でレコーディングするファイル1つあたりの長さは1分～720分です。 MP4またはAAC形式でレコーディングするファイル1つあたりの長さは1分～120分です。 |
レコーディング継続の待機時間（秒） | HLS形式のファイルのみ、プッシュ中断のレコーディング継続をサポートし、レコーディング継続の待機時間の設定範囲は1s～1800sです。 |
保存時間（日） | 永続保存または期間指定を選択できます。レコーディングファイル1つあたりの最大保存時間は1500日で、ファイル保存時間が0の場合は永久保存です。 |
ストレージパス | BucketでCOSに作成し権限を付与したCOS bucketを選択できます。 Regionは前述したBucketが所属するリージョンの情報で、変更不可です。 |
ディザーストリカバリーストレージパス | ディザーストリカバリーストレージパスを有効にできます。ネットワークジッターによってレコーディングファイルをメインストレージパスに保存できない場合、ファイルの紛失を防ぐために、ファイルはディザスタリカバリ用ストレージパスに保存されます。メインストレージパスが復元した後、ディザスタリカバリ用ストレージパス配下のレコーディングファイルは自動的にメインストレージパスに同期されます。マスタ/スレーブは同じRegionを選択することができません。 |
ストレージフォルダ | レコーディングストレージフォルダはデフォルトで{RecordSource}/{Domain}/{AppName}/{StreamID}/{RecordId}/{StartYear}-{StartMonth}-{StartDay}-{StartHour}-{StartMinute}-{StartSecond}で保存されます。そのうちの変数は以下の通りです。 {RecordSource}：レコーディング内容。オリジナルストリームの場合はoriginで、トランスコーディングストリームの場合はトランスコーディングテンプレートidです {StartYear}：開始時間-年 {StartMonth}：開始時間-月 {StartDay}：開始時間-日 {StartMinute}：開始時間-分 {StartSecond}：開始時間-秒 {Domain}：プッシュドメイン名 {AppName}：プッシュパス {StreamID}：ストリームID {RecordId}：レコーディングid。レコーディングルールとレコーディングタスクを区別します。レコーディングタスクの場合、タスクid（すなわち、CreateRecordの実行で返されたID）になります 「/」は階層関係を示し、「-」は一般的な文字です |
5. 保存をクリックして完了します。
説明：
ファイルのレコーディングはレコーディングしながら転送するため、アップロード前に終了時間を取得できず、さらにファイル名に終了時間を追加できません。
ドメイン名のバインド
1. CSSコンソールにログインし、機能設定>ライブブロードキャストレコーディング>レコーティングファイルをCOS保存」に進みます。
ドメイン名と直接バインド：左上にあるドメイン名のバインドをクリックします。
レコーディングテンプレート新規作成完了後にドメイン名とバインド：レコーディングテンプレートの作成が完了した後、プロンプトボックスの中のドメイン名のバインドへをクリックします。
2. ドメイン名バインドウィンドウで、バインドするレコーディングテンプレートおよびプッシュドメイン名を選択し、OKをクリックすればバインドが完了します。
説明：
追加をクリックして現在のテンプレートに複数のプッシュドメイン名をバインドする機能をサポートしています。
バインド解除
1. CSSコンソールにログインし、機能設定>ライブブロードキャストレコーディング>レコーティングファイルをCOS保存」に進みます。
2. すでにドメイン名にバインドされているレコーディングテンプレートを選択し、バインドを解除するドメイン名を選択して右側のバインド解除をクリックします。
3. 現在バインドされているドメイン名のバインドを解除するかを確認し、OKをクリックすればバインドが解除されます。
説明：
レコーディングテンプレートのバインド解除は、ライブストリーミング中のストリームには影響しません。
バインド解除を反映させるには、バインド解除後にストリームを切断しもう一度プッシュする必要があります。新しいライブストリーミングはレコーディングファイルが生成されなくなります。
テンプレートの変更
1. CSSコンソールにログインし、機能設定>ライブブロードキャストレコーディング>レコーティングファイルをCOS保存」に進みます。
2. 作成済みのレコーディングテンプレートを選択し、右側の編集をクリックして、テンプレートの情報を変更します。
3. 保存をクリックして完了します。
テンプレートの削除
1. CSSコンソールにログインし、機能設定>ライブブロードキャストレコーディング>レコーティングファイルをCOS保存」に進みます。
2. 作成済みのレコーディングテンプレートを選択し、右上の削除をクリックします。
3. 現在のレコーディングテンプレートを削除するかを確認し、OKをクリックすれば削除が完了します。
ご注意：
テンプレートがすでにバインドされている場合、バインドの解除を行ってから、削除を行ってください。
コンソールでドメイン名を使用しレコーディングテンプレートを管理しますので、バインドされたインターフェースで作成したルールを削除することはできません。レコーディング管理インターフェースのバインドによってストリームを指定している場合は、レコーディングルールの削除を呼び出して、バインドを解除する必要があります。
関連操作
レコーディングテンプレートをドメイン名でバインドとバインド解除する方法については、レコーディング設定をご参照ください。
フィードバック