Tous les produits
Search

Ce produit

    ApsaraVideo VOD:Dépannage des problèmes de lecture vidéo

    Centre de documentation

    ApsaraVideo VOD:Dépannage des problèmes de lecture vidéo

    Dernière mise à jour :Aug 10, 2026

    Cette rubrique explique comment identifier et résoudre les problèmes de lecture vidéo.

    Stratégie de dépannage

    Les échecs de lecture vidéo peuvent avoir de nombreuses causes. Pour identifier l'origine du problème, vérifiez d'abord si les erreurs suivent un schéma particulier. Si c'est le cas, utilisez les causes possibles indiquées dans le tableau suivant pour orienter votre investigation. En l'absence de schéma clair, examinez l'appareil final, le flux multimédia et le réseau. Si vous ne parvenez toujours pas à identifier la cause, contactez le support technique Alibaba Cloud.

    • Erreurs présentant un schéma de distribution :

      |
      **Schéma d'erreur**
      |
      **Cause possible**
      | | --- | --- | |
      Échec de la lecture pour les utilisateurs de réseaux ou de régions spécifiques.
      |
      Le problème peut être dû à des soucis locaux sur le réseau de l'opérateur ou à des problèmes de planification CDN dans la région concernée.
      | |
      Échec de la lecture sur les appareils finals dotés de systèmes d'exploitation spécifiques.
      |
      Le problème peut provenir de différences dans l'implémentation du SDK selon les plateformes ou de problèmes de compatibilité système.
      | |
      Échec de la lecture sur des marques ou modèles d'appareils finals spécifiques.
      |
      Le problème peut être lié à des incompatibilités matérielles.
      | |
      Échec de la lecture pour des fichiers audio ou vidéo spécifiques.
      |
      Le problème peut résulter de l'encodage du fichier multimédia, du préchargement CDN ou des politiques d'accès métier.
      |



















    • Erreurs sans schéma de distribution clair : la cause peut être complexe. Dans ce cas, retracer le flux de travail du contenu jusqu'à l'utilisateur permet d'identifier le nœud problématique et de déterminer la cause racine.

    image

    Étape 1 : Vérifier l'appareil final

    Compatibilité de l'appareil final

    Vérifiez d'abord que le protocole du flux multimédia est pris en charge par le système d'exploitation et l'environnement applicatif. Si ce n'est pas le cas, transcodez le flux. Pour plus d'informations, consultez les Recommandations de transcodage. Les tableaux suivants répertorient les protocoles vidéo et les codecs pris en charge par le SDK Player.

    Application native

    Système d'exploitation

    Codec vidéo

    Protocole vidéo

    Codec audio

    Android

    • H.264

    • H.265

    • MP4

    • HLS

    • FLV

    • MPEG-DASH (SegmentBase et SegmentTemplate)

    • AAC

    • MP3

    iOS

    Windows

    macOS

    Linux

    Web

    Remarque

    Si le protocole du flux multimédia respecte les exigences de compatibilité Web ci-dessous, vérifiez que vous disposez d'un certificat SSL et que l'accès cross-origin est activé. Pour plus d'informations, consultez les rubriques Activer l'accélération sécurisée HTTPS et Configurer l'accès cross-origin.

    Système d'exploitation

    Codec vidéo

    Protocole vidéo

    Codec audio

    Android

    H.264

    • MP4

    • HLS (Prise en charge partielle. Certains navigateurs nécessitent MSE. Voir le tableau ci-dessous pour plus de détails.)

    • FLV (Nécessite MSE)

    • AAC

    • MP3

    iOS

    H.264

    • MP4

    • HLS

    Remarque

    FLV et MPEG-DASH ne sont pas pris en charge.

    H.265

    • MP4

    • HLS (segments fMP4 requis)

    Windows

    H.264

    • MP4

    • HLS (Nécessite MSE)

    • FLV (Nécessite MSE)

    macOS

    H.264

    • MP4

    • HLS

    • FLV (Nécessite MSE)

    H.265

    • MP4

    • HLS (segments fMP4 requis)

    Certains navigateurs sur les appareils Android nécessitent MSE pour lire les vidéos HLS. Voici les détails :

    |
    **Navigateur sur appareils Android**
    |
    **Prise en charge HLS**
    | | --- | --- | |
    WeChat
    |
    Prise en charge
    | |
    DingTalk
    |
    Prise en charge
    | |
    UC/Quark
    |
    Prise en charge
    | |
    QQ Browser
    |
    Prise en charge
    | |
    Chrome
    |
    Nécessite MSE
    | |
    Huawei Browser
    |
    Nécessite MSE
    | |
    OPPO Browser
    |
    Prise en charge
    | |
    vivo Browser
    |
    Prise en charge
    | |
    Mi Browser
    |
    Nécessite MSE
    |







































    Compatibilité du SDK Player

    Si votre appareil répond aux exigences de compatibilité, utilisez un autre lecteur pour vérifier si le problème est lié à la compatibilité du SDK ApsaraVideo Player.

    • Si la vidéo est lue correctement dans un autre lecteur, le problème pourrait provenir du SDK ApsaraVideo Player. Dans ce cas, contactez le support technique.

    • Si la vidéo ne se lit pas non plus dans un autre lecteur, examinez le flux multimédia et le réseau.

    Nous vous recommandons d'utiliser les lecteurs suivants pour le dépannage :

    • Lecteur tiers : VLC

    • Lecteur système : ExoPlayer (Android), AVPlayer (iOS)

    • Navigateur système (Web uniquement) : Chrome (Android, Windows), Safari (iOS, macOS)

    Étape 2 : Vérifier le flux multimédia

    Après avoir écarté les causes précédentes, transcodez le flux multimédia et essayez de le lire à nouveau. S'il est lu correctement, le flux d'origine était probablement mal encodé.

    Remarque

    Les vidéos MP4 peuvent démarrer lentement ou les vidéos MOV peuvent échouer à la lecture si l'atome moov (index des données multimédias) se trouve après l'atome mdat (données multimédias). Le transcodage de la vidéo source pour placer l'atome moov avant l'atome mdat permet d'accélérer l'analyse lors de la lecture.

    • Utilisez la commande suivante pour vérifier la position de l'atome moov :

      # The source video URL can be a local file path or an online URL, for example, http://pla****.alicdn.com/video/aliyunmedia.mp4
ffmpeg -v trace -i "source_video_url" 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'

      Dans un scénario normal, l'atome moov précède l'atome mdat, ce qui indique une optimisation faststart. L'exemple de sortie est présenté ci-dessous.

      # ffmpeg -v trace -i sample_faststart.mp4 2>&1 | grep -e type:\'mdat\' -e type:\'moov\'
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x54d3b80] type:'moov' parent:'root' sz: 603629 40 231901466
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x54d3b80] type:'mdat' parent:'root' sz: 231297797 603677 231901466

      Dans un scénario anormal, l'atome moov suit l'atome mdat.

      # ffmpeg -v trace -i sample.mp4 2>&1 | grep -e type:"mdat" -e type:"moov"
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x59e1b80] type:'mdat' parent:'root' sz: 231297797 48 231901466
[mov,mp4,m4a,3gp,3g2,mj2 @ 0x59e1b80] type:'moov' parent:'root' sz: 603629 231297845 231901466

    • Utilisez la commande suivante ou l'outil en ligne de commande ffprobe (outil ffprobe) pour interroger des informations telles que le codec audio et le codec vidéo du fichier source. Cela vous aide à analyser si les vidéos problématiques partagent des similitudes :

      ffprobe "input.mp4" ou ffprobe "source_video_url"

      Input #0, mov, mp4, m4a, 3gp, 3g2, mj2, from 'input.mp4':
    Metadata:
      major_brand     : isom
      minor_version   : 512
      compatible_brands: isomiso2avc1mp41
      encoder         : www.aliyun.com - Media Transcoding
    Duration: 00:00:17.56, start: 0.000000, bitrate: 3088 kb/s
    Stream #0:0(und): Video: h264 (High) (avc1 / 0x31637661), yuv420p, 1440x2560, 2890 kb/s, 25 fps, 25 tbr, 12800 tbn, 50 tbc (default)
      Metadata:
        handler_name    : VideoHandler
    Stream #0:1(und): Audio: aac (LC) (mp4a / 0x6134706D), 44100 Hz, stereo, fltp, 191 kb/s (default)
      Metadata:
        handler_name    : SoundHandler

    Recommandations de transcodage

    • Sortie de transcodage : nous recommandons de transcoder vers un flux vidéo H.264 MP4 ou HLS.

    • Méthode de transcodage : nous recommandons d'utiliser les services Alibaba Cloud ou les outils locaux suivants.

      Catégorie

      Service ou outil

      Description

      Service Alibaba Cloud

      ApsaraVideo VOD

      ApsaraVideo VOD propose des capacités complètes de transcodage et de transmuxing pour répondre aux divers besoins de conversion de format multimédia. Il prend en charge le transcodage standard, Narrowband HD 1.0, Narrowband HD 2.0 et le transcodage de qualité source. Pour plus d'informations, consultez la rubrique Transcodage audio et vidéo.

      ApsaraVideo Media Processing (MPS)

      ApsaraVideo Media Processing (MPS) transcode les données multimédias dans des formats adaptés à la lecture sur toutes les plateformes. Il prend en charge le transcodage standard, Narrowband HD 1.0, Narrowband HD 2.0, le transcodage haute vitesse et le transcodage avec doublement de résolution. Cette solution est idéale pour les utilisateurs qui stockent leurs fichiers vidéo sources dans leurs propres buckets OSS. Pour plus d'informations, consultez la rubrique Transcodage multimédia.

      Intelligent Media Services (IMS)

      Intelligent Media Services (IMS) fournit des capacités de transcodage à la demande et en temps réel. Il prend en charge le transcodage des médias stockés dans OSS ou ApsaraVideo VOD, ainsi que le transcodage des flux en direct.

      Outil local

      FFmpeg Codecs

      Téléchargement disponible sur : FFmpeg Codecs

    Étape 3 : Vérifier le réseau

    Si les étapes précédentes n'ont pas résolu le problème, examinez la transmission réseau pour localiser la cause de l'erreur de lecture.

    1. Vérifiez que l'appareil final dispose d'une connexion réseau stable.

      • Wi-Fi : le réseau actuel est-il stable et accessible ? La vitesse de téléchargement est-elle supérieure ou égale au débit binaire de la vidéo ?

        Vous pouvez utiliser Speedtest.net pour vérifier la vitesse de téléchargement du réseau. Si la vitesse est inférieure au débit binaire de la vidéo, des échecs de chargement ou des saccades pendant la lecture peuvent survenir.

      • Réseau mobile : l'appareil est-il connecté à un réseau haut débit comme la 4G ou la 5G ? Quelle est la puissance du signal ?

        Dans des conditions de réseau faible, la vitesse peut être insuffisante pour charger les flux multimédias.

      Remarque

      En cas de détournement DNS, configurez manuellement votre DNS sur Alibaba Cloud Public DNS (223.5.5.5, 223.6.6.6) pour rétablir la lecture.

      1. Accédez à Settings > Wi-Fi sur votre appareil mobile.

      2. Appuyez sur le bouton de détails à droite de votre réseau actuel pour ouvrir la page des détails du réseau.

      3. Configurez le DNS.

        Sur la page de configuration réseau, vous trouverez trois sections : IP address (sous-réseau, passerelle), IPv6 address (adresse IP, passerelle) et DNS. Appuyez sur la flèche à côté de l'entrée DNS pour accéder à la configuration détaillée.

    2. Vérifiez si l'accélération CDN est activée.

      • Si l'accélération CDN n'est pas activée, nous vous recommandons de la configurer pour améliorer l'expérience de lecture. Pour plus d'informations, consultez la rubrique Ajouter un nom de domaine accéléré.

      • Si l'accélération CDN est activée :

        • Problème de configuration CDN : le contenu multimédia a-t-il été préchargé ? Le cache du contenu a-t-il expiré ?

          Un manque de cache CDN, dû à un contenu non préchargé ou à un cache expiré, peut entraîner des échecs de chargement ou des saccades lors de la lecture. Ce problème est fréquent avec les vidéos nouvellement téléchargées. Nous vous recommandons de précharger activement le contenu des nouvelles vidéos. Pour plus d'informations, consultez la rubrique Actualiser et précharger les ressources.

        • Autres problèmes : les vidéos d'autres applications se lisent-elles normalement sur le même appareil final ?

          Si la configuration CDN est correcte et que d'autres applications lisent les vidéos sans problème, l'erreur de lecture peut être causée par un problème localisé de planification CDN.

    3. Vérifiez l'emplacement du serveur d'origine et celui de vos utilisateurs finaux.

      Si le serveur d'origine se trouve en Chine continentale et que les utilisateurs sont à l'étranger, des saccades importantes peuvent survenir. Dans ce cas, déployez le serveur d'origine dans une région plus proche de vos utilisateurs pour améliorer les performances.

    4. Vérifiez les heures de pointe d'affichage.

      Si trop de personnes regardent en même temps, le serveur d'origine peut limiter le trafic, provoquant des saccades lors de la lecture.

    Échec de la lecture après configuration d'un nom de domaine accéléré

    Si les vidéos ne se lisent pas après avoir configuré un nom de domaine accéléré, vérifiez les éléments suivants :

    1. Vérifiez l'état de la résolution CNAME

      • Dans la console VOD, accédez à Domain Management et vérifiez si la colonne CNAME indique que le nom de domaine est activé.

      • Vous pouvez également exécuter la commande nslookup ou dig pour vérifier que le nom de domaine se résout vers un nœud CDN.

    2. Vérifiez la configuration du certificat HTTPS

      • Sur la page Domain Management, ouvrez la configuration du domaine et vérifiez l'état du certificat HTTPS.

      • Si aucun certificat n'est configuré ou si le certificat a expiré, les lecteurs dans des environnements HTTPS refusent de charger le flux multimédia.

    3. Vérifiez la configuration de la protection contre le hotlinking basée sur le Referer et la signature d'URL

      • Vérifiez les paramètres des listes noires et blanches de Referer dans la configuration du domaine.

      • Vérifiez les paramètres de signature d'URL et assurez-vous que le type de signature et les paramètres correspondent à la demande de lecture.

    4. Vérifiez l'état du préchargement CDN

      • Accédez à Refresh and Prefetch et vérifiez l'état des tâches de préchargement.

      • La première lecture d'une vidéo qui n'a pas été préchargée peut être lente à charger ou expirer.

    5. Solution de récupération temporaire

      • Sur la page Domain Management, désactivez le nom de domaine accéléré, puis réactivez-le une fois la cause identifiée.

    Documents connexes

    Si vous ne parvenez toujours pas à identifier la cause après avoir suivi les étapes précédentes, consultez les documents suivants pour des cas similaires et des solutions :

    Contacter le support technique

    Si le problème persiste, soumettez un ticket. Pour plus d'informations sur la procédure de soumission d'un ticket, consultez la rubrique Nous contacter.

    Pour nous aider à résoudre votre problème efficacement, fournissez les informations suivantes dans votre ticket.

    |
    **Élément**
    |
    **Exemple**
    |
    **Description**
    | | --- | --- | --- | |
    Système d'exploitation et plateforme de l'appareil
    |
    Android 9, Xiaomi
    |
    Indiquez la marque de l'appareil et la version du système d'exploitation, par exemple : Xiaomi avec Android 9, iOS 15, Windows 11 ou macOS 12.
    | |
    SDK et version
    |
    Android SDK 5.4.8.0
    |
    Spécifiez le SDK Player utilisé et son numéro de version. Les SDK Player incluent le Web SDK, l'Android SDK, l'iOS SDK, le Flutter SDK et le Windows SDK.
    | |
    Source vidéo
    |
    https://xxxxxx.m3u8
    |
    Fournissez l'URL de la source vidéo ou le fichier vidéo qui reproduit le problème.
    | |
    Description du problème, journaux et capture d'écran
    |
    La lecture a commencé à 16 h 40 le 29 août 2022 et des saccades sont survenues vers 17 h 00. Le journal est joint.
    |
    Décrivez en détail les étapes de reproduction et les symptômes observés, y compris les horodatages spécifiques. Pour les problèmes reproductibles, fournissez un journal complet des étapes de reproduction. Pour obtenir les journaux, consultez les rubriques [Obtenir les journaux sur Android](t2233671.xdita#section_bgg_b5l_tp9) ou [Obtenir les journaux sur iOS](t2233874.xdita#section_k3j_m3y_vxf). Si nécessaire, joignez une capture d'écran.
    | |
    Schéma d'erreur
    |
    Le problème ne survient que sur les appareils Android, pas sur iOS. Il est toujours reproductible.
    |
    Décrivez si le problème suit un schéma spécifique et sa fréquence. Par exemple, indiquez si le problème est limité à une certaine source vidéo, une plateforme d'appareil ou une version de SDK, et s'il est intermittent ou toujours reproductible.
    |