ApsaraVideo VOD：Pemutaran media

Cara kerja

Kemampuan pemutaran file audio atau video bergantung pada Status-nya. Hanya video dengan status Normal (bidang Status bernilai Normal) yang dapat diputar. Anda dapat memperoleh URL pemutaran video tersebut melalui API atau SDK ApsaraVideo VOD.

Diagram berikut menunjukkan perubahan status video dari unggah hingga pemutaran.

• Dengan transkoding

  

• Tanpa transkoding

  

Oleh karena itu, pastikan status video adalah Normal sebelum memperoleh URL pemutaran.

Metode Penentuan

Setelah mengunggah video, video tersebut tidak langsung siap diputar. ApsaraVideo VOD harus terlebih dahulu memastikan bahwa video telah diterima. Gunakan notifikasi event untuk mengetahui kapan video yang diunggah siap diputar.

• Untuk file video atau audio yang tidak ditranskoding, Anda dapat memutarnya setelah menerima notifikasi event Video upload completed. Selanjutnya, Anda dapat memanggil operasi GetPlayInfo untuk memperoleh URL pemutaran. Hanya file dalam format berikut yang dapat diputar langsung tanpa transkoding: MP4, FLV, M3U8, MP3, dan WEBM.

• Untuk video yang ditranskoding, Anda dapat memutarnya setelah menerima notifikasi event Single Definition Transcoding Complete. Untuk memastikan semua definisi tersedia, tunggu hingga menerima notifikasi event Transcode complete sebelum memproses video tersebut.

Prasyarat

• Konfigurasikan nama domain yang dipercepat Untuk informasi selengkapnya, lihat Domain name requirements.

• Selesaikan rekaman CNAME untuk nama domain: Pastikan Anda telah menyambungkan rekaman CNAME ke nama domain tersebut. Jika tidak, pemutaran akan gagal. Untuk informasi selengkapnya, lihat Configure a CNAME record with Alibaba Cloud DNS atau Configure a CNAME record on DNSPod.

• Konfirmasi konfigurasi transkoding: ApsaraVideo VOD dapat mentranskoding atau tidak mentranskoding file media yang Anda unggah. Untuk informasi selengkapnya, lihat Audio and video transcoding.

• Konfirmasi konfigurasi keamanan: ApsaraVideo VOD menyediakan berbagai fitur keamanan untuk melindungi konten video Anda. Fitur-fitur tersebut mencakup kontrol akses, penandatanganan URL, otentikasi jarak jauh, enkripsi video, dan unduhan aman. Konfigurasi keamanan ini menentukan apakah video dapat diputar. Untuk informasi selengkapnya, lihat Video security.

URL pemutaran

• Konfigurasikan nama domain yang dipercepat.

  Setelah Anda mengonfigurasi nama domain yang dipercepat di Konsol ApsaraVideo VOD, URL pemutaran menjadi URL file CDN. Anda dapat melihat URL tersebut di halaman Audio/Video > Manage > Video URL di konsol. URL pemutaran dapat bersifat tetap atau dinamis, tergantung pada apakah Anda mengaktifkan penandatanganan URL dalam manajemen nama domain. Untuk informasi tentang cara mengaktifkan dan mengonfigurasi penandatanganan URL, lihat URL signing.

  • Alamat Tetap

    Cocok untuk skenario dengan persyaratan keamanan rendah, alamat ini tetap berlaku secara permanen—yaitu alamat yang tidak mengandung informasi otentikasi setelah Anda menonaktifkan sakelar otentikasi (nilai parameter auth_key dalam URL merupakan informasi otentikasi). Secara default, sakelar otentikasi dinonaktifkan setelah Anda menambahkan nama domain ke konsol.

  • Alamat dinamis

    URL dinamis cocok untuk skenario dengan persyaratan keamanan tinggi. URL ini dihasilkan secara dinamis dan kedaluwarsa setelah periode tertentu. Periode validitas default untuk URL dinamis adalah default validity period yang Anda konfigurasi dalam penandatanganan URL. Anda juga dapat menetapkan waktu kedaluwarsa saat Generate Playback URLs atau Obtain Video Playback URLs. Jika URL kedaluwarsa, Alibaba Cloud CDN akan mengembalikan respons HTTP 403 saat diakses.

    Contoh URL dinamis:

    http://example.aliyundoc.com/video/aliyun-sample.mp4?auth_key=1500523200-0-0-80cd3862d699b7118eed99103f2a****

    Catatan

    Pada contoh ini, nilai parameter auth_key dimulai dengan 1500523200, yang sesuai dengan pukul 12:00:00 pada 20 Juli 2017. Jika Default Validity Period diatur menjadi 60 menit, URL tersebut kedaluwarsa pada pukul 13:00:00 tanggal 20 Juli 2017.

• Jika tidak ada nama domain yang dipercepat yang dikonfigurasi

  • Saat tidak ada nama domain yang dipercepat yang dikonfigurasi, URL pemutaran yang dikembalikan adalah URL file OSS. Dalam kasus ini, penandatanganan URL tidak tersedia, tetapi informasi otentikasi OSS dihasilkan secara default. Untuk informasi selengkapnya, lihat OSS - Include Signatures in URLs. Saat Anda memanggil API Get Video Playback URLs untuk memperoleh URL pemutaran, Anda masih dapat menggunakan parameter AuthTimeout untuk menentukan waktu hidup (TTL) URL OSS video tersebut, tetapi Anda tidak dapat menyesuaikan informasi otentikasi berdasarkan AccessKey Anda.

  • Jika Anda mengatur Bucket penyimpanan ke mode public-read di halaman Storage Management di konsol, Anda dapat mengabaikan informasi otentikasi OSS (untuk informasi selengkapnya, lihat Storage Management). Dalam kasus ini, URL berlaku permanen, tetapi berisiko terkena hotlinking dan unduhan ilegal. Oleh karena itu, sebaiknya atur Bucket penyimpanan ke mode private jika memungkinkan.

Untuk informasi selengkapnya tentang pengaturan umum URL pemutaran, lihat Common playback settings.

Anda dapat memperoleh URL pemutaran dengan salah satu cara berikut:

• Secara langsung: Lihat notifikasi event setelah transkoding selesai, atau panggil operasi GetPlayInfo.

• Menggunakan kredensial pemutaran: Gunakan SDK Pemutar Video Apsara dan panggil operasi GetVideoPlayAuth untuk memperoleh kredensial pemutaran. SDK Pemutar Video Apsara secara otomatis menggunakan kredensial tersebut untuk memperoleh URL pemutaran.

Metode pemutaran

• Pratinjau di Konsol ApsaraVideo VOD

  Pemutar pratinjau ApsaraVideo VOD menyediakan fitur seperti maju cepat, pengaturan volume, takarir, trek audio, pengalihan resolusi, dan komentar langsung. Fitur-fitur ini memudahkan Anda mempratinjau video.

  • Di halaman Audio/Video di konsol, pilih video untuk dipratinjau. Aliran terenkripsi diputar secara default.

  • Di halaman Audio/Video > Manage > Video URL di konsol, pilih aliran untuk dipratinjau. Untuk memastikan keamanan video, hanya aliran yang tidak terenkripsi yang dapat dipratinjau.

• Integrasikan SDK Pemutar Video Apsara

  • Peroleh kredensial pemutaran dari server dan kirimkan ke klien untuk pemutaran. Metode ini memberikan keamanan tinggi. Untuk informasi selengkapnya, lihat Obtain a playback credential.

  • Pemutar Video Apsara mendukung pemutaran berbasis URL. Anda dapat langsung memberikan URL pemutaran yang diperoleh ke pemutar. Untuk informasi selengkapnya, lihat Play a video using a playback URL.

• Integrasikan pemutar pihak ketiga

  • Mengintegrasikan pemutar pihak ketiga untuk memutar video melalui URL pemutaran.

  • Setelah memperoleh URL pemutaran, berikan URL tersebut ke pemutar Anda. Metode ini fleksibel tetapi mengharuskan Anda mengimplementasikan fitur seperti pengalihan resolusi dan penanganan exception.

Keamanan pemutaran (batasan pemutaran dan unduhan)

• Keamanan video

  Untuk melindungi konten video Anda, ApsaraVideo VOD menyediakan berbagai fitur keamanan. Fitur-fitur tersebut mencakup daftar hitam dan daftar putih, URL signing, dan enkripsi video (Alibaba Cloud proprietary cryptography dan HLS encryption). Untuk informasi selengkapnya, lihat Video security overview.

• Keamanan akun

  Untuk memastikan keamanan akun Anda, jangan gunakan pasangan Kunci Akses Akun Alibaba Cloud atau Pengguna RAM di sisi klien, terutama klien web, untuk mengakses ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Overview.

Deskripsi penagihan

• Jika Anda mengonfigurasi nama domain yang dipercepat, Anda akan dikenai biaya untuk layanan CDN saat file audio atau video diputar.

• Jika Anda tidak mengonfigurasi nama domain yang dipercepat, Anda akan dikenai biaya untuk lalu lintas keluar dari penyimpanan saat file audio atau video diputar.

Untuk informasi selengkapnya, lihat Basic service billing.

FAQ

Bagaimana cara troubleshooting kegagalan pemutaran video?

1. Periksa jaringan: Pastikan klien memiliki koneksi jaringan yang normal.

2. Periksa status video: panggil API Get Audio and Video Playback URLs atau periksa di konsol apakah status video adalah Normal.

3. Periksa URL pemutaran atau kredensial: periksa apakah auth_key telah kedaluwarsa atau signature-nya valid.

4. Periksa pemutar: Pastikan pemutar mendukung format video tersebut. Untuk informasi tentang format yang didukung oleh Pemutar Video Apsara, lihat Features of ApsaraVideo Player SDK.

Untuk informasi selengkapnya tentang troubleshooting error lainnya, lihat Troubleshoot playback errors.

Bagaimana cara memutar video terenkripsi?

ApsaraVideo VOD menawarkan berbagai metode enkripsi, seperti enkripsi privat Alibaba Cloud dan enkripsi HLS. Untuk menggunakan enkripsi, konfigurasikan kelompok template transkoding terenkripsi untuk mentranskoding video tersebut. Kemudian, gunakan SDK Pemutar Video Apsara untuk mendekripsi dan memutar video. Untuk informasi selengkapnya, lihat Video encryption.