ApsaraVideo VOD:Pemutaran media

Cara kerja

Kemampuan memutar 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. Kemudian, panggil 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 Persyaratan nama domain. ApsaraVideo VOD tidak mewajibkan Anda mengonfigurasi nama domain CDN yang dipercepat (kebutuhan nama domain CDN bergantung pada cara Anda mengakses video): Jika Anda tidak mengonfigurasi nama domain yang dipercepat, Anda dapat memanggil operasi Get Video Playback URLs (GetPlayInfo) untuk memperoleh URL OSS yang berisi parameter otentikasi berbatas waktu dan menggunakannya untuk pemutaran (pemutaran tetap berfungsi meskipun tanpa nama domain yang dipercepat). Jika Anda mengonfigurasi nama domain yang dipercepat, Anda dapat menggunakan nama domain CDN untuk akses anonim atau menerapkan kontrol cache yang lebih fleksibel melalui penandatanganan URL. Kedua metode mendukung pemutaran normal, sehingga mengonfigurasi nama domain yang dipercepat bukan langkah wajib untuk pemutaran.

• Selesaikan rekaman CNAME untuk nama domain: Pastikan Anda telah menyambungkan rekaman CNAME ke nama domain. Jika tidak, pemutaran akan gagal. Untuk informasi selengkapnya, lihat Konfigurasikan rekaman CNAME dengan Alibaba Cloud DNS atau Konfigurasikan rekaman CNAME di DNSPod.

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

• 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 Keamanan video.

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 Penandatanganan URL.

  • 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 periode validitas default yang Anda konfigurasi dalam penandatanganan URL. Anda juga dapat menetapkan waktu kedaluwarsa saat Menghasilkan URL Pemutaran atau Memperoleh URL Pemutaran Video. Jika URL kedaluwarsa, Alibaba Cloud CDN akan mengembalikan HTTP 403 saat diakses.

    Contoh URL dinamis:

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

    Catatan

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

• Jika tidak ada nama domain yang dipercepat dikonfigurasi

  • Saat tidak ada nama domain yang dipercepat 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 - Sertakan Tanda Tangan dalam URL. Saat Anda memanggil API Get Video Playback URLs untuk memperoleh URL pemutaran, Anda masih dapat menggunakan parameter AuthTimeout untuk menentukan waktu hidup (TTL) untuk URL OSS video tersebut, tetapi Anda tidak dapat menyesuaikan informasi otentikasi berdasarkan AccessKey Anda.

  • 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, URL berlaku permanen, tetapi berisiko terhadap hotlinking dan unduhan ilegal. Oleh karena itu, Bucket penyimpanan sebaiknya diatur ke private bila memungkinkan.

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

Anda dapat memperoleh URL pemutaran dengan salah satu cara berikut:

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

• Menggunakan kredensial pemutaran: Gunakan SDK Pemutar ApsaraVideo dan panggil operasi GetVideoPlayAuth untuk memperoleh kredensial pemutaran. SDK Pemutar ApsaraVideo 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 mempermudah pratinjau video Anda.

  • 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 ApsaraVideo

  Sebelum mengintegrasikan SDK Pemutar ApsaraVideo, perhatikan persyaratan versi dan otentikasi berikut:

  Versi yang direkomendasikan: Gunakan SDK Pemutar ApsaraVideo versi 2.37.6 atau lebih baru. Versi ini menyelesaikan masalah kompatibilitas pemutaran HLS dengan browser Chrome 141+ dan Edge, memperbaiki rendering plugin yang tidak normal, serta mengatasi masalah kebocoran memori.

  Mulai dari versi SDK 2.28.0, otentikasi Lisensi bersifat wajib. Untuk mengonfigurasi Lisensi:

  1. Ajukan Kunci Lisensi di halaman Manajemen SDK di Konsol ApsaraVideo VOD. Lisensi edisi standar Web saat ini gratis.

  2. Saat inisialisasi pemutar, konfigurasikan parameter domain (nama domain halaman tempat pemutar disematkan, bukan domain penyimpanan video atau CDN) dan licenseKey.

  Untuk detail tentang cara memperoleh dan mengonfigurasi Lisensi, lihat Bagaimana cara memperoleh dan mengonfigurasi Lisensi Pemutar Web?

  Perubahan jalur resource: Mulai dari versi SDK 2.16.3, jalur URL untuk resource JS dan CSS telah berubah. Saat melakukan peningkatan, perbarui semua referensi resource ke jalur baru.

  Metode integrasi:

  • Pemutaran VID + PlayAuth: Peroleh kredensial pemutaran dari server dan kirimkan ke klien untuk pemutaran. Metode ini memberikan keamanan tinggi. Untuk informasi selengkapnya, lihat Memperoleh kredensial pemutaran.

  • Pemutaran berbasis URL: Kirimkan URL pemutaran yang diperoleh langsung ke pemutar. Untuk informasi selengkapnya, lihat Memutar video menggunakan URL pemutaran.

  • Memilih antara edisi standar dan edisi profesional: SDK Pemutar ApsaraVideo tersedia dalam edisi standar dan edisi profesional. Edisi profesional juga mendukung fitur lanjutan seperti encoding H.266, DASH, takarir eksternal, pra-pemuatan, pra-rendering, dan strategi ABR lanjutan, yang tidak termasuk dalam edisi standar. Jika Anda hanya memerlukan kontrol pemutaran dasar (seperti pemutaran video on-demand atau langsung, pemutaran kecepatan variabel, dan pengalihan resolusi), edisi standar sudah cukup. Jika Anda memerlukan fitur lanjutan yang disebutkan di atas, kami merekomendasikan Anda membeli edisi profesional.

  Penting

  Penting: Versi SDK yang lebih tinggi menerapkan validasi parameter yang lebih ketat. Dalam mode pemutaran berbasis URL, jangan tentukan parameter yang tidak kompatibel seperti format:m3u8, dan jangan mencampur parameter VID/PlayAuth. SDK tidak mendukung kompatibilitas mundur untuk semua API lama.

  • Watermark dinamis: Pemutar Web mendukung watermark dinamis (teks berjalan/flickering acak). Konfigurasikan menggunakan parameter watermark. Fitur ini dapat digunakan bersamaan dengan watermark statis yang dikonfigurasi di konsol.

  • Kontrol unduhan: Browser menyediakan tombol unduh bawaan yang tidak dapat dihapus melalui pengaturan tautan. Untuk mengontrol izin unduhan, integrasikan SDK dan gunakan parameter untuk mengelola perilaku unduhan.

  • Putar otomatis tanpa SDK: Saat tidak menggunakan SDK ApsaraVideo, terapkan putar otomatis dengan mengatur autoplay:true dan muted:true untuk mematuhi kebijakan putar otomatis browser.

  • Metode pemutaran MPS: Metode pemutaran MPS (menggunakan accId/accSecret) masih didukung tetapi tidak lagi dikelola. Kami merekomendasikan migrasi ke metode pemutaran yang direkomendasikan.

  • Blob URL: Pemutar baru mungkin menampilkan blob URL di bilah alamat. Ini merupakan perilaku MSE (Media Source Extensions) yang normal dan bukan kesalahan.

• Integrasikan pemutar pihak ketiga

  • Integrasikan pemutar pihak ketiga untuk memutar video menggunakan URL pemutaran.

  • Setelah memperoleh URL pemutaran, kirimkan ke pemutar Anda. Metode ini fleksibel tetapi mengharuskan Anda menerapkan fitur seperti pengalihan resolusi dan penanganan pengecualian.

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, penandatanganan URL, dan enkripsi video (Enkripsi privat Alibaba Cloud dan Enkripsi HLS). Untuk informasi selengkapnya, lihat Ikhtisar keamanan video.

• Keamanan akun

  Untuk memastikan keamanan akun Anda, jangan gunakan pasangan AccessKey Akun Alibaba Cloud atau Pengguna 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 troubleshooting kegagalan pemutaran video?

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

2. Kompatibilitas browser (Chrome/Edge 141+): Jika pemutaran m3u8 gagal, berkedip, atau mengembalikan error 4400 pada versi baru Chrome atau Edge, tingkatkan Pemutar Web ke versi 2.37.6 atau lebih baru dan verifikasi bahwa Lisensi dikonfigurasi dengan benar.

3. Validasi parameter: Dalam mode pemutaran berbasis URL, verifikasi bahwa Anda tidak salah mengatur format:m3u8 atau mencampur parameter VID dan PlayAuth. SDK menerapkan validasi parameter yang ketat pada versi yang lebih baru.

4. MEDIA_ERR_SRC_NOT_SUPPORTED atau fragLoadError (403): Periksa kemampuan pemutaran native Safari, konfigurasi CORS, daftar putih perlindungan hotlink, dan periode validitas PlayAuth (100 detik).

5. ERR_CONNECTION_TIMED_OUT: Periksa konektivitas jaringan lokal, aturan firewall, dan status CDN.

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

7. Periksa URL pemutaran atau kredensial: Verifikasi apakah auth_key telah kedaluwarsa atau tanda tangan masih valid.

8. Periksa pemutar: Pastikan pemutar mendukung format video. Untuk informasi tentang format yang didukung oleh Pemutar ApsaraVideo, lihat Fitur SDK Pemutar ApsaraVideo.

9. Pemutaran tersendat atau gagal saat browser seluler membuka langsung URL pemutaran yang disalin: Hal ini terjadi karena URL pemutaran tidak memiliki tanda tangan penandatanganan URL yang valid, atau nama domain memiliki perlindungan hotlink Referer yang diaktifkan dan memblokir permintaan. Solusi: Verifikasi apakah penandatanganan URL diaktifkan untuk URL pemutaran dan apakah URL tersebut membawa tanda tangan auth_key yang valid. Periksa konfigurasi daftar putih perlindungan hotlink Referer untuk nama domain tersebut. Kami merekomendasikan Anda menggunakan URL pemutaran bertanda tangan atau mengakses video melalui SDK Pemutar, bukan mengekspos URL pemutaran mentah secara langsung.

10. Audio dan video tidak sinkron selama pemutaran maju cepat di komponen video mini program WeChat: Hal ini terjadi karena komponen video native di mini program WeChat tidak sepenuhnya mendukung edit list di tingkat dasar, sehingga offset audio awal menumpuk selama pemutaran maju cepat atau operasi seek. Solusi: Kami merekomendasikan Anda menggunakan SDK Pemutar ApsaraVideo untuk web, bukan komponen video native, atau transkoding video untuk meningkatkan kompatibilitas.

11. Pemutar Web berhenti bekerja setelah peningkatan browser Chrome (masalah kompatibilitas HLS): Kami merekomendasikan Anda meningkatkan SDK Pemutar ApsaraVideo untuk web ke versi 2.37.8 atau lebih baru untuk menyelesaikan masalah kompatibilitas ini, dan ajukan serta konfigurasikan Lisensi gratis sesuai kebutuhan (untuk cara mengajukan Lisensi, lihat deskripsi di bagian "Prasyarat").

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. Kemudian, gunakan SDK Pemutar ApsaraVideo untuk mendekripsi dan memutar video. Untuk informasi selengkapnya, lihat Enkripsi video.

Pemutaran terenkripsi gagal dengan InvalidParameter, menunjukkan bahwa parameter Rand tidak valid

Jika pemutaran video terenkripsi gagal dengan error InvalidParameter yang menunjukkan bahwa parameter Rand tidak valid, Anda harus mengatur parameter encryptType yang sesuai dalam konfigurasi pemutaran. Untuk informasi selengkapnya, lihat petunjuk enkripsi video di Enkripsi video.

Apa saja catatan penggunaan untuk API SDK Pemutar umum?

Berikut adalah kesalahan umum dan pola penggunaan yang benar saat memanggil API SDK Pemutar:

• Mendapatkan posisi pemutaran di iOS: Gunakan parameter position dari callback onCurrentPositionUpdate. Setelah melakukan seek, dengarkan event AVPEventSeekEnd sebelum mengambil posisi.

• Nilai kembali getPlayTime(): Mengembalikan durasi pemutaran sebagai bilangan bulat dalam satuan detik. Nilai ini mencerminkan waktu pemutaran aktual (tidak termasuk jeda dan operasi seek). Selama pemutaran dengan kecepatan disesuaikan, durasi dihitung berdasarkan waktu fisik yang berlalu.

• Mengganti kualitas video dengan selectTrack: Jika selectTrack gagal saat mengganti kualitas, gunakan setQuality + setStartTime + prepare sebagai solusi sementara.

• Mengganti video dengan replayByVidAndPlayAuth: Saat mengganti video menggunakan replayByVidAndPlayAuth, kirimkan secara eksplisit parameter swScriptURL (URL HTTPS absolut) untuk mendukung enkripsi privat pada versi iOS lama.

• Mengatur waktu mulai: Mengatur waktu mulai pemutaran tidak memengaruhi operasi manual bilah seek oleh pengguna.

• Pembersihan buffer: SDK saat ini tidak mendukung API pembersihan buffer dinamis selama pemutaran.

Bagaimana cara memperoleh dan mengonfigurasi Lisensi Pemutar Web?

Pertanyaan umum tentang Lisensi Pemutar Web:

• Cara mengajukan: Ajukan Lisensi secara gratis di halaman Manajemen SDK di Konsol ApsaraVideo VOD.

• Pengikatan domain: Lisensi diikat ke nama domain yang ditampilkan di bilah alamat browser halaman tempat pemutar disematkan (subdomain didukung). Lisensi tidak diikat ke domain penyimpanan video atau akselerasi CDN.

• Tidak perlu file sertifikat: Lisensi adalah string Kunci yang diperoleh melalui API. Tidak perlu mengunduh atau men-deploy file sertifikat ke server Anda. Cukup kirimkan parameter domain dan licenseKey saat inisialisasi pemutar.

• Resource video bersama: Lisensi berbeda dapat berbagi resource video yang sama.

• Debugging lokal dengan HTTPS: Jika validasi Lisensi gagal karena masalah sertifikat HTTPS selama pengujian lokal, Anda dapat menggunakan salah satu metode berikut (hanya untuk pengujian):

  • Gunakan mkcert untuk menghasilkan Sertifikat tanda tangan sendiri.

  • Tambahkan flag --ignore-certificate-errors saat meluncurkan Chrome.

  • Deploy ke server uji HTTPS yang valid.

• SDK 2.34 dan lebih baru: Konfigurasi Lisensi bersifat wajib agar pemutar berfungsi dengan baik.

• Kepatuhan data untuk versi SDK lama: Versi lama SDK Pemutar ApsaraVideo untuk web memiliki masalah kepatuhan data. Jika Anda menggunakan pemutar di luar Tiongkok Daratan, Anda harus meningkatkan ke versi yang memerlukan Lisensi dan mengikat Lisensi yang valid. Untuk cara mengajukan dan mengonfigurasi Lisensi, lihat FAQ Lisensi.

Bagaimana menangani masalah gaya dan komponen Pemutar Web?

Masalah umum dan solusi untuk gaya dan komponen pemutar:

• Ikon hilang saat deployment lokal: Jika ikon hilang selama deployment lokal, unduh direktori lengkap /skins/default/ atau perbarui jalur relatif di CSS untuk menggunakan alamat CDN.

• Kesalahan pengalihan kualitas QualityComponent: Saat mengganti kualitas menggunakan QualityComponent, jika Anda mengalami error t.getQuality is not a function, tambahkan fungsi callback args ke konfigurasi Anda dan tingkatkan aliplayercomponents ke versi 1.1.2 atau lebih baru.

• Gambar sampul tumpang tindih bilah progres (mode VID + PlayAuth): Saat gambar sampul tumpang tindih bilah progres dalam mode VID + PlayAuth, sembunyikan menggunakan CSS (.prism-cover) atau aktifkan autoplay + muted untuk menghindari masalah tersebut.

• Kompatibilitas HLS browser WeChat: Untuk masalah pemutaran HLS di browser WeChat bawaan, konfigurasikan useHlsNative: false untuk memaksa solusi pemutaran fMP4.

Bagaimana menentukan versi saat menginstal SDK Pemutar melalui npm?

Untuk menginstal versi tertentu SDK Pemutar, gunakan perintah berikut:

npm install aliyun-aliplayer@<version> --save

Contohnya, untuk menginstal versi 2.27.1:

npm install aliyun-aliplayer@2.27.1 --save