ApsaraVideo VOD menyediakan fitur panggilan balik. Anda dapat mengonfigurasi parameter UserData saat menggunakan API atau SDK ApsaraVideo VOD untuk menentukan beberapa URL panggilan balik HTTP atau Simple Message Queue (formerly MNS). Fitur ini memungkinkan Anda mengirim notifikasi peristiwa dari tipe tertentu ke beberapa server untuk diproses lebih lanjut atau mengirim pesan panggilan balik ke berbagai lingkungan seperti pengembangan, pengujian, dan produksi.
Deskripsi
ApsaraVideo VOD memungkinkan Anda mengonfigurasi hanya satu metode panggilan balik dan satu URL panggilan balik untuk setiap wilayah. Pengaturan panggilan balik berlaku secara global. Parameter UserData yang disediakan oleh ApsaraVideo VOD memungkinkan Anda menentukan beberapa URL panggilan balik untuk layanan multi-lingkungan.
Konfigurasikan notifikasi peristiwa global
Batasan
Jika Anda ingin menggunakan panggilan balik Simple Message Queue (formerly MNS), Anda harus memberi otorisasi ApsaraVideo VOD untuk mengakses Simple Message Queue (formerly MNS) melalui halaman Otorisasi Akses Sumber Daya Cloud.
Catatan penggunaan
ApsaraVideo VOD mendukung panggilan balik HTTP dan panggilan balik Simple Message Queue (formerly MNS) untuk notifikasi peristiwa global. ApsaraVideo VOD tersedia di beberapa wilayah, tetapi Anda hanya dapat mengonfigurasi satu metode panggilan balik dan satu URL panggilan balik per wilayah. Ketika peristiwa terpicu, ApsaraVideo VOD akan mengirimkan notifikasi peristiwa sesuai dengan pengaturan panggilan balik yang ditentukan untuk wilayah tersebut. Peristiwa dapat dipicu melalui operasi seperti unggah file audio, video, atau gambar, serta pengiriman pekerjaan pemrosesan media seperti transkode dan ulasan.
Metode konfigurasi
Anda dapat mengonfigurasi notifikasi peristiwa global melalui konsol ApsaraVideo VOD, SDK, atau API. Untuk informasi lebih lanjut tentang prosedur dan batasan, lihat Panggilan balik HTTP dan Panggilan balik SMQ.
Tentukan URL panggilan balik dalam UserData selama unggah
Batasan
Parameter UserData hanya dapat ditentukan menggunakan SDK atau API ApsaraVideo VOD.
Fitur notifikasi global harus diaktifkan, dan peristiwa untuk panggilan balik harus ditentukan. Jika tidak, URL panggilan balik yang ditentukan dalam UserData tidak akan berlaku.
Catatan penggunaan
URL panggilan balik dapat ditentukan dalam UserData untuk file media yang diunggah ke ApsaraVideo VOD menggunakan SDK operasi server atau SDK unggah. URL panggilan balik ini terikat pada file sumber media. Notifikasi peristiwa akan dikirim ke URL panggilan balik saat pekerjaan pemrosesan media seperti transkode atau ulasan diajukan untuk file tersebut. Peristiwa yang memicu panggilan balik ditentukan dalam pengaturan panggilan balik global. Jika file sumber media dihapus, notifikasi peristiwa berikutnya akan dikirim ke URL panggilan balik yang ditentukan dalam pengaturan panggilan balik global.
Operasi terkait
Untuk informasi lebih lanjut tentang cara menggunakan SDK operasi server atau SDK unggah, lihat Catatan penggunaan dan Ikhtisar.
Parameter UserData dapat ditentukan saat memanggil operasi berikut untuk mengunggah file media:
Tentukan URL panggilan balik dalam UserData selama pemrosesan media
Batasan
Parameter UserData hanya dapat ditentukan menggunakan SDK atau API ApsaraVideo VOD.
Fitur notifikasi global harus diaktifkan, dan peristiwa untuk panggilan balik harus ditentukan. Jika tidak, URL panggilan balik yang ditentukan dalam UserData tidak akan berlaku.
Catatan penggunaan
URL panggilan balik dapat ditentukan dalam UserData saat mengirimkan pekerjaan pemrosesan media seperti transkode menggunakan SDK atau API ApsaraVideo VOD.
URL panggilan balik yang ditentukan dalam UserData selama pemrosesan media hanya berlaku untuk satu peristiwa. Jika tidak ada URL panggilan balik yang ditentukan selama pemrosesan media, URL panggilan balik yang ditentukan dalam UserData selama unggah akan digunakan sebelum URL panggilan balik yang ditentukan dalam pengaturan panggilan balik global.
Operasi terkait
Parameter UserData dapat ditentukan saat memanggil operasi berikut untuk mengirimkan pekerjaan pemrosesan media:
Contoh kode
Untuk informasi lebih lanjut tentang struktur dan detail parameter UserData, lihat Parameter permintaan. Contoh kode 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"
}
}Contoh kode berikut menunjukkan cara membangun UserData:
public static String buildUserData() {
JSONObject userData = new JSONObject();
// Konfigurasikan panggilan balik pesan.
JSONObject messageCallback = new JSONObject();
messageCallback.put("CallbackType", "http");
messageCallback.put("CallbackURL", "https://xxxxx.com/2016-08-15/proxy/httpcallback/testcallback/");
userData.put("MessageCallback", messageCallback);
// Bidang yang ingin Anda lewatkan ke UserData. Anda dapat melewati parameter kustom.
JSONObject extend = new JSONObject();
extend.put("id", "028a8e56b*****1ebf6bb7afc74");
extend.put("width", 1280);
extend.put("height", 720);
userData.put("Extend", extend);
// Konfigurasikan percepatan unggah jika layanan percepatan diperlukan. Sebelum Anda dapat menggunakan percepatan unggah, ajukan permohonan untuk mengaktifkan fitur percepatan.
JSONObject accelerateConfig = new JSONObject();
accelerateConfig.put("Type", "oss");
accelerateConfig.put("Domain", "https://oss-accelerate.aliyuncs.com");
userData.put("AccelerateConfig", accelerateConfig);
return userData.toJSONString();
}