Introduction to ApsaraVideo Player SDK for web - ApsaraVideo VOD

Vue d'ensemble

Le kit SDK ApsaraVideo Player pour web utilise la balise <video> d'HTML5 (H5) pour lire des vidéos dans les applications web. Le SDK est compatible avec plusieurs navigateurs, tels que Chrome et Safari, afin de garantir une lecture vidéo cohérente sur diverses plateformes. Lorsqu'il est utilisé conjointement avec ApsaraVideo Live et ApsaraVideo VOD, le kit SDK ApsaraVideo Player pour web prend également en charge des fonctionnalités telles que la protection contre le hotlinking, la lecture chiffrée pour les vidéos protégées par le droit d'auteur et la surveillance de la qualité.

Mise à niveau de la licence

À partir du 1er décembre 2024, vous devez obtenir une licence pour utiliser le kit SDK ApsaraVideo Player pour web version 2.28.0 et ultérieure. Pour obtenir des instructions, consultez Gérer les licences. Si vous utilisez une version antérieure à la 2.28.0, cette modification ne vous affecte pas. Nous vous recommandons toutefois de mettre à niveau vers la dernière version afin de bénéficier de services et d'une assistance plus complets.

Protocoles pris en charge

Scénarios VOD

Le tableau suivant décrit les protocoles de lecture VOD et les formats d'encodage pris en charge par le kit SDK ApsaraVideo Player pour web.

Format d'encodage vidéo	Protocole vidéo	Format de fichier audio	Format de codage audio
H.264	MP4 FLV HLS	MP3	AAC
H.265 Remarque Pour lire des flux vidéo encodés en H.265, vous devez d'abord remplir un formulaire pour demander une licence. Certains navigateurs ne prennent pas en charge la lecture vidéo H.265. L'activation de la lecture vidéo H.265 augmente la consommation de trafic et la latence de démarrage.	MP4 FLV HLS	-
H.266 Remarque Pour lire des flux vidéo encodés en H.266, vous devez d'abord remplir un formulaire pour demander une licence. Certains navigateurs ne prennent pas en charge la lecture vidéo H.266. L'activation de la lecture vidéo H.266 augmente la consommation de trafic et la latence de démarrage.	MP4	-

Scénarios de streaming en direct

Le tableau suivant décrit les protocoles de lecture en streaming en direct et les formats d'encodage pris en charge par le kit SDK ApsaraVideo Player pour web.

Format d'encodage vidéo	Protocole vidéo	Format de codage audio	Format de fichier audio
H.264	HLS, FLV, RTS, DASH	AAC	-
H.265	HLS, FLV (codecId=12)
H.266	HLS, FLV

Le tableau suivant décrit les avantages et les limites de chaque protocole de streaming en direct.

Protocole de streaming en direct	Avantage	Inconvénient	Latence
HLS	Compatibilité élevée avec les navigateurs.	Latence élevée.	> 10 s
FLV	Prend en charge les scénarios à forte concurrence et convient mieux aux applications natives.	Les navigateurs doivent être intégrés au kit SDK ApsaraVideo Player pour web pour la lecture.	1 à 3 s
RTS	Bonnes performances dans des conditions réseau médiocres. Les vidéos peuvent être lues sans interruption même avec un taux de perte de paquets de 30 %.	Les navigateurs doivent être intégrés au kit SDK ApsaraVideo Player pour web pour la lecture.	< 1 s
DASH	Débit adaptatif.	Latence élevée.	> 10 s

Compatibilité des navigateurs

Compatibilité avec les navigateurs de bureau

Important

Pour lire des vidéos FLV et HLS sur les navigateurs de bureau, vous devez activer l'accès interdomaines.

Navigateur	MP4	FLV	HLS	MP3
Chrome	✓	34 et versions ultérieures	34 et versions ultérieures	✓
Firefox	✓	49 et versions ultérieures	49 et versions ultérieures	✓
Edge	✓	✓	✓	✓
Opera	✓	✓	✓	✓
Safari	✓	8 et versions ultérieures	8 et versions ultérieures	✓

Compatibilité avec les navigateurs mobiles

Remarque

Le kit SDK ApsaraVideo Player pour web ne prend pas en charge la lecture de vidéos FLV sur les appareils mobiles.

Tableau 1. Compatibilité des navigateurs H5 sur Android

Navigateur	HLS	MP4	MP3	FLV
Chrome	34 et versions ultérieures	✓	✓	×
Firefox	49 et versions ultérieures
WeChat	✓
Edge	✓
Opera	✓

Tableau 2. Compatibilité des navigateurs H5 sur iOS

Navigateur	HLS	MP4	MP3	FLV
Chrome	34 et versions ultérieures	✓	✓	×
Firefox	49 et versions ultérieures
WeChat	✓
Edge	✓
Opera	✓
Safari	8 et versions ultérieures

Compatibilité des fonctionnalités

Fonctionnalité	Bureau	Mobile	Comment configurer
Lecture en plein écran	Par défaut, les vidéos ne sont pas lues en plein écran.	Par défaut, les vidéos sont lues en plein écran. Des paramètres différents sont requis selon les scénarios. Remarque Vous ne pouvez pas désactiver la lecture automatique en plein écran dans Safari sur les appareils dotés d'iOS versions antérieures à 10. Lors de la lecture de vidéos hors mode plein écran, ajustez la taille de la vidéo en fonction du rapport hauteur/largeur de la résolution transcodée pour éviter les bandes noires.	Paramètres de plein écran
Lecture automatique	La restriction provient du navigateur, et non du kit SDK ApsaraVideo Player pour web. La lecture automatique est restreinte dans Safari 11 et versions ultérieures sur macOS High Sierra. La lecture automatique est restreinte dans Chrome 55 et versions ultérieures.	Désactivée par défaut. Des paramètres spéciaux sont requis pour l'activer. Remarque Certains navigateurs et WebViews peuvent autoriser la lecture automatique. Cela est courant sur les systèmes Android.	Lecture automatique
Réglage du volume	Pris en charge	Étant donné que la propriété `video.volume` est en lecture seule sur iOS et certains systèmes Android, les méthodes `getVolume` et `setVolume` fournies par le kit SDK ApsaraVideo Player pour web ne fonctionnent pas sur iOS et certains systèmes Android.	Réglage du volume
Vitesse de lecture	Pris en charge	Certains navigateurs mobiles ne prennent pas en charge le réglage de la vitesse de lecture, comme WeChat sur Android.	Vitesse de lecture
Lecture de vidéos chiffrées selon la norme HLS	Chrome FireFox Safari Edge	Pris en charge	Lire une vidéo chiffrée
Chiffrement HLS propriétaire Alibaba Cloud Remarque Pour des raisons de sécurité, la cryptographie propriétaire d'Alibaba Cloud ne prend pas en charge le débogage avec de vraies vidéos chiffrées.	Chrome FireFox Safari Edge Remarque Certains navigateurs tiers détournent de force le lecteur. Cela désactive la cryptographie propriétaire d'Alibaba Cloud et entraîne un échec de la lecture. Dans ce cas, utilisez le chiffrement standard HLS ou le chiffrement DRM.	Pris en charge sur les navigateurs d'iOS 14 et versions ultérieures. Remarque Pour activer la prise en charge des versions d'iOS antérieures à 17,1, vous devez déployer un script de plug-in de lecteur supplémentaire. Ce script s'applique uniquement au navigateur Safari. D'autres navigateurs, tels que WeChat, DingTalk et QQ Browser, ne peuvent pas être utilisés en raison de limitations système. Vous pouvez inviter les utilisateurs à lire la vidéo dans le navigateur Safari. Pour plus d'informations, consultez Instructions de déploiement du plug-in de chiffrement propriétaire sur les versions d'iOS antérieures à 17,1. Pris en charge sur la plupart des navigateurs de la plateforme Android. Remarque Étant donné que certains navigateurs détournent la lecture vidéo, il est connu que les navigateurs suivants ne prennent pas en charge la lecture de vidéos chiffrées avec la cryptographie propriétaire d'Alibaba Cloud : UC Browser, Quark et Baidu. Vous pouvez inviter les utilisateurs à lire les vidéos dans d'autres navigateurs.	Lire une vidéo chiffrée
Lecture de flux en direct chiffrés par DRM	Windows Chrome Opera FireFox Edge macOS Chrome Safari FireFox Opera Edge	iOS Chrome Safari Android Chrome sur Android 10 et versions ultérieures Edge	Lire une vidéo chiffrée
Lecture de flux VOD chiffrés par DRM	Windows Chrome Opera FireFox Edge macOS Chrome Safari FireFox Opera Edge	iOS Chrome Safari Android Chrome sur Android 10 et versions ultérieures Edge	Lire une vidéo chiffrée