Pengantar SDK Pemutar ApsaraVideo untuk web - ApsaraVideo VOD

Anda dapat mengintegrasikan SDK Pemutar ApsaraVideo untuk web ke dalam aplikasi web Anda. SDK ini menyediakan pemutaran video untuk skenario streaming langsung dan video sesuai permintaan (VOD). Topik ini menjelaskan fitur-fitur SDK Pemutar ApsaraVideo untuk web serta kompatibilitas browser-nya.

Ikhtisar

SDK Pemutar ApsaraVideo untuk web menggunakan tag <video> HTML5 (H5) untuk memutar video dalam aplikasi web. SDK ini kompatibel dengan berbagai browser, seperti Chrome dan Safari, guna memastikan pemutaran video yang konsisten di berbagai platform. Saat digunakan bersama ApsaraVideo Live dan ApsaraVideo VOD, SDK ini juga mendukung fitur-fitur seperti Perlindungan hotlink, pemutaran terenkripsi untuk video berhak cipta, dan Pemantauan kualitas.

Peningkatan lisensi

Mulai 1 Desember 2024, Anda harus mendapatkan lisensi untuk menggunakan SDK Pemutar ApsaraVideo untuk web versi 2.28.0 dan yang lebih baru. Untuk petunjuknya, lihat Mengelola lisensi. Jika Anda menggunakan versi sebelum 2.28.0, perubahan ini tidak memengaruhi Anda. Namun, kami menyarankan agar Anda meningkatkan ke versi terbaru untuk mendapatkan layanan dan dukungan yang lebih komprehensif.

Protokol yang didukung

Skenario VOD

Tabel berikut menjelaskan protokol pemutaran VOD dan format encoding yang didukung oleh SDK Pemutar ApsaraVideo untuk web.

Format encoding video	Protokol video	Format file audio	Format pengodean audio
H.264	MP4 FLV HLS	MP3	AAC
H.265 Catatan Untuk memutar aliran video berencoding H.265, Anda harus terlebih dahulu mengisi formulir untuk mengajukan permohonan lisensi. Beberapa browser tidak mendukung pemutaran video H.265. Mengaktifkan pemutaran video H.265 meningkatkan konsumsi lalu lintas dan latensi startup.	MP4 FLV HLS	-
H.266 Catatan Untuk memutar aliran video berencoding H.266, Anda harus terlebih dahulu mengisi formulir untuk mengajukan permohonan lisensi. Beberapa browser tidak mendukung pemutaran video H.266. Mengaktifkan pemutaran video H.266 meningkatkan konsumsi lalu lintas dan latensi startup.	MP4	-

Skenario streaming langsung

Tabel berikut menjelaskan protokol pemutaran streaming langsung dan format encoding yang didukung oleh SDK Pemutar ApsaraVideo untuk web.

Format encoding video	Protokol video	Format coding audio	Format file audio
H.264	HLS, FLV, RTS, DASH	AAC	-
H.265	HLS, FLV (codecId=12)
H.266	HLS, FLV

Tabel berikut menjelaskan manfaat dan batasan dari setiap protokol streaming langsung.

Protokol streaming langsung	Keuntungan	Kerugian	Latensi
HLS	Kompatibilitas browser tinggi.	Latensi tinggi.	> 10s
FLV	Mendukung skenario konkurensi tinggi dan lebih cocok untuk aplikasi native.	Browser harus diintegrasikan dengan SDK Pemutar ApsaraVideo untuk web untuk pemutaran.	1 hingga 3 detik
RTS	Berkinerja baik dalam kondisi jaringan buruk. Video dapat diputar dengan lancar bahkan dengan tingkat kehilangan paket sebesar 30%.	Browser harus diintegrasikan dengan SDK Pemutar ApsaraVideo untuk web untuk pemutaran.	< 1s
DASH	Bitrate adaptif.	Latensi tinggi.	> 10s

Kompatibilitas Browser

Kompatibilitas browser desktop

Penting

Untuk memutar video FLV dan HLS pada browser desktop, Anda harus mengaktifkan akses lintas domain.

Browser	MP4	FLV	HLS	MP3
Chrome	✓	34 dan yang lebih baru	34 dan yang lebih baru	✓
Firefox	✓	49 dan yang lebih baru	49 dan yang lebih baru	✓
Edge	✓	✓	✓	✓
Opera	✓	✓	✓	✓
Safari	✓	8 dan yang lebih baru	8 dan yang lebih baru	✓

Kompatibilitas browser seluler

Catatan

SDK Pemutar ApsaraVideo untuk web tidak mendukung pemutaran video FLV pada perangkat seluler.

Tabel 1. Kompatibilitas browser H5 pada Android

Browser	HLS	MP4	MP3	FLV
Chrome	34 dan yang lebih baru	✓	✓	×
Firefox	49 dan yang lebih baru
WeChat	✓
Edge	✓
Opera	✓

Tabel 2. Kompatibilitas browser H5 pada iOS

Browser	HLS	MP4	MP3	FLV
Chrome	34 dan yang lebih baru	✓	✓	×
Firefox	49 dan yang lebih baru
WeChat	✓
Edge	✓
Opera	✓
Safari	8 dan yang lebih baru

Kompatibilitas fitur

Fitur	Desktop	Mobile	Cara mengatur
Pemutaran layar penuh	Secara default, video tidak diputar dalam mode layar penuh.	Secara default, video diputar dalam mode layar penuh. Pengaturan berbeda diperlukan untuk skenario yang berbeda. Catatan Anda tidak dapat menonaktifkan pemutaran otomatis layar penuh di Safari pada perangkat dengan versi iOS sebelum 10. Saat memutar video dalam mode non-layar penuh, sesuaikan ukuran video berdasarkan rasio aspek resolusi video hasil transkode untuk menghindari bilah hitam.	Pengaturan layar penuh
Putar otomatis	Pembatasan berasal dari browser, bukan dari SDK Pemutar ApsaraVideo untuk web. Putar otomatis dibatasi di Safari 11 dan yang lebih baru pada macOS High Sierra. Putar otomatis dibatasi di Chrome 55 dan yang lebih baru.	Nonaktif secara default. Diperlukan pengaturan khusus untuk mengaktifkannya. Catatan Beberapa browser dan WebViews mungkin mengizinkan putar otomatis. Hal ini umum terjadi pada sistem Android.	Putar otomatis
Penyesuaian volume	Didukung	Karena properti `video.volume` bersifat read-only di iOS dan beberapa sistem Android, metode `getVolume` dan `setVolume` yang disediakan oleh SDK Pemutar ApsaraVideo untuk web tidak berfungsi di iOS dan beberapa sistem Android.	Penyesuaian volume
Kecepatan pemutaran	Didukung	Beberapa browser seluler tidak mendukung penyesuaian kecepatan pemutaran, seperti WeChat di Android.	Kecepatan pemutaran
Pemutaran video terenkripsi standar HLS	Chrome FireFox Safari Edge	Didukung	Cara memutar video terenkripsi
Enkripsi HLS privat Alibaba Cloud Catatan Karena alasan keamanan, Enkripsi privat Alibaba Cloud tidak mendukung debugging dengan video terenkripsi asli.	Chrome FireFox Safari Edge Catatan Beberapa browser pihak ketiga secara paksa membajak pemutar. Hal ini menonaktifkan Enkripsi privat Alibaba Cloud dan menyebabkan kegagalan pemutaran. Dalam kasus ini, gunakan enkripsi HLS standar atau Enkripsi DRM.	Didukung pada browser di iOS 14 dan yang lebih baru. Catatan Untuk mengaktifkan dukungan pada versi iOS sebelum 17.1, Anda harus menyebarlanjutkan skrip plugin pemutar tambahan. Skrip ini hanya berlaku untuk browser Safari. Browser lain, seperti WeChat, DingTalk, dan QQ Browser, tidak dapat digunakan karena keterbatasan sistem. Anda dapat mengarahkan pengguna untuk memutar video di browser Safari. Untuk informasi selengkapnya, lihat Petunjuk Penyebaran plugin enkripsi privat pada versi iOS sebelum 17.1. Didukung pada sebagian besar browser di platform Android. Catatan Karena beberapa browser membajak pemutaran video, browser berikut diketahui tidak mendukung pemutaran video yang dienkripsi dengan Enkripsi privat Alibaba Cloud: UC Browser, Quark, dan Baidu. Anda dapat mengarahkan pengguna untuk memutar video di browser lain.	Cara memutar video terenkripsi
Pemutaran live stream DRM-terenkripsi	Windows Chrome Opera FireFox Edge macOS Chrome Safari FireFox Opera Edge	iOS Chrome Safari Android Chrome pada Android 10 dan yang lebih baru Edge	Cara memutar video terenkripsi
Pemutaran aliran VOD terenkripsi DRM	Windows Chrome Opera FireFox Edge macOS Chrome Safari FireFox Opera Edge	iOS Chrome Safari Android Chrome pada Android 10 dan yang lebih baru Edge	Cara memutar video terenkripsi