1つ以上のメザニンファイルからビデオを生成します。 Timelineパラメーターを指定すると、メザニンファイルを直接送信できます。 または、オンライン編集プロジェクトを作成した後にメザニンファイルを送信することもできます。

注
  • この操作は、ビデオ制作タスクの送信結果のみを返します。 When the submission result is returned, video production may still be in progress. ビデオ制作タスクが送信された後、タスクは非同期処理のためにバックグラウンドでキューに入れられます。
    • オンライン編集プロジェクトのタイムラインで参照されるメザニンファイルは、メディアライブラリ内のメディアアセットまたはビデオの素材にすることができます。
  • ビデオは、ProjectIdおよびTimelineパラメータに基づいて生成されます。 パラメーターを指定するときは、次の項目に注意してください。
    • ProjectIdパラメーターとTimelineパラメーターの少なくとも1つを指定する必要があります。 Otherwise, video production fails.
    • Timelineパラメーターのみを指定すると、指定したタイムラインでオンライン編集プロジェクトが自動的に作成されます。 次いで、システムは、タイムラインにおいて参照されるメザニンファイルを取得し、メザニンファイルからビデオを生成する。
    • ProjectIdパラメーターのみを指定した場合、システムは指定されたプロジェクトの最新のタイムラインを取得し、タイムラインに基づいてビデオを生成します。
    • ProjectIdパラメーターとTimelineパラメーターの両方を指定すると、指定されたタイムラインに基づいてビデオが生成され、指定されたオンライン編集プロジェクトのタイムラインファイルとメザニンファイルが更新されます。 他のパラメーターを指定すると、オンライン編集プロジェクトの関連設定も更新されます。
    • 作成するビデオにエフェクトを適用できます。 詳細については、「特殊効果」をご参照ください。

デバッグ

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

リクエストパラメーター

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

実行したい操作。 値をProduceEditingProjectVideoに設定します。

ProjectId String 任意 fb2101bf24b ***** 4cb318787dc

オンライン編集プロジェクトのID。
タイムライン String 任意 {"VideoTracks":[{"VideoTrackClips":[{"MediaId":"cc3308ac5 ***** 9615a54328bc3443" },{ "MediaId":"da87a9cff64 ***** 5cd88bc6d8326e4"}]}]}

JSON形式のオンライン編集プロジェクトのタイムライン。 構造の詳細については、「タイムライン」をご参照ください。

タイトル String 任意 ビデオ制作のテスト

オンライン編集プロジェクトのタイトル。
説明 String 任意 説明

オンライン編集プロジェクトの説明。
CoverURL String 任意 https://****.com/6AB4D0E1E1C7446888351****.png

The thumbnail URL of the online editing project.
MediaMetadata String 任意 {"Description": "Description of the produced video", "Title": "User data-based production test"}

生成されたビデオのメタデータ (JSON形式) 。 構造体の詳細については、「MediaMetadata」をご参照ください。

ProduceConfig String 任意 {"TemplateGroupId":"6d11e25ea30a*****4c465435c74"}

The configuration of video production, in JSON format. 構造の詳細については、「ProduceConfig」をご参照ください。

UserData String 任意 {"Extend":{"width":1280,"id":"028a8e56b*****1ebf6bb7afc74","height":720},"MessageCallback":{"CallbackURL":"https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/","CallbackType":"http"}}

コールバック設定などのカスタム設定。 値は JSON 形式の文字列です。 For more information about the structure, see UserData.

注 To use the MessageCallback parameter, you must set an HTTP callback URL and select a callback event type in the ApsaraVideo VOD console. Otherwise, the callback configuration does not take effect.

レスポンスパラメーター

パラメーター データ型 例 説明
MediaId String 006204a11bb3*****86bb25491f95f

The ID of the produced video.

注
  • This operation returns the ID of the produced video in synchronous mode.
  • If this operation returns the MediaId parameter, the video production task is being asynchronously processed.
ProjectId String fb2101bf24b*****4cb318787dc

The ID of the online editing project.
RequestId String 25818875-5F78-4A ***** F6-D7393642CA58

リクエストの ID です。
注 ApsaraVideo VOD sends a FileUploadComplete event notification after video production is complete, which is similar to the action that is performed after video upload. After the produced video is transcoded, ApsaraVideo VOD sends the StreamTranscodeComplete and TranscodeComplete event notifications.

例

リクエストの例

https://vod.{ApiRegion}.aliyuncs.com/?Action=ProduceEditingProjectVideo
&<Common request parameters>

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

XML 形式 

<ProduceEditingProjectVideoResponse>
      <RequestId>25818875-5F78-4A ***** F6-D7393642CA58</RequestId>
      <MediaId>006204a11bb3*****86bb25491f95f</MediaId>
      <ProjectId>fb2101bf24b*****4cb318787dc</ProjectId>
</ProduceEditingProjectVideoResponse>

JSON 形式 

{
    "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
    "MediaId": "006204a11bb3 ***** 86bb25491f95f" 、
    "ProjectId":"fb2101bf24b ***** 4cb318787dc"
}

エラーコード

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

SDK サンプル

この操作を呼び出すには、サーバーSDKを使用することを推奨します。 さまざまな言語でこの操作を呼び出すために使用されるサンプルコードの詳細については、次のトピックを参照してください。