ProduceEditingProjectVideo - - Alibaba Cloud ドキュメントセンター

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 エラーセンター」をご参照ください。