Anda dapat mengatur parameter UserData dalam API atau SDK ApsaraVideo VOD untuk menentukan beberapa URL callback HTTP atau Simple Message Queue (formerly MNS). Fitur ini berguna ketika Anda ingin mengirimkan notifikasi event ke beberapa server atau mengirimkan pesan callback ke lingkungan yang berbeda, seperti development, testing, dan production.
Deskripsi
ApsaraVideo VOD hanya memungkinkan Anda mengonfigurasi satu metode callback dan satu URL callback untuk setiap Wilayah, dan pengaturan tersebut berlaku secara global. Ketika beberapa layanan berbagi instans ApsaraVideo VOD yang sama, Anda dapat menentukan URL callback yang berbeda dalam MessageCallback pada UserData untuk setiap layanan. Callback tersebut tidak saling memengaruhi satu sama lain. Untuk menentukan beberapa URL callback bagi layanan multi-lingkungan, gunakan parameter UserData.
Konfigurasi notifikasi event global
Batasan
Jika Anda ingin menggunakan callback Simple Message Queue (formerly MNS), Anda harus membuka halaman untuk memberikan otorisasi kepada ApsaraVideo VOD agar dapat mengakses Simple Message Queue (formerly MNS).
Catatan penggunaan
ApsaraVideo VOD mendukung callback HTTP dan callback Simple Message Queue (formerly MNS) untuk notifikasi event global. Anda hanya dapat mengonfigurasi satu metode callback dan satu URL callback untuk setiap Wilayah. Ketika event seperti upload file audio, video, atau gambar, atau pengiriman tugas pemrosesan media seperti transkoding dan review dipicu, ApsaraVideo VOD akan mengirimkan notifikasi event berdasarkan pengaturan callback untuk Wilayah tersebut.
Metode konfigurasi
Anda dapat mengonfigurasi notifikasi event global melalui Konsol ApsaraVideo VOD, SDK, atau API. Untuk informasi lebih lanjut mengenai prosedur dan batasan, lihat HTTP callbacks dan SMQ callbacks. Untuk mengonfigurasi melalui konsol, login ke Konsol ApsaraVideo VOD lalu pilih Configuration Management > Media Processing Configuration > Callback Settings. Kemudian pilih metode callback dan konfigurasikan URL callback serta jenis event.
Tentukan URL callback dalam UserData saat upload
Batasan
-
Anda hanya dapat menentukan parameter UserData dengan menggunakan SDK atau API ApsaraVideo VOD.
-
Anda harus mengaktifkan fitur notifikasi global dan menentukan event yang ingin dikonfigurasi callback-nya. Jika tidak, URL callback yang Anda tentukan dalam UserData tidak akan berlaku.
Catatan penggunaan
Anda dapat menentukan URL callback dalam UserData untuk file media yang diupload ke ApsaraVideo VOD menggunakan SDK operasi server atau SDK upload. URL callback tersebut terikat pada file sumber media, dan notifikasi event akan dikirimkan ke URL ini ketika Anda mengirimkan tugas pemrosesan media seperti pekerjaan transkoding dan review. Event yang dikonfigurasi untuk callback ditentukan dalam pengaturan callback global. Jika Anda menghapus file resource media, notifikasi event selanjutnya akan dikirimkan ke URL callback yang ditentukan dalam pengaturan callback global.
Operasi terkait
Untuk informasi lebih lanjut mengenai cara menggunakan SDK operasi server atau SDK upload, lihat Catatan penggunaan dan Ikhtisar.
Anda dapat menentukan parameter UserData saat memanggil operasi berikut untuk mengupload file media:
Tentukan URL callback dalam UserData saat pemrosesan media
Batasan
-
Anda hanya dapat menentukan parameter UserData dengan menggunakan SDK atau API ApsaraVideo VOD.
-
Anda harus mengaktifkan fitur notifikasi global dan menentukan event yang ingin dikonfigurasi callback-nya. Jika tidak, URL callback yang Anda tentukan dalam UserData tidak akan berlaku.
Catatan penggunaan
Anda dapat menentukan URL callback dalam UserData saat mengirimkan tugas pemrosesan media seperti pekerjaan transkoding menggunakan SDK atau API ApsaraVideo VOD.
URL callback yang ditentukan dalam UserData selama pemrosesan media hanya berlaku untuk satu event saja. Jika Anda tidak menentukan URL callback selama pemrosesan media, URL callback yang ditentukan dalam UserData saat upload akan digunakan terlebih dahulu sebelum beralih ke URL callback yang ditentukan dalam pengaturan callback global.
Operasi terkait
Anda dapat menentukan parameter UserData saat memanggil operasi berikut untuk mengirimkan tugas pemrosesan media:
Contoh kode
Untuk informasi lebih lanjut mengenai struktur parameter UserData, lihat Request parameters. Contoh berikut menunjukkan struktur UserData:
{
"Extend":{
"width":1280,
"id":"028a8e56b*****1ebf6bb7afc74",
"height":720
},
"AccelerateConfig":{
"Type":"oss",
"Domain":"https://oss-accelerate.aliyuncs.com"
},
"MessageCallback":{
"CallbackURL":"https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/",
"CallbackType":"http",
"EventTypeList":["TranscodeComplete","StreamTranscodeComplete"]
}
}Contoh berikut menunjukkan cara membuat UserData:
public static String buildUserData() {
JSONObject userData = new JSONObject();
// Konfigurasikan message callbacks.
JSONObject messageCallback = new JSONObject();
messageCallback.put("CallbackType", "http");
messageCallback.put("CallbackURL", "https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/");
messageCallback.put("EventTypeList", new JSONArray().put("TranscodeComplete").put("StreamTranscodeComplete"));
userData.put("MessageCallback", messageCallback);
// Bidang yang ingin Anda lewatkan ke UserData. Anda dapat melewatkan parameter kustom.
JSONObject extend = new JSONObject();
extend.put("id", "028a8e56b*****1ebf6bb7afc74");
extend.put("width", 1280);
extend.put("height", 720);
userData.put("Extend", extend);
// Konfigurasikan akselerasi upload jika diperlukan layanan akselerasi. Sebelum menggunakan akselerasi upload, ajukan permohonan untuk mengaktifkan fitur akselerasi.
JSONObject accelerateConfig = new JSONObject();
accelerateConfig.put("Type", "oss");
accelerateConfig.put("Domain", "https://oss-accelerate.aliyuncs.com");
userData.put("AccelerateConfig", accelerateConfig);
return userData.toJSONString();
}