全部产品
Search
文档中心

ApsaraVideo VOD:DynamicImageComplete

更新时间:Jul 02, 2025

Topik ini menjelaskan event DynamicImageComplete, termasuk isi notifikasi dan contoh callback-nya.

Tipe Event

DynamicImageComplete

Deskripsi Event

Event DynamicImageComplete dihasilkan setelah pembuatan gambar dinamis selesai.

Catatan
  • Jika Anda telah mengonfigurasi nama domain CDN dan mengaktifkan penandatanganan URL, Anda harus membuat auth_key sendiri untuk mengakses URL gambar dinamis. Jika tidak, permintaan Anda akan mengembalikan kode error HTTP 403. Untuk informasi lebih lanjut tentang penandatanganan URL, lihat Penandatanganan URL.

  • Jika tidak ada nama domain CDN yang dikonfigurasi, URL server asal OSS akan dikembalikan. URL ini hanya dapat diakses jika ACL Bucket OSS terkait disetel ke public read. Untuk memastikan keamanan data, kami menyarankan Anda mengonfigurasi nama domain CDN. Untuk informasi lebih lanjut, lihat Tambahkan nama domain.

Isi Notifikasi Event

Parameter

Tipe

Wajib

Deskripsi

EventTime

String

Ya

Waktu ketika event dihasilkan. Waktu ditampilkan dalam format yyyy-MM-ddTHH:mm:ssZ dan dalam UTC.

EventType

String

Ya

Tipe event. Nilainya adalah DynamicImageComplete.

VideoId

String

Ya

ID video.

Status

String

Ya

Menunjukkan apakah pekerjaan gambar dinamis selesai. Nilai valid:

  • success: Pekerjaan gambar dinamis selesai.

  • fail: Pekerjaan gambar dinamis gagal diselesaikan.

JobId

String

Ya

ID pekerjaan gambar dinamis.

ErrorCode

String

Tidak

Kode kesalahan. Parameter ini tersedia ketika terjadi kesalahan dalam pekerjaan gambar dinamis.

ErrorMessage

String

Tidak

Pesan kesalahan. Parameter ini tersedia ketika terjadi kesalahan dalam pekerjaan gambar dinamis.

DynamicImageJobInfo

DynamicImageJobInfo[]

Tidak

Detail gambar dinamis. Nilainya adalah string JSON. Parameter ini tidak tersedia ketika pekerjaan gambar dinamis gagal. Untuk informasi lebih lanjut, lihat tabel berikut Data DynamicImageJobInfo.

Data DynamicImageJobInfo

Bidang

Tipe

Wajib

Deskripsi

JobId

String

Ya

ID pekerjaan gambar dinamis.

Status

String

Ya

Menunjukkan apakah pekerjaan gambar dinamis selesai. Nilai valid:

  • success: Pekerjaan gambar dinamis selesai.

  • fail: Pekerjaan gambar dinamis gagal diselesaikan.

FileURL

String

Ya

URL gambar dinamis.

FileSize

String

Tidak

Ukuran gambar dinamis. Satuan: byte.

Fps

String

Tidak

Laju frame aliran video, dalam frame per detik.

Height

String

Tidak

Tinggi gambar dinamis. Satuan: px.

Width

String

Tidak

Lebar gambar dinamis. Satuan: px.

Contoh Callback

Deskripsi:

  • Untuk callback HTTP, contoh berikut adalah body dari permintaan HTTP POST.

  • Untuk callback MNS, contoh berikut adalah body pesan.

{
    "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****"
}