ApsaraVideo VOD:Callback Simple Message Queue (formerly MNS)

Mekanisme callback Simple Message Queue (formerly MNS)

1. Buat antrian di Simple Message Queue (formerly MNS) dan konfigurasikan callback yang sesuai di ApsaraVideo VOD.

2. Ketika suatu event terjadi, ApsaraVideo VOD menulis notifikasi event ke antrian Simple Message Queue (formerly MNS).

3. Callback dianggap berhasil jika ApsaraVideo VOD berhasil menulis pesan ke antrian Simple Message Queue (formerly MNS). Jika tidak, callback gagal. Jika ApsaraVideo VOD gagal menulis pesan karena kesalahan konfigurasi—seperti ApsaraVideo VOD tidak diotorisasi untuk mengakses Simple Message Queue (formerly MNS), endpoint bukan titik akhir publik, atau nama antrian salah—ApsaraVideo VOD mencoba callback ulang sebanyak dua kali lagi. Callback dicoba maksimal tiga kali. Jika ketiga percobaan gagal, pesan tersebut dibuang. Untuk informasi selengkapnya tentang validasi dan retry callback, lihat Validasi dan retry callback.

4. Setelah callback berhasil, Anda dapat mengambil pesan dari antrian Simple Message Queue (formerly MNS) untuk melihat konten notifikasi event. Anda hanya dapat menghapus pesan setelah pesan tersebut diterima dan dikonsumsi. Setelah dikonsumsi, pesan tetap invisible selama periode tertentu. Anda harus menghapusnya dalam periode tersebut. Jika tidak, pesan akan kembali visible dan dikonsumsi lagi.

Cara menggunakan

Prasyarat

• Akun Alibaba Cloud telah dibuat dan verifikasi identitas telah selesai. Untuk membuat Akun Alibaba Cloud, kunjungi website resmi Alibaba Cloud. Untuk informasi selengkapnya, lihat Buat Akun Alibaba Cloud.

• ApsaraVideo VOD telah diaktifkan. Untuk informasi selengkapnya, lihat Aktifkan ApsaraVideo VOD.

• Anda telah mengaktifkan Simple Message Queue (formerly MNS). Untuk petunjuknya, lihat Aktifkan Simple Message Queue (formerly MNS) dan berikan izin.

Catatan penggunaan

• ApsaraVideo VOD mendukung beberapa wilayah layanan. Konfigurasi notifikasi event bersifat spesifik untuk setiap wilayah. Anda dapat mengonfigurasi metode callback dan alamat webhook yang terpisah untuk setiap wilayah.

• Di Simple Message Queue (formerly MNS), Anda dapat membuat beberapa antrian Simple Message Queue (formerly MNS) di berbagai wilayah layanan. Namun, di ApsaraVideo VOD, Anda hanya dapat mengonfigurasi satu antrian Simple Message Queue (formerly MNS) untuk callback MNS per wilayah layanan. Kami merekomendasikan agar Anda membuat dan menggunakan antrian di wilayah berikut:

  • Jika video Anda disimpan di Tiongkok daratan, seperti China (North 2) atau China (Shanghai), gunakan antrian di wilayah China (Shanghai). Mengirim pesan ke antrian di wilayah selain China (Shanghai) dapat menyebabkan penundaan singkat.

  • Jika video Anda disimpan di wilayah lain, seperti Singapura atau Jepang, buat atau gunakan antrian pesan di wilayah yang sesuai.

    Contohnya, jika wilayah penyimpanan video Anda adalah Singapura, buat atau gunakan antrian pesan di wilayah Singapura.

• Callback MNS mendukung beberapa alamat webhook untuk mendukung lingkungan pengembangan yang berbeda. Untuk informasi selengkapnya, lihat Konfigurasi multiple alamat webhook.

Prosedur

1. Berikan izin kepada ApsaraVideo VOD untuk mengakses Simple Message Queue (formerly MNS).

   Anda dapat menggunakan salah satu metode berikut untuk memberikan izin:

   • Metode 1: Berikan izin kepada ApsaraVideo VOD untuk mengakses sumber daya cloud Anda, termasuk OSS, Simple Message Queue (formerly MNS), CDN, dan KMS.

     Login ke Konsol Manajemen Alibaba Cloud. Buka halaman otorisasi akses resource dan klik Confirm Authorization.

   • Metode 2: Berikan izin kepada Pengguna RAM, kelompok pengguna, atau role untuk mengakses Simple Message Queue (formerly MNS) untuk layanan ApsaraVideo VOD.

     Tambahkan kebijakan sistem AliyunMNSFullAccess (akses penuh ke Simple Message Queue (formerly MNS)) atau kebijakan sistem AliyunMNSReadOnlyAccess (akses read-only ke Simple Message Queue (formerly MNS)) ke kebijakan otorisasi. Untuk informasi selengkapnya, lihat Buat Pengguna RAM dan berikan izin.

2. Buat antrian di Simple Message Queue (formerly MNS).

   Anda dapat membuat antrian di Simple Message Queue (formerly MNS) atau menggunakan yang sudah ada. Anda dapat membuat antrian di Konsol atau menggunakan API atau SDK. Untuk membuat antrian di Konsol, lihat Buat antrian. Untuk informasi selengkapnya tentang API dan SDK, lihat Operasi antrian.

   Catatan

   Ikuti rekomendasi wilayah di Catatan penggunaan saat Anda membuat atau menggunakan antrian.

3. Konfigurasikan notifikasi event untuk callback Simple Message Queue (formerly MNS) di ApsaraVideo VOD.

   Catatan

   Callback yang dikonfigurasi di Konsol ApsaraVideo VOD berlaku secara global untuk layanan ApsaraVideo VOD. Dengan OpenAPI, Anda dapat mengonfigurasi callback global atau meng-override callback untuk satu permintaan saja.

   Konfigurasi callback Simple Message Queue (formerly MNS) di Konsol

   1. Login ke Konsol ApsaraVideo VOD.

   2. Di panel navigasi sebelah kiri, pilih Configuration Management > Media Processing > Callback.

   3. Di bilah navigasi atas, klik wilayah layanan di sebelah Workbench dan beralih ke wilayah layanan target.

   4. Konfigurasikan Callback.

      1. Di sebelah kanan Callback, klik Modify.

      2. Konfigurasikan parameter callback.

         Nama Parameter	Deskripsi
         Callback Method	Pilih Simple Message Queue (formerly MNS).
         Region	Pilih wilayah tempat video yang ingin Anda konfigurasikan notifikasi event-nya disimpan. Kami merekomendasikan menggunakan wilayah yang sama dengan antrian Simple Message Queue (formerly MNS).
         Queue	Pilih antrian di wilayah tersebut. Catatan Jika tidak tersedia antrian, buat terlebih dahulu. Untuk informasi selengkapnya, lihat Buat antrian.
         Callback Event	Pilih jenis event yang ingin Anda terima notifikasinya sesuai kebutuhan. Untuk informasi selengkapnya tentang jenis event yang didukung oleh ApsaraVideo VOD dan makna setiap notifikasi event, lihat Daftar event. Catatan Jika Anda memilih Video AI Processing Complete, notifikasi akan dipicu setelah event AI apa pun selesai, termasuk AIMediaAuditComplete, AIMediaDNAComplete, dan AIVideoTagComplete.

      3. Klik OK untuk menyelesaikan konfigurasi callback untuk Simple Message Queue (formerly MNS).

   Konfigurasi callback Simple Message Queue (formerly MNS) menggunakan OpenAPI

   Anda dapat memanggil operasi API yang berbeda untuk mengonfigurasi callback global atau meng-override callback untuk satu permintaan saja.

   • Konfigurasi global: Panggil operasi Set event notification configuration. Atur parameter permintaan CallbackType ke Simple Message Queue (formerly MNS). Konfigurasikan parameter lainnya, seperti EventTypeList (jenis event callback), MnsEndpoint (titik akhir publik antrian pesan), dan MnsQueueName (nama antrian pesan).

   • Override permintaan tunggal: Saat Anda memanggil operasi API untuk mengunggah aset media atau mengirim pekerjaan pemrosesan media, Anda dapat menentukan bidang MessageCallback dalam parameter permintaan UserData untuk mengatur antrian callback untuk permintaan tersebut. Ini berlaku untuk operasi API berikut:

     • Dapatkan URL unggah dan kredensial untuk audio dan video

     • Dapatkan URL unggah dan kredensial untuk gambar

     • Dapatkan URL unggah dan kredensial untuk aset media pendukung

     • Unggah aset media berdasarkan URL secara Batch

     • Daftarkan informasi aset media

     • Kirim pekerjaan transkoding media

     • Kirim pekerjaan snapshot media

     • Kirim pekerjaan tinjauan otomatis untuk audio dan video

     • Komposit video

   Catatan

   Untuk mengatur callback dengan menentukan bidang MessageCallback dalam parameter UserData, Anda harus terlebih dahulu mengaktifkan notifikasi event global untuk ApsaraVideo VOD dan mengonfigurasi jenis event callback yang sesuai. Jika tidak, konfigurasi callback untuk permintaan tunggal tidak berlaku.

4. Picu event callback.

   Setelah Anda mengonfigurasi notifikasi event, Anda dapat melakukan operasi di ApsaraVideo VOD, seperti mengunggah aset media (audio, video, atau gambar) atau memulai pemrosesan media (seperti transkoding dan snapshot), untuk memicu event callback yang sesuai.

5. Lihat pesan di Simple Message Queue (formerly MNS).

   Ketika event callback dipicu, sisi server ApsaraVideo VOD menulis konten callback ke antrian yang ditentukan. Anda dapat mengambil pesan dari Simple Message Queue (formerly MNS) untuk melihat konten notifikasi event dalam detail pesan.

   Anda dapat mengambil pesan menggunakan Konsol atau API atau SDK. Untuk mengambil pesan dari Konsol, lihat Terima pesan. Untuk informasi selengkapnya tentang API dan SDK, lihat Ikhtisar API Antrian.

6. Opsional: Hapus pesan di Simple Message Queue (formerly MNS).

   Antrian mendukung akses konkuren dari beberapa produsen dan konsumen. Setelah pesan diambil, pesan tersebut menjadi invisible bagi konsumen lain selama periode tertentu. Anda harus secara eksplisit menghapus pesan setelah dikonsumsi. Jika tidak, pesan akan kembali visible setelah periode invisibility berakhir dan dapat dikonsumsi lagi.

   Anda dapat menerima pesan menggunakan Konsol, API, atau SDK. Untuk petunjuk Konsol, lihat Operasi antrian. Untuk informasi API dan SDK, lihat Ikhtisar API Antrian.

Contoh SDK

Simple Message Queue (formerly MNS) menyediakan SDK untuk beberapa bahasa pemrograman. Setelah Anda mengonfigurasi callback, Anda dapat menggunakan SDK berikut untuk mengonsumsi pesan:

• Untuk informasi tentang cara mengonsumsi pesan menggunakan kode Java, lihat Panduan Penggunaan Antrian.

• Untuk informasi selengkapnya tentang cara mengonsumsi pesan dengan Python, lihat Panduan Pengguna Antrian.

• Untuk mempelajari cara mengonsumsi pesan menggunakan kode C#, lihat Panduan Pengguna Antrian.

• Untuk petunjuk mengonsumsi pesan menggunakan kode PHP, lihat Panduan Pengguna Antrian.

• Untuk bahasa lain, Anda dapat memanggil operasi API untuk mengambil konten pesan. Pertama, pelajari metode pemanggilan. Kemudian, panggil operasi ReceiveMessage untuk mengambil konten pesan dan operasi DeleteMessage untuk menghapus pesan.

Referensi

• Untuk perbandingan antara callback HTTP dan callback MNS, lihat Perbandingan callback HTTP dan Simple Message Queue (formerly MNS).

• Jika Anda mengalami masalah, lihat FAQ tentang notifikasi event.