このトピックでは、ProduceMediaComplete イベント、通知の内容、およびコールバックの例について説明します。
イベントタイプ
ProduceMediaComplete
イベントの説明
このイベントは、動画合成が完了したときに生成されます。
動画合成は、ApsaraVideo VOD コンソールの動画エディターページ、または ProduceEditingProjectVideo API を呼び出すことで開始できます。
動画合成によって生成されたファイルは、メディアリソースのソースファイルとして使用されます。
イベントの内容
パラメーター名 | タイプ | 必須 | 説明 |
EventTime | String | はい | イベントが生成された時刻。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式に従います。 |
EventType | String | はい | イベントタイプ。これは必須パラメーターです。値は ProduceMediaComplete です。 |
Status | String | はい | 動画合成ジョブのステータス。
説明 ステータスが fail の場合、動画合成ジョブは成功しておらず、結果のメディアリソースのソースファイルは生成されていません。 |
MediaId | String | はい | 合成されたメディアリソースの ID。 |
ProjectId | String | はい | この合成ジョブのオンライン編集プロジェクトの ID。 |
ErrorCode | String | いいえ | エラーコード。このパラメーターは、動画合成中にエラーが発生した場合に返されます。 |
ErrorMessage | String | いいえ | エラーメッセージ。このパラメーターは、動画合成中にエラーが発生した場合に返されます。 |
UserData | String | いいえ | カスタム設定。この値は、ProduceEditingProjectVideo API の呼び出し時に渡される UserData の値です。JSON 文字列であり、コールバックでそのまま返されます。 |
コールバックの例
コールバックの例に関する注意点は次のとおりです。
HTTP コールバックの場合、内容は HTTP POST リクエストの本文です。
MNS コールバックの場合、内容はメッセージ本文です。
成功時のコールバックメッセージの例：
{
"MediaId": "1234343b689*****a5422dfe1e472a41",
"ProjectId": "987624bab6*****d9fcdeefdd974c7aa",
"Status": "success",
"EventType": "ProduceMediaComplete",
"EventTime": "2018-12-26T14:34:09Z",
"UserData": "{\"Extend\":{\"localId\":\"xxx\"},\"MessageCallback\":{\"CallbackURL\":\"https://example.com/callback\"}}"
}失敗時のコールバックメッセージの例：
{
"MediaId": "1234343b689*****a5422dfe1e472a41",
"ProjectId": "987624bab6*****d9fcdeefdd974c7aa",
"Status": "fail",
"EventType": "ProduceMediaComplete",
"EventTime": "2018-12-26T14:34:09Z",
"ErrorCode": "InvalidParameter.ResourceContentBad",
"ErrorMessage": "The resource operated InputFile is bad"
}