Topik ini menjelaskan event VideoAnalysisComplete, konten notifikasinya, serta contoh callback.
Tipe Peristiwa
VideoAnalysisComplete
Deskripsi Peristiwa
ApsaraVideo VOD menganalisis file sumber audio dan video setelah diunggah. Event ini dihasilkan setelah proses analisis selesai.
Secara default, ApsaraVideo VOD menganalisis semua file audio dan video yang diunggah. Analisis ini tidak dikenai biaya.
Analisis mengekstraksi metadata dasar dari file sumber, seperti durasi, resolusi (lebar dan tinggi), bitrate, dan laju frame.
Setelah analisis, metadata tersebut ditambahkan ke pustaka aset media. Anda dapat memanggil operasi GetMezzanineInfo untuk mengambil metadata tambahan mengenai file sumber.
Isi Notifikasi Peristiwa
Parameter Name | Type | Required | Description |
EventTime | String | Yes | Waktu saat event dihasilkan. Waktu dalam format UTC dengan pola yyyy-MM-ddTHH:mm:ssZ. |
EventType | String | Yes | Jenis event. Ini adalah parameter yang diperlukan. Nilainya tetap VideoAnalysisComplete. |
VideoId | String | Yes | ID file audio atau video. |
Status | String | Yes | Status analisis file sumber.
|
Width | Long | No | Lebar file sumber. Bidang ini tidak dikembalikan untuk file hanya audio. |
Height | Long | No | Tinggi file sumber. Bidang ini tidak dikembalikan untuk file hanya audio. |
Duration | Float | No | Durasi file sumber, dalam detik. |
Bitrate | String | No | Bitrate file sumber, dalam Kbps. |
Fps | String | No | Laju frame file sumber, dalam frame per detik. Bidang ini tidak dikembalikan untuk file hanya audio. |
Size | Long | No | Ukuran file sumber, dalam byte. |
ErrorCode | String | No | Kode kesalahan untuk pekerjaan. Bidang ini dikembalikan ketika terjadi kesalahan selama analisis file sumber. |
ErrorMessage | String | No | Pesan kesalahan untuk pekerjaan. Bidang ini dikembalikan ketika terjadi kesalahan selama analisis file sumber. |
Jika Status bernilai fail, berarti analisis gagal dan informasi dasar file sumber tidak dikembalikan. Kegagalan biasanya disebabkan oleh enkapsulasi file sumber yang tidak normal.
Contoh callback
Perhatikan hal-hal berikut mengenai contoh callback:
Untuk callback HTTP, konten berikut merupakan body HTTP POST.
Untuk callback MNS, konten berikut merupakan body pesan.
Contoh callback analisis berhasil:
{
"VideoId":"84bd5b0566ddj39549986befd0e80****",
"Duration":"12",
"Height":"360",
"Width":"630",
"Fps":"30",
"Bitrate":"499",
"Size":"1234568",
"EventTime":"2018-11-28T10:12:48Z",
"EventType":"VideoAnalysisComplete",
"Status":"success"
}Contoh callback analisis gagal:
{
"VideoId":"84bd5b0566ddj39549986befd0e80****",
"EventTime":"2018-11-28T10:12:48Z",
"EventType":"VideoAnalysisComplete",
"Status":"fail",
"ErrorCode":"InvalidParameter.ResourceContentBad",
"ErrorMessage":"The resource operated InputFile is bad"
}