編集タスクを作成します。

Usage notes

この操作を呼び出して、制作スタジオのIDとエピソードのIDを指定して編集タスクを作成できます。

編集タスクが作成された後は、通知を受け取りません。 GetEditingJobInfo操作を呼び出して、編集タスクのステータスを照会できます。

QPSの制限

You can call this operation up to 10 times per second per account. 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 その結果、あなたのビジネスが影響を受ける可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。 詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
操作 String 必須 EditShowAndReplace

実行する操作です。 値をEditShowAndReplaceに設定します。

CasterId 文字列 必須 53200b81-b761-4c10-842a-a0726d97 ****

制作スタジオのID。

  • プロダクションスタジオがCreateCaster操作を呼び出して作成された場合は、レスポンスパラメーターCasterIdの値を確認して、プロダクションスタジオのIDを取得します。
  • ApsaraVideo Liveコンソールで制作スタジオを作成した場合は、[制作スタジオの管理] ページで制作スタジオのIDを取得します。 Production Studioの管理ページに移動するには、ApsaraVideo Liveコンソールにログインし、左側のナビゲーションウィンドウでProduction Studiosをクリックします。
注 作成したプロダクションスタジオはプロダクションスタジオの管理ページで検索でき、IDは名前列に表示されます。
ShowId 文字列 はい 42200b81-b761-4c10-842a-a0726d97 ****

編集するエピソードのID。

注 エピソードIDを取得するには、AddShowIntoShowList操作の応答パラメーターShowIdの値を確認します。
StorageInfo 文字列 いいえ null

エピソードのストレージ情報。 以下のパラメータが含まれています。

  • StorageLocation: ApsaraVideo VODの保存場所。
  • FileName: ビデオオンデマンド (VOD) ファイルの名前。
注 ApsaraVideo VODとApsaraVideo Liveの両方にアクセスするために使用されるアカウント内の保存場所を指定する必要があります。 保存場所の取得方法の詳細については、「VODリソースの管理」をご参照ください。
StartTime フロート 任意 2.0

編集タスクの開始時刻。 単位: 秒。

注
  • 有効な値の範囲は、0からエピソードの全長で示される値までです。
  • デフォルトでは、編集タスクはエピソードの最初から開始されます。 デフォルト値: 0.0
  • 2秒から5秒までのVODファイルを編集する場合は、StartTimeパラメーターを2.0に設定し、EndTimeパラメーターを5.0に設定します。
EndTime Float No 5.0

編集タスクの終了時刻。 (単位：秒)

注
  • 有効な値の範囲は、0からエピソードの全長で示される値までです。
  • デフォルトでは、このパラメーターはエピソードの合計長さを示す値に設定されています。 編集期間は、エピソードの全長を超えることはできません。
  • If you want to edit a VOD file from the 2nd second to the 5th second, set the StartTime parameter to 2.0 and the EndTime parameter to 5.0.

応答パラメータ

パラメーター データ型 例 説明
JobInfo 文字列 null

編集タスクに関する情報。 以下のパラメータが含まれています。

  • vodId: VODファイルのID。
  • mediaid: メディアファイルのID。
  • jobId: 編集タスクのID。
RequestId 文字列 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

リクエストの ID です。

例

リクエストのサンプル

http(s):// live.aliyuncs.com/?Action=EditShowAndReplace
&CasterId=53200b81-b761-4c10-842a-a0726d97 ****
&ShowId=42200b81-b761-4c10-842a-a0726d97 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

<EditShowAndReplaceResponse> 
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <JobInfo>
        <vodId>3e34733b40b9a96ccf5c1ff6f69 ****</vodId>
        <mediaid>eb1861d2c9a842340e989dd56 ****</mediaid>
        <jobId>7d2fbc380b0e08e55fe98733764 ****</jobId>
  </JobInfo>
</EditShowAndReplaceResponse>

JSON形式 

{
    "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
    "JobInfo": {
        "vodId": "3e34733b40b9a96ccf5c1ff6f69 ****" 、
        "mediaid": "eb1861d2c9a842340e989dd56 ****" 、
        "jobId": "7d2fbc380b0e08e55fe98733764 ****"
    }
}

エラーコード

エラーコードリストについては、「API エラーセンター」をご参照ください。