Use the Web Player SDK diagnostic tool to troubleshoot video playback issues - ApsaraVideo VOD

Le SDK Web Player intègre un outil de diagnostic pour résoudre les échecs de lecture vidéo et les saccades. Cet outil collecte les données de base de l'environnement, l'état du réseau ainsi qu'un journal des événements de lecture en temps réel, ce qui vous permet d'identifier la cause du problème sans recourir à des outils externes.

Prérequis

Avant de commencer, configurez les paramètres suivants sur votre domaine de lecture vidéo :

Activez la protection contre le hotlinking pour le Referer et ajoutez player.alicdn.com à la liste d'autorisation. Pour plus d'informations, consultez la rubrique Configurer une liste noire/liste blanche d'adresses IP.

Remarque
player.alicdn.com correspond à l'adresse statique d'Aliplayer et doit figurer dans la liste d'autorisation.

Dans les paramètres de Hotlink protection for Referer, décochez la case Allow Direct Access from Browser Address Bar afin de bloquer les requêtes CDN dont le Referer est vide.
Ajoutez l'en-tête Access-Control-Allow-Origin à votre domaine de lecture vidéo pour activer le partage de ressources cross-origin (CORS). Pour plus d'informations, consultez la rubrique Configurer le partage de ressources cross-origin.

Diagnostiquer les problèmes de lecture

Ouvrez l'outil de diagnostic.

Utilisez l'une des méthodes suivantes :
- Depuis un écran d'erreur de lecture : Lorsqu'une erreur de lecture survient (par exemple, le message « Failed to get the URL »), cliquez sur Diagnose sur l'écran d'erreur. L'outil s'ouvre avec les champs préremplis : code d'erreur (code), ID vidéo (vid), uuid, requestId et horodatage de la lecture.
- Directement : Accédez à l'outil de diagnostic.
Consultez les informations de base.

L'onglet Diagnostic Information affiche les données relatives à l'environnement et au réseau collectées lors de la session de l'utilisateur : - Basic information : système d'exploitation (par exemple, Windows NT 10.0) et navigateur (par exemple, Chrome 90.0.4430.93) - Network information : état du CDN d'images, état du CDN de scripts, DNS local, FAI et adresse IP locale

Exécutez un test de lecture.

Dans l'onglet Video Playback, sélectionnez un mode de lecture dans le menu Type : HTML5, Alibaba Cloud HTML5 ou Alibaba Cloud Flash.
Saisissez soit le paramètre Source (une URL de lecture directe), soit les paramètres Vid et playAuth, puis cliquez sur Play.

Remarque
Si les paramètres Source et Vid/playAuth sont tous deux renseignés, Source est prioritaire.

Lisez le journal des événements de lecture. Pendant la lecture, l'outil superpose un journal d'événements en direct sur le côté gauche de la vidéo. Chaque entrée indique le nom de l'événement et son horodatage. Les événements suivants sont consignés :

Événement	Signification
`play`	Début de la lecture
`waiting`	En attente de données
`loadstart`	Début de la demande de données
`progress`	Demande de données en cours
`loadedmetadata`	Chargement des métadonnées de la source
`loadeddata`	Chargement des données de l'image actuelle
`canplay`	Données suffisantes pour démarrer la lecture
`canplaythrough`	Données suffisantes pour lire jusqu'à la fin sans mise en mémoire tampon
`pause`	Lecture mise en pause
`ended`	Lecture terminée

Voir aussi

Codes d'erreur