Tous les produits
Search
Centre de documentation

ApsaraVideo Live:Surveillance de la qualité du SDK

Dernière mise à jour :Aug 19, 2026

Si votre application utilise le SDK ApsaraVideo Player, surveillez la qualité de service (QoS) de la lecture grâce aux données de suivi d'événements rapportées par le SDK. Des métriques clés telles que le taux de réussite de lecture, le taux de démarrage instantané et le taux de saccades vous permettent d'évaluer rapidement la qualité du streaming en direct.

Fonctionnement

Le service de données de lecture en direct s'appuie sur les données de suivi d'événements rapportées par le SDK ApsaraVideo Player. Le schéma suivant illustre la logique de suivi des événements.

image.png

Remarques relatives à l'utilisation

  1. Utilisez le SDK ApsaraVideo MediaBox et assurez-vous que votre licence est valide et que la fonctionnalité de rapport de données est activée.

  2. Les versions 5.4.9.2 et ultérieures des SDK de lecteur natif sont prises en charge.

  3. Les versions 2.16.0 et ultérieures des SDK de lecteur Web sont prises en charge.

  4. Pour télécharger le SDK de lecteur, consultez la rubrique Présentation du SDK. Pour plus d'informations sur les licences, consultez la rubrique Gestion des licences.

Données de lecture

  1. Connectez-vous à la console ApsaraVideo Live.

  2. Dans le volet de navigation de gauche, choisissez Live Center > Data Monitoring > SDK Quality Monitoring.

  3. Sous l'onglet Playback Data, sélectionnez un nom d'application, puis cliquez sur Query.

    Remarque

    Le nom de l'application doit correspondre au titre de l'application configuré pour la licence de votre SDK ApsaraVideo Player. Dans le cas contraire, la requête ne renvoie aucune donnée.

    Vous pouvez filtrer les données selon les dimensions suivantes :

    • Filtrez par type de client, type de système d'exploitation, résolution et type de réseau.

    • Interrogez les données sur une plage horaire personnalisée au cours des trois derniers jours. Une seule requête ne peut pas couvrir plusieurs jours.

    • Pour filtrer par version du SDK, format d'encodage, format vidéo, statut du décodage matériel, fournisseur d'accès Internet, nom de domaine ou province, cliquez sur New Filter Condition. Vous pouvez également enregistrer les règles de filtre fréquemment utilisées pour une utilisation future.

  4. La vue d'ensemble de l'application fournit les métriques QoS suivantes pour vous aider à évaluer la qualité du service de lecture.

    Remarque

    La métrique de fréquence d'images moyenne de lecture (fps) est disponible uniquement pour les scénarios vidéo. Les autres métriques sont disponibles pour les scénarios audio seul et audio-vidéo.

    Metric

    Description

    Average first frame duration (ms)

    Temps nécessaire pour afficher la première image après qu'un utilisateur a demandé la lecture.

    Stuttering rate by duration (%)

    Durée totale des saccades exprimée en pourcentage de la durée totale de lecture. Formule : Durée totale des saccades / Durée totale de lecture.

    Average playback frame rate (fps)

    Nombre moyen d'images vidéo affichées par seconde pendant la lecture.

    Downlink bitrate (Kbps)

    Vitesse de téléchargement du réseau pendant la lecture en direct.

    Instant startup rate (%)

    Pourcentage de flux qui commencent à être lus en moins d'une seconde. Formule : Nombre de flux démarrant en ≤ 1 s / Nombre total de sessions de lecture.

    Slow startup rate (%)

    Pourcentage de flux qui mettent 3 secondes ou plus à démarrer. Formule : Nombre de flux démarrant en ≥ 3 s / Nombre total de sessions de lecture.

    Playback success rate (%)

    Pourcentage de sessions de lecture réussies. Formule : Nombre de lectures réussies / Nombre total de lectures.

    CPU usage (%)

    Pourcentage de ressources CPU consommées pendant la lecture en direct.

Traçage ponctuel

En cas d'erreur de lecture, utilisez le traçage ponctuel pour suivre un utilisateur ou une session spécifique de bout en bout. Cela vous aide à diagnostiquer les causes racines et à améliorer l'expérience du spectateur.

  1. Connectez-vous à la console ApsaraVideo Live.

  2. Dans le volet de navigation de gauche, choisissez Live Center > Data Monitoring > SDK Quality Monitoring.

  3. Cliquez sur l'onglet Single-point Tracing, puis saisissez le TraceID ou l'UUID fourni lors de la création du lecteur pour exécuter une requête.

    Définissez une plage de dates pour la requête. Les résultats incluent un graphique de tendance de la durée de la première image et un tableau de données. Les colonnes du tableau incluent TraceID, Video ID/URL, SessionID, First Frame Duration (ms), Status, Current Playback Duration (s) et Stuttering Duration (ms).

  4. Dans la colonne Actions, cliquez sur View Details pour afficher les informations détaillées d'une session.

Documents connexes

Présentation du SDK