Si une erreur se produit lors de la lecture de vidéos avec le SDK du lecteur Alibaba Cloud, vous pouvez utiliser la fonctionnalité de traçage ponctuel pour suivre le comportement de lecture anormal d'un utilisateur spécifique ou d'une session de lecture de bout en bout. Cela vous aide à diagnostiquer rapidement la cause racine et à gérer l'expérience de lecture plus efficacement.
Prérequis
Avant d'utiliser la fonctionnalité de traçage ponctuel, assurez-vous que les conditions suivantes sont remplies :
La fonctionnalité de traçage ponctuel est disponible uniquement pour les versions suivantes du SDK du lecteur Alibaba Cloud : 5.4.9.2 ou ultérieure pour Android et iOS, et 2.16.0 ou ultérieure pour Web. Téléchargez le SDK.
Une licence valide pour le SDK Android, iOS ou Web. Obtenez une licence.
Assurez-vous que la journalisation est activée pour le SDK du lecteur Alibaba Cloud. Cette fonctionnalité est activée par défaut.
Vous devez transmettre le paramètre traceId lors de la création du lecteur. Sans ce paramètre, la fonctionnalité de traçage ponctuel n'est pas disponible. Pour plus d'informations sur la transmission du paramètre, consultez Fonctionnalités de base du SDK du lecteur Alibaba Cloud pour Android, Fonctionnalités de base du SDK du lecteur Alibaba Cloud pour iOS, et Référence de l'API du lecteur Web.
La fonctionnalité de traçage ponctuel n'est pas prise en charge pour les lecteurs système natifs, les lecteurs tiers ou le SDK du lecteur Alibaba Cloud sur des plateformes autres qu'Android, iOS et Web.
Limites
Vous pouvez interroger uniquement les 10 000 sessions les plus récentes.
Vous pouvez interroger les données de lecture des trois derniers jours uniquement.
Procédure
Connectez-vous à la console VOD d'Alibaba Cloud.
Dans le volet de navigation de gauche, choisissez Data Center > Single-point Tracing.
-
Interrogez les sessions de lecture.
Dans le champ Enter a traceId, saisissez le traceId fourni lors de la création du lecteur pour interroger les sessions de lecture d'un utilisateur ou d'un appareil spécifique.
Filtrez les sessions de lecture par heure (dans les 3 derniers jours), type de lecture (vidéo à la demande ou flux en direct) et statut (Playback Completed, Playing ou Playback Failed).
-
Cliquez sur View Details pour afficher les informations détaillées d'une session de lecture.
La page des détails de lecture contient trois sections. La section Basic information affiche des champs tels que App name, Playback time, client IP, OS, Network type, Device type, SessionId et SDK version. La section Playback information affiche des métriques telles que time to first frame, Rebuffering count, Rebuffering duration, status, Codec standard, hardware decoding, Playback progress on exit, resolution, frame rate et video bitrate. La liste des événements en bas enregistre les événements de lecture dans l'ordre chronologique, avec des colonnes telles que Topic, Event, Duration (ms), Time et Details.
Documents connexes
Pour obtenir des informations sur les problèmes courants et leurs solutions lors de l'utilisation du SDK du lecteur Alibaba Cloud, consultez FAQ du SDK du lecteur.