ライブストリームのクリップを 1 つ以上の動画にマージするライブ編集ジョブを送信します。ライブ編集ジョブを送信すると、ジョブはバックグラウンドで非同期処理のためにキューに登録されます。ジョブ ID を指定して GetLiveEditingJob 操作を呼び出すことで、ジョブの状態を照会できます。また、生成されたメディアアセットのメディアアセット ID を指定して GetMediaInfo 操作を呼び出すことで、出力ファイルに関する情報を照会できます。
操作説明
ライブ編集は、Object Storage Service (OSS) および ApsaraVideo VOD に記録・保存されたライブストリームに対してサポートされています。1 つのジョブで複数のライブストリームを対象とする場合、混合編集が可能なのは同一アプリケーション内で記録されたストリームのみです。また、すべてのストリームは OSS または ApsaraVideo VOD のいずれか一方に一貫して記録されている必要があります。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ice:SubmitLiveEditingJob |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Clips |
string |
必須 |
JSON 配列形式で指定するクリップ情報。出力ファイルは、これらのクリップを順次マージすることで生成されます。 各クリップには開始時刻と終了時刻を指定します。ライブストリームのパラメーターが明示的に指定されていない場合、外側のライブストリーム構成が適用されます。開始時刻および終了時刻のタイムスタンプは協定世界時 (UTC) で指定してください。パラメーターの詳細については、本トピックの「Clip」セクションをご参照ください。 |
[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }] |
| ProjectId |
string |
任意 |
ライブ編集プロジェクトの ID。このパラメーターを指定すると、システムはプロジェクトのストレージ構成を読み込みます。このパラメーターを指定しない場合は、明示的に指定したストレージ構成が優先されます。 |
****fddd7748b58bf1d47e95**** |
| LiveStreamConfig |
string |
任意 |
ライブストリームの構成（JSON 形式）。以下のパラメーターを含める必要があります：
|
{ "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" } |
| OutputMediaConfig |
string |
任意 |
出力ファイルの構成（JSON 形式）。OSS の URL または ApsaraVideo VOD のストレージバケット内の保存場所を指定できます。
|
{ "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, 或 { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" } |
| MediaProduceConfig |
string |
任意 |
制作構成（JSON 形式）。Mode は編集モードを指定します。有効な値は以下のとおりです：
|
{ "Mode": "AccurateFast"} |
| UserData |
string |
任意 |
ユーザー定義データ（JSON 形式）。最大長は 512 バイトです。 |
{"key": "value"} |
| OutputMediaTarget |
string |
任意 |
出力ファイルの種別。有効な値は以下のとおりです：
|
oss-object |
Clip
| パラメーター | 型 | 例 | 説明 | 必須 |
| StartTime | 文字列 | 2021-06-21T08:01:00Z | キャプチャしたクリップの開始時刻。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）で指定し、協定世界時 (UTC) でなければなりません。 | はい |
| EndTime | 文字列 | 2021-06-21T08:05:00Z | キャプチャしたクリップの終了時刻。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）で指定し、協定世界時 (UTC) でなければなりません。 | はい |
| AppName | 文字列 | app | ライブストリームが属するアプリケーションの名前。このパラメーターを指定しない場合、外側のライブストリーム構成が適用されます。 | いいえ |
| DomainName | 文字列 | domain.com | ドメイン名。このパラメーターを指定しない場合、外側のライブストリーム構成が適用されます。 | いいえ |
| StreamName | 文字列 | stream | ライブストリームの名前。このパラメーターを指定しない場合、外側のライブストリーム構成が適用されます。 | いいえ |
| CoverTime | 文字列 | 2021-06-21T08:03:00Z | クリップ内のタイムスタンプ。このタイムスタンプの画像が出力ファイルのサムネイルとして使用されます。ISO 8601 標準（yyyy-MM-ddTHH:mm:ssZ 形式）で指定し、協定世界時 (UTC) でなければなりません。複数のクリップで CoverTime を指定した場合、最初に指定した 1 つだけが有効です。CoverTime は StartTime 以降かつ EndTime 以前である必要があります。 | いいえ |
| CoverUrl | 文字列 | https://test.oss-cn-shanghai.aliyuncs.com | サムネイルの出力 URL。OSS バケットは IMS が有効化されているリージョンと同じリージョンにある必要があります。自己管理型の OSS バケットのみがサポートされます。ApsaraVideo VOD が管理するバケットはサポートされません。 | いいえ |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| RequestId |
string |
リクエスト ID。 |
****36-3C1E-4417-BDB2-1E034F**** |
| ProjectId |
string |
ライブ編集プロジェクトの ID。 |
****fddd7748b58bf1d47e95**** |
| JobId |
string |
ライブ編集ジョブの ID。 |
****d80e4e4044975745c14b**** |
| MediaId |
string |
出力ファイルのメディアアセット ID。 |
****c469e944b5a856828dc2**** |
| MediaURL |
string |
出力ファイルの URL。 |
http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4 |
| VodMediaId |
string |
出力ファイルが ApsaraVideo VOD に保存されている場合の、ApsaraVideo VOD 内のメディアアセット ID。 |
****d7578s4h75ci945c14b**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "****36-3C1E-4417-BDB2-1E034F****",
"ProjectId": "****fddd7748b58bf1d47e95****",
"JobId": "****d80e4e4044975745c14b****",
"MediaId": "****c469e944b5a856828dc2****",
"MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
"VodMediaId": "****d7578s4h75ci945c14b****"
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。