DynamicImageComplete イベントは、動的画像ジョブが完了したことを通知します。このトピックでは、イベントの内容とコールバックの例について説明します。
イベントタイプ
DynamicImageComplete
イベントの説明
DynamicImageComplete イベントは、動的画像ジョブが完了した後にトリガーされます。
-
CDN アクセラレーションドメイン名を設定し、URL 署名を有効にしている場合は、動的画像 URL にアクセスするために auth_key を生成する必要があります。そうしないと、
HTTP 403エラーが返されます。詳細については、「URL 署名」をご参照ください。 -
CDN アクセラレーションドメイン名を設定していない場合は、オリジン OSS サーバーのアドレスが返されます。このアドレスにアクセスできるのは、バケットがパブリック読み取りに設定されている場合のみです。データセキュリティを確保するために、CDN アクセラレーションドメイン名を設定してください。詳細については、「ドメイン名管理」をご参照ください。
イベントの内容
|
パラメータ名 |
タイプ |
必須 |
説明 |
|
EventTime |
String |
はい |
イベントが生成された時刻 (UTC) です。形式：yyyy-MM-ddTHH:mm:ssZ。 |
|
EventType |
String |
はい |
イベントタイプです。値は DynamicImageComplete です。 |
|
VideoId |
String |
はい |
ビデオの ID です。 |
|
Status |
String |
はい |
動的画像ジョブのステータスです。
|
|
JobId |
String |
はい |
動的画像ジョブの ID です。 |
|
ErrorCode |
String |
いいえ |
ジョブが失敗した場合に返されるエラーコードです。 |
|
ErrorMessage |
String |
いいえ |
ジョブが失敗した場合に返されるエラーメッセージです。 |
|
DynamicImageJobInfo |
DynamicImageJobInfo[] |
いいえ |
動的画像の詳細です。JSON 文字列として返されます。ジョブが失敗した場合は返されません。詳細については、下記の表「DynamicImageJobInfo データ」をご参照ください。 |
DynamicImageJobInfo データ
|
パラメータ名 |
タイプ |
必須 |
説明 |
|
JobId |
String |
はい |
動的画像ジョブの ID です。 |
|
Status |
String |
はい |
動的画像ジョブのステータスです。
|
|
FileURL |
String |
はい |
動的画像ファイルの URL です。 |
|
FileSize |
String |
いいえ |
動的画像ファイルのサイズです (単位：バイト)。 |
|
Fps |
String |
いいえ |
ビデオストリームのフレームレートです (フレーム/秒)。 |
|
Height |
String |
いいえ |
動的画像の高さです (単位：ピクセル)。 |
|
Width |
String |
いいえ |
動的画像の幅です (単位：ピクセル)。 |
コールバックの例
コールバックの例：
-
HTTP コールバック：HTTP POST リクエストの本文。
-
MNS コールバック：メッセージ本文。
{
"Status":"success",
"VideoId":"6a45f222e08fhdjdn2d144503213****",
"EventType":"DynamicImageComplete",
"EventTime":"2019-11-05T09:12:58Z",
"DynamicImageJobInfo": {
"FileSize":"1834831",
"FileURL":"http://example.aliyundoc.com/6a45f222e08fhdjdn2d144503213****/image/dynamic/3af1e9705cb24321d4c3719f0d41****.gif",
"Fps":"25",
"Height":"200",
"JobId":"3af7e9705cb24js83j231d4c3719****",
"Status":"success",
"Width":"200"
},
"JobId":"3af7e9705cb24js83j231d4c3719****"
}