ApsaraVideo VOD:Pemutaran media

Cara kerja

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

Diagram berikut menunjukkan perubahan status video dari unggahan hingga pemutaran:

• Dengan transcoding

• Tanpa transcoding

Oleh karena itu, pastikan status video telah berubah menjadi Normal sebelum memperoleh URL pemutaran.

Metode penentuan

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

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

• Untuk video yang ditranskode, Anda dapat memutarnya setelah menerima notifikasi event Single definition transcoding complete. Untuk memastikan semua definisi tersedia, tunggu hingga Anda menerima notifikasi event Transcode complete sebelum memproses video tersebut.

Prasyarat

• Konfigurasikan nama domain yang dipercepat. Untuk informasi selengkapnya, lihat Persyaratan nama domain. ApsaraVideo VOD tidak mewajibkan Anda mengonfigurasi nama domain yang dipercepat. Kebutuhan konfigurasi nama domain CDN bergantung pada cara Anda mengakses video: Jika Anda tidak mengonfigurasi nama domain yang dipercepat, Anda dapat memanggil operasi GetPlayInfo (GetPlayInfo) untuk memperoleh URL OSS yang membawa parameter otentikasi berbatas waktu, lalu menggunakan URL tersebut untuk pemutaran. Pemutaran tetap berfungsi meskipun Anda tidak mengonfigurasi nama domain yang dipercepat. Setelah Anda mengonfigurasi nama domain yang dipercepat, Anda dapat menggunakan nama domain CDN untuk akses anonim atau menggunakan penandatanganan URL untuk menerapkan kontrol cache yang lebih fleksibel. Kedua metode mendukung pemutaran normal, sehingga mengonfigurasi nama domain yang dipercepat bukan langkah wajib untuk memutar video.

• Selesaikan record CNAME nama domain: Pastikan record CNAME telah disambungkan ke nama domain. Jika tidak, pemutaran akan gagal. Untuk informasi cara menyambungkan record CNAME, lihat Konfigurasi record CNAME dengan Alibaba Cloud DNS. Record CNAME yang dikonfigurasi di DNSPod juga didukung.

• Konfirmasi konfigurasi transcoding: ApsaraVideo VOD dapat mentranskode atau tidak mentranskode file media yang Anda unggah. Untuk informasi selengkapnya, lihat Transkoding audio dan video.

• Konfirmasi konfigurasi keamanan: ApsaraVideo VOD menyediakan berbagai mekanisme untuk melindungi konten video Anda, termasuk kontrol akses, penandatanganan URL, otentikasi jarak jauh, enkripsi video, dan unduhan aman. Kemampuan memutar video bergantung pada konfigurasi keamanan ini. Untuk informasi selengkapnya, lihat Keamanan video.

• Konfigurasikan License untuk SDK Pemutar ApsaraVideo untuk web: Mulai versi 2.37.8 SDK Pemutar ApsaraVideo untuk web, Anda harus mengonfigurasi License untuk menggunakan SDK tersebut. License yang valid juga diperlukan di lingkungan pengujian localhost, dan tidak tersedia License sementara. Buat Web Application di konsol ApsaraVideo VOD dan beli License binding secara gratis. Setelah memperoleh License Key dan nama domain yang di-bind, integrasikan kode tersebut. Versi SDK sebelumnya memiliki masalah kepatuhan data. Jika Anda menggunakan SDK di luar Tiongkok daratan, Anda harus melakukan upgrade ke versi SDK baru dan mengikat License. Untuk langkah-langkah detail mengajukan dan mengonfigurasi License, lihat FAQ License untuk SDK Pemutar ApsaraVideo untuk web.

URL pemutaran

• Konfigurasikan nama domain yang dipercepat

  Setelah Anda mengonfigurasi nama domain yang dipercepat di konsol ApsaraVideo VOD, URL pemutaran video berupa URL file CDN. Anda dapat melihat URL tersebut di halaman Audio/Video > Manage > Video URL di konsol ApsaraVideo VOD. URL pemutaran terdiri dari dua jenis, tetap dan dinamis, tergantung pada apakah sakelar penandatanganan URL diaktifkan dalam manajemen nama domain. Untuk informasi cara mengaktifkan dan mengonfigurasi penandatanganan URL, lihat Penandatanganan URL.

  • Alamat tetap

    Alamat tetap cocok untuk skenario dengan persyaratan keamanan rendah. Alamat ini berlaku permanen dan tidak mengandung informasi otentikasi setelah Anda mematikan sakelar otentikasi. Nilai parameter auth_key dalam URL merupakan informasi otentikasi. Secara default, sakelar otentikasi dimatikan setelah Anda menambahkan nama domain di konsol.

  • Alamat dinamis

    Alamat dinamis cocok untuk skenario dengan persyaratan keamanan tinggi. Alamat ini dibuat secara dinamis dan kedaluwarsa setelah periode tertentu. Periode validitas default alamat dinamis adalah periode validitas default yang Anda konfigurasi dalam penandatanganan URL. Anda juga dapat menetapkan waktu kedaluwarsa saat Menghasilkan URL Pemutaran atau memanggil GetPlayInfo. Jika alamat kedaluwarsa, CDN akan mengembalikan HTTP 403 saat alamat tersebut diakses.

    Contoh alamat dinamis:

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

    Catatan

    Dalam contoh ini, nilai parameter auth_key diawali dengan awalan 1500523200, yang sesuai dengan pukul 12:00:00 pada 20 Juli 2017. Jika Periode Validitas Default diatur ke 60 menit, alamat tersebut kedaluwarsa pada pukul 13:00:00 tanggal 20 Juli 2017.

• Nama domain yang dipercepat tidak dikonfigurasi

  • Jika Anda tidak mengonfigurasi nama domain yang dipercepat, URL pemutaran yang dikembalikan berupa URL file OSS. Dalam kasus ini, penandatanganan URL tidak tersedia, tetapi informasi otentikasi OSS dihasilkan secara default. Untuk informasi selengkapnya, lihat OSS - Sertakan Signature dalam URL. Saat Anda memanggil operasi GetPlayInfo untuk memperoleh URL pemutaran, Anda tetap dapat menggunakan parameter AuthTimeout untuk menentukan waktu kedaluwarsa URL OSS video tersebut, tetapi Anda tidak dapat menyesuaikan informasi otentikasi berdasarkan AccessKey.

  • Jika Anda mengatur Bucket penyimpanan ke public-read di halaman Storage Management di konsol, Anda dapat mengabaikan informasi otentikasi OSS. Untuk informasi selengkapnya, lihat Manajemen Penyimpanan. Dalam kasus ini, alamat berlaku permanen, tetapi video berisiko terkena hotlinking dan unduhan ilegal. Oleh karena itu, atur Bucket penyimpanan ke private bila memungkinkan.

Untuk informasi selengkapnya tentang pengaturan umum URL pemutaran, lihat Pengaturan pemutaran umum.

Anda dapat memperoleh URL pemutaran dengan salah satu cara berikut:

• Peroleh langsung: lihat notifikasi event yang dikirim setelah transcoding selesai, atau panggil operasi GetPlayInfo.

• Tukar secara otomatis menggunakan kredensial pemutaran: gunakan SDK Pemutar ApsaraVideo dan panggil operasi GetVideoPlayAuth untuk memperoleh kredensial pemutaran. SDK Pemutar ApsaraVideo secara otomatis menggunakan kredensial pemutaran tersebut untuk memperoleh URL pemutaran dan memutar video.

Metode pemutaran

• Pratinjau di konsol ApsaraVideo VOD

  Pemutar pratinjau ApsaraVideo VOD menyediakan fitur seperti maju cepat, pengaturan volume, teks tertutup, trek audio, definisi, dan komentar langsung, sehingga pratinjau video menjadi lebih mudah.

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

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

• Integrasikan SDK Pemutar ApsaraVideo

  • Anda dapat memperoleh kredensial pemutaran dari server dan mengirimkannya kembali ke klien untuk pemutaran. Metode ini lebih aman. Untuk informasi selengkapnya, lihat Memperoleh kredensial pemutaran. Saat menggunakan SDK Pemutar ApsaraVideo untuk web, perhatikan bahwa Anda harus mengonfigurasi License. Persyaratan spesifiknya dapat dilihat di bagian "Prasyarat".

  • Pemutar ApsaraVideo mendukung pemutaran video langsung menggunakan URL pemutaran. Anda dapat langsung memberikan URL pemutaran yang diperoleh ke pemutar. Untuk informasi selengkapnya, lihat Memutar video menggunakan URL pemutaran.

  • SDK Pemutar ApsaraVideo tersedia dalam edisi standar dan edisi profesional. Edisi profesional tambahan mendukung fitur lanjutan seperti enkode H.266, protokol DASH, subtitle eksternal, pra-pemuatan, pra-rendering, dan strategi ABR lanjutan. Edisi standar tidak mencakup fitur-fitur tersebut. Jika Anda hanya membutuhkan fitur kontrol pemutaran dasar, seperti pemutaran video on-demand atau live, pemutaran kecepatan variabel, dan pengalihan resolusi, edisi standar sudah cukup. Jika Anda memerlukan fitur lanjutan yang dijelaskan di atas, kami merekomendasikan Anda membeli edisi profesional.

• Integrasikan pemutar pihak ketiga

  • Anda dapat mengintegrasikan pemutar pihak ketiga untuk memutar video menggunakan URL pemutaran.

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

Keamanan pemutaran (batasan pemutaran dan unduhan)

• Keamanan video

  Untuk melindungi konten video Anda, ApsaraVideo VOD menyediakan berbagai fitur keamanan, termasuk daftar hitam dan daftar putih, penandatanganan URL, dan enkripsi video (Enkripsi privat Alibaba Cloud dan Enkripsi HLS). Untuk informasi selengkapnya, lihat Ikhtisar keamanan video.

• Keamanan akun

  Untuk memastikan keamanan, jangan menempatkan pasangan Kunci Akses Akun Alibaba Cloud atau Pengguna Resource Access Management (RAM) di klien, terutama klien web, untuk mengakses ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Ikhtisar.

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 Penagihan layanan dasar.

FAQ

Bagaimana cara mengatasi kegagalan pemutaran video?

1. Periksa jaringan: Pastikan klien memiliki konektivitas jaringan normal.

2. Periksa status video: Panggil operasi 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 apakah signature-nya benar.

4. Periksa pemutar: Pastikan pemutar yang Anda gunakan mendukung format video tersebut. Untuk informasi format yang didukung oleh Pemutar ApsaraVideo, lihat Fitur SDK Pemutar ApsaraVideo.

5. Gangguan atau kegagalan pemuatan saat browser seluler membuka langsung URL pemutaran yang disalin: Hal ini terjadi karena URL pemutaran tidak membawa signature penandatanganan URL, atau karena nama domain memiliki perlindungan hotlink Referer yang diaktifkan dan permintaan diblokir. Solusi: Periksa apakah penandatanganan URL diaktifkan untuk URL pemutaran tersebut dan apakah URL membawa signature auth_key yang valid. Periksa konfigurasi daftar putih perlindungan hotlink Referer nama domain tersebut. Kami merekomendasikan Anda menggunakan URL pemutaran bertanda tangan atau mengakses video melalui SDK Pemutar ApsaraVideo, bukan langsung mengekspos URL pemutaran asli.

6. Audio dan video tidak sinkron selama pemutaran kecepatan variabel di komponen video mini program WeChat: Hal ini terjadi karena komponen video native mini program WeChat tidak sepenuhnya mendukung edit list di level dasar, sehingga offset audio awal terakumulasi dan diperkuat selama pemutaran kecepatan variabel atau operasi seek. Solusi: Kami merekomendasikan Anda menggunakan SDK Pemutar ApsaraVideo untuk web, bukan komponen video native, atau transkode video tersebut untuk meningkatkan kompatibilitas.

7. Pemutar web berhenti berfungsi setelah upgrade browser Chrome (masalah kompatibilitas HLS): Kami merekomendasikan Anda melakukan upgrade SDK Pemutar ApsaraVideo untuk web ke versi 2.37.8 atau lebih baru untuk mengatasi masalah kompatibilitas ini, serta mengajukan dan mengonfigurasi License gratis sesuai kebutuhan. Untuk informasi cara mengajukan License, lihat penjelasan di bagian "Prasyarat".

Untuk informasi selengkapnya tentang exception lainnya, lihat Mengatasi error pemutaran.

Bagaimana cara memutar video terenkripsi?

ApsaraVideo VOD menyediakan berbagai solusi enkripsi, seperti Enkripsi privat Alibaba Cloud dan Enkripsi HLS. Anda harus mengonfigurasi kelompok template transkoding terenkripsi untuk mentranskode video tersebut, dan menggunakan SDK Pemutar ApsaraVideo untuk mendekripsi dan memutarnya. Untuk informasi selengkapnya, lihat Enkripsi video.

Pemutaran terenkripsi menghasilkan error InvalidParameter dan menunjukkan bahwa parameter Rand tidak valid

Jika error InvalidParameter muncul dan parameter Rand ditunjukkan sebagai tidak valid saat Anda memutar video terenkripsi, Anda harus mengatur parameter encryptType yang sesuai dalam konfigurasi pemutaran. Untuk informasi metode konfigurasi, lihat Enkripsi video.