All Products
Search
Document Center

ApsaraVideo VOD:Dapatkan URL pemutaran

Last Updated:Aug 07, 2026

Anda dapat memperoleh URL pemutaran melalui notifikasi event atau panggilan API/SDK.

Dapatkan URL melalui notifikasi event

Anda dapat menerima notifikasi event saat aliran video dikodekan ulang ke definisi tertentu (StreamTranscodeComplete) atau ketika semua aliran yang telah dikodekan ulang selesai dihasilkan (TranscodeComplete). Notifikasi tersebut berisi URL pemutaran. Simpan URL ini di server Anda dan kembalikan ke klien saat menerima permintaan pemutaran.

Catatan

Metode ini ideal untuk pemutaran dengan konkurensi tinggi. Dengan menyimpan cache URL di server Anda dan memanaskan konten terlebih dahulu menggunakan fitur purge and prefetch, Anda dapat menangani jutaan penonton secara bersamaan. Lihat Purge and prefetch.

Catatan penggunaan

  • URL pemutaran yang diperoleh dari notifikasi event adalah static URLs. Jika URL signing diaktifkan, Anda harus membuat signed URL sendiri.

  • Jika Anda menonaktifkan atau menghapus domain lama, gantilah dengan domain baru saat mengambil kembali URL pemutaran yang tersimpan.

  • Jika Enkripsi video dikonfigurasi, URL pemutaran yang dikembalikan mengarah ke aliran terenkripsi yang harus didekripsi oleh pemutar sebelum diputar.

Dapatkan URL melalui panggilan API/SDK

Saat Anda mengunggah file media ke ApsaraVideo VOD, sebuah VideoId akan diberikan. Panggil operasi GetPlayInfo dengan VideoId untuk memperoleh URL pemutaran.

Catatan penggunaan

  • Secara default, operasi ini hanya mengembalikan aliran terbaru yang telah dikodekan ulang untuk setiap definisi dan format. Saat memanggil API GetPlayInfo, Anda dapat mengatur ResultType ke Multiple untuk memperoleh semua aliran yang telah selesai untuk video tersebut.

  • Jika Anda telah mengaktifkan Alibaba Cloud proprietary cryptography, video hanya dapat diputar menggunakan Pemutar Video Apsara. Secara default, API GetPlayInfo tidak mengembalikan aliran yang dienkripsi secara privat. Anda dapat mengatur ResultType ke Multiple untuk memperoleh semua aliran yang telah selesai, termasuk yang terenkripsi.

  • Jika Anda telah mengaktifkan HLS encryption, API akan mengembalikan aliran terenkripsi standar sebagai prioritas untuk pemutaran secara default.

  • Jika Anda telah mengonfigurasi tiered storage untuk file media Anda, API ini berperilaku sebagai berikut:

    • Secara default, API mengembalikan aliran pemutaran untuk kelas penyimpanan Standard. Untuk tier non-standar seperti Archive, API tidak mengembalikan aliran pemutaran. Jika file sumber berada di tier non-standar, API mengembalikan aliran yang telah dikodekan ulang tetapi tidak mengembalikan aliran video sumber.

    • Anda dapat mengatur bidang StorageClass di dalam parameter PlayConfig untuk meminta aliran dari tier penyimpanan non-standar tertentu.

  • Dalam periode validitas, URL pemutaran tidak dibatasi untuk perangkat tertentu. Banyak perangkat (PC, perangkat seluler, SDK Pemutar Video Apsara, dll.) dapat menggunakan URL pemutaran yang sama untuk memutar video secara bersamaan, dan pemutar tidak membatasi penggunaan ulang URL tersebut.

Alur kerja

Diagram berikut menunjukkan alur kerja untuk memperoleh dan memutar video melalui domain yang dipercepat CDN.

  1. Klien mengirim permintaan ke server aplikasi Anda untuk memperoleh URL pemutaran.

  2. Server memanggil GetPlayInfo menggunakan Server SDK untuk mendapatkan otorisasi pemutaran.

  3. ApsaraVideo VOD mengembalikan URL pemutaran ke server.

  4. Server mengembalikan URL pemutaran ke klien.

  5. Pemutar klien meminta resource media berdasarkan URL pemutaran yang dikembalikan.

  6. Jika resource tidak tersedia di cache CDN POP atau cache telah kedaluwarsa, CDN melakukan origin-pull dari Bucket OSS.

  7. Bucket OSS mengembalikan resource ke CDN POP, yang kemudian menyimpan resource tersebut di cache.

  8. CDN POP menyajikan resource media ke klien.

Langkah selanjutnya