ApsaraVideo VOD:Common player issues

Échecs de lecture VOD

La lecture peut échouer en raison de problèmes liés à l'encodage du flux, aux endpoints réseau, aux CDN, aux formats ou aux buckets de stockage. Pour identifier la cause, vérifiez les messages d'erreur du lecteur et les requêtes réseau. Voici les problèmes courants et leurs solutions :

• Paiement en retard : Vérifiez le solde de votre compte. Si votre compte est impayé, les vidéos ne peuvent pas être lues.

• Problème client réseau : La vidéo ne se lit pas et renvoie le code d'erreur 4400. Le code d'erreur 4400 indique qu'une ressource ne peut pas être chargée en raison de problèmes serveur ou réseau. Vérifiez si un certificat SSL est configuré et si le certificat HTTPS a expiré ou n'est pas valide.

• Problème de format : Le format vidéo n'est pas compatible avec le lecteur. Pour plus d'informations sur les formats de lecture pris en charge par ApsaraVideo VOD, consultez Fonctionnalités du SDK Player.

  Remarque

  Pour lire des fichiers M3U8 avec authentification, vous devez utiliser un nom de domaine personnalisé. Pour ajouter un nom de domaine, consultez Ajouter un nom de domaine accéléré.

• Problème de bucket : Le bucket de stockage configuré n'est pas valide ou l'URL signée pour un bucket privé a expiré. Cela entraîne un échec de la lecture. Pour résoudre ce problème, désactivez la signature d'URL pour le bucket et définissez son autorisation sur public-read.

• Problème interdomaine : Vérifiez si la région de votre nom de domaine accéléré correspond à la région de lecture vidéo. Si elles diffèrent, la lecture échoue. Vous pouvez créer un nouveau nom de domaine accéléré ou modifier la région de celui existant.

Erreur GetPlayInfo : Statut vidéo invalide ou en cours de révision

Pour obtenir correctement les informations de lecture, le statut principal de la vidéo (Status) doit être Normal et son statut de révision (AuditStatus) doit être Normal. Si le statut de la vidéo est UploadSucc (téléchargement réussi mais transcodage non terminé) ou si AuditStatus est Init (en cours de révision), vous devez attendre la fin du transcodage et la validation de la révision avant de pouvoir obtenir les informations de lecture. Nous vous recommandons d'utiliser l'API GetVideoInfo pour interroger le dernier statut de la vidéo et vérifier si les paramètres globaux de révision affectent la progression de celle-ci.

En mode « révision avant publication », une révision manuelle validée indique uniquement que la révision du contenu est terminée, pas que la vidéo est prête à être lue. La vidéo ne peut renvoyer les informations de lecture qu'une fois le transcodage terminé et que son statut principal (Status) passe à Normal. Si la révision manuelle est validée mais que la vidéo reste longtemps au statut UploadSucc, le transcodage n'a pas été déclenché ou n'est pas terminé. Vérifiez si un groupe de modèles de transcodage par défaut est configuré et défini comme tel, ou lancez manuellement le transcodage dans la console ApsaraVideo VOD.

Erreurs lors de la lecture de vidéos M3U8 locales

Un fichier M3U8 contient plusieurs segments Transport Stream (TS). Pour une lecture locale, ces segments doivent exister localement avec des chemins relatifs corrects dans le fichier M3U8, car les URL distantes ne sont pas prises en charge.

Le fichier index M3U8 et ses fichiers de segment .ts correspondants (tels que 000000.ts, 000001.ts, etc.) doivent être placés dans le même répertoire.

Les fichiers M3U8 locaux doivent respecter cette structure de répertoire.

Échecs de lecture externe

Procédez au dépannage comme suit :

1. Vérifiez si la vidéo existe toujours dans ApsaraVideo VOD.

2. Vérifiez si un nom de domaine accéléré a été ajouté.

   • Aucun nom de domaine accéléré n'est ajouté : Vérifiez les autorisations du bucket de stockage. Vérifiez si le bucket de stockage est privé. S'il est privé, une authentification est requise. Pour lire la vidéo directement, vous pouvez désactiver l'authentification et définir l'autorisation du bucket sur public-read. Notez que définir un bucket sur public-read présente un risque de sécurité.

   • Un nom de domaine accéléré est ajouté : Vérifiez si l'authentification est activée. Si c'est le cas, vous pouvez prolonger la période de validité de l'authentification ou la désactiver. Notez que la désactivation de l'authentification présente un risque de sécurité.

Impossible de lire une vidéo chiffrée DRM dans un navigateur

La lecture de vidéos chiffrées DRM avec ApsaraVideo Player pour Web est soumise aux restrictions du navigateur. Pour plus d'informations sur les navigateurs pris en charge, consultez Compatibilité des fonctionnalités.

MtsHlsUriToken pour le chiffrement HLS

Le paramètre MtsHlsUriToken est un paramètre personnalisé. Dans le chiffrement HLS standard, après l'écriture de la chaîne de chiffrement dans le flux HLS, l'adresse d'un serveur de déchiffrement est ajoutée au manifeste M3U8. Pour permettre uniquement à certains utilisateurs d'accéder à la vidéo, le serveur de déchiffrement nécessite un mécanisme d'authentification d'identité. Le paramètre MtsHlsUriToken ajoute une couche d'authentification à votre serveur de déchiffrement. Un paramètre spécial est ensuite généré sur la base de cette logique d'authentification et transmis pour la vérification du déchiffrement.

Lorsque vous configurez le chiffrement, vous devez mettre en place un service d'émission de jetons pour générer le MtsHlsUriToken. Pour plus d'informations, consultez Chiffrement HLS - Étape 4.

Chargement lent pour les vidéos depuis UK (Londres) en Chine continentale

L'accès depuis la Chine continentale vers la région UK (Londres) est plus lent en raison de la distance. Pour améliorer les performances, ajoutez un nom de domaine accéléré et utilisez Global Accelerator.

Accès lent et saccades lors de la lecture hors de Chine

Les saccades pendant la lecture sont généralement causées par un réseau instable. Si les saccades sont suffisamment longues pour provoquer une erreur du lecteur, elles sont probablement liées à une instabilité du CDN. Si des saccades se produisent fréquemment, vérifiez les requêtes réseau. La vitesse du réseau peut ne pas correspondre au débit binaire de la vidéo. Vous devrez peut-être augmenter la vitesse du réseau ou diminuer le débit binaire.

Requêtes excessives lors de la lecture de vidéos OSS

Vérifiez s'il y a un problème avec la vidéo source. Par exemple, vérifiez si le lecteur envoie de nombreuses requêtes dupliquées lors du décodage de la vidéo source. Vous pouvez utiliser un modèle de transcodage ApsaraVideo VOD pour transcoder la vidéo avant la lecture. Pour plus d'informations, consultez Transcodage vidéo et audio.

Aperçu des ressources image au lieu de les télécharger

Pour prévisualiser les images stockées dans ApsaraVideo VOD au lieu de les télécharger, vous devez utiliser un nom de domaine personnalisé. Vous pouvez ajouter un nom de domaine personnalisé à ApsaraVideo VOD. Pour plus d'informations, consultez Ajouter un nom de domaine accéléré.

Échec de la lecture vidéo sur certains ordinateurs avec le code d'erreur 4400

Le code d'erreur 4400 indique que la ressource ne peut pas être chargée en raison de problèmes serveur ou réseau, ou d'un format non pris en charge. Vérifiez si un certificat SSL est configuré.

URL de lecture courtes

Si l'autorisation du bucket de stockage d'une vidéo est privée, son URL de lecture contient une chaîne d'authentification et constitue une URL longue. Si l'autorisation est public-read ou public-read-write, l'URL de lecture ne contient pas la chaîne d'authentification et constitue une URL courte. Pour plus d'informations sur les autorisations des buckets de stockage et sur leur modification, consultez Gérer les buckets de stockage.

Échec de lecture des vidéos non transcoded au format HLS

Lorsque vous utilisez ApsaraVideo Player avec un ID vidéo (VID) et un identifiant de lecture, vous ne pouvez lire que des vidéos transcoded. Vous ne pouvez lire les vidéos non transcoded qu'en utilisant une URL. Vous pouvez appeler l'opération GetMezzanineInfo pour obtenir l'URL de la vidéo source ou vous connecter à la console ApsaraVideo VOD pour afficher l'URL de la vidéo.

Permanence des URL de lecture VOD

Lorsque l'autorisation du bucket de stockage d'une vidéo est privée, son URL de lecture n'est valable que pour une durée limitée. La chaîne d'authentification auth_key dans l'URL de lecture varie en fonction du délai d'expiration configuré.

Pour obtenir une adresse de lecture permanente, vous devez modifier l'autorisation du bucket de stockage de la vidéo en public-read ou public-read-write. La partie de l'adresse de lecture générée avant le caractère ? est une adresse permanente qui peut être utilisée pour la lecture indéfiniment. Pour plus d'informations sur les autorisations des buckets de stockage et sur leur modification, consultez Gérer les buckets de stockage.

L'URL de lecture redirige vers un navigateur

La lecture dépend des capacités de décodage du navigateur et de l'appareil, ce qui entraîne souvent une redirection vers le navigateur.

Vidéo mise à jour non affichée

Après avoir mis à jour une vidéo, vous devez actualiser l'URL pour récupérer les dernières données. Pour actualiser l'URL dans la console ApsaraVideo VOD, consultez Actualisation et préchargement. Pour actualiser l'URL à l'aide d'une API ou d'un SDK, consultez PreloadVodObjectCaches ou RefreshMediaPlayUrls.

Obtention des pixels d'image depuis le lecteur

• ApsaraVideo Player pour Android : Vous pouvez obtenir les pixels en écoutant le rappel OnRenderFrameCallback.

• ApsaraVideo Player pour iOS : Vous pouvez obtenir les pixels en écoutant le rappel onRenderingFrame.

  player.renderingDelegate = self;
  
  #pragma mark CicadaRenderingDelegate
  - (BOOL)onRenderingFrame:(CicadaFrameInfo*) frameInfo{
      if(frameInfo.frameType==Cicada_FrameType_Video){
          // Video
          NSLog(@"receive HW frame:%p pts:%ld foramt %d", frameInfo.video_pixelBuffer, frameInfo.pts, CVPixelBufferGetPixelFormatType(frameInfo.video_pixelBuffer));
  
      } else if (frameInfo.frameType==Cicada_FrameType_Audio){
          // Audio
      }
      return NO;
  }

• ApsaraVideo Player pour Web : Cette fonctionnalité n'est pas prise en charge.

Impossible d'obtenir l'URL de lecture pour les vidéos AVI

L'opération GetPlayInfo ne prend pas en charge l'obtention de flux vidéo au format AVI. Par conséquent, les SDK qui s'appuient sur cette opération ne peuvent pas obtenir de flux vidéo au format AVI.

Vous pouvez afficher l'URL de lecture d'une vidéo AVI dans la console ApsaraVideo VOD. Pour plus d'informations, consultez Interroger les fichiers audio ou vidéo.

Erreur GetPlayInfo : "The video has no stream to play for the request parameter"

Cette erreur correspond au code d'erreur API InvalidVideo.NoneStream (« La vidéo n'a aucun flux à lire pour le paramètre de demande »). Dans le SDK du lecteur, cette erreur est signalée sous le code d'erreur 31027.

Vous pouvez procéder au dépannage comme suit :

1. Confirmez que la classe de stockage de l'élément multimédia est Standard.

   Par défaut, l'opération GetPlayInfo renvoie des flux de lecture uniquement pour les éléments multimédias de la classe de stockage Standard. Pour obtenir des flux de lecture pour les éléments multimédias d'autres classes de stockage, définissez le paramètre StorageClass dans le paramètre PlayConfig sur All.

   Les autres valeurs valides pour StorageClass incluent Standard, IA (Infrequent Access), Archive, ColdArchive, SourceIA (Source Infrequent Access), SourceArchive (Source Archive), SourceColdArchive (Source Cold Archive), Changing (statut de l'élément multimédia en cours de modification) et SourceChanging (statut du fichier source en cours de modification). Une valeur vide indique qu'aucun filtrage n'est appliqué.

2. Confirmez que l'élément multimédia dispose d'un flux transcodé.

   Pour obtenir un flux transcodé, vous devez d'abord effectuer un transcodage vidéo et audio puis appeler l'opération GetPlayInfo. Pour obtenir l'URL du flux source, consultez GetMezzanineInfo.

3. Vérifiez si le format vidéo est MOV.

   Les téléchargements MOV sont pris en charge, mais par défaut ApsaraVideo VOD ne transcode pas les fichiers MOV. Par conséquent, l'opération GetPlayInfo ne peut pas renvoyer de flux de lecture et le SDK du lecteur signale le code d'erreur 31027. Si la vidéo est au format MOV et n'a pas été transcoded, appelez l'opération GetMezzanineInfo pour obtenir les informations sur le fichier source (telles que l'URL du fichier source et les métadonnées).

Réduction des saccades vidéo et amélioration du taux de succès du cache

Vous pouvez améliorer le taux de succès du cache en configurant la signature d'URL, en actualisant et préchargeant le contenu, en configurant la mise en cache et en filtrant les paramètres.

Saccades lors de la recherche

Si une vidéo comporte trop peu d'images clés, la recherche est lente car le lecteur doit décoder un segment vidéo plus large pour trouver une image. Cela provoque des saccades. Dans ce cas, vous pouvez transcoder la vidéo pour ajouter plus d'images clés et réduire les saccades. Pour plus d'informations sur le transcodage, consultez Transcodage vidéo et audio.

Erreur 0x200600001 MEDIA_PLAYER_ERROR_CODEC_VIDEO_NOT_SUPPORT

Si le message est vvc plugin not enabled, cela signifie que le plugin n'est pas activé dans votre application. Appelez la méthode AliPlayerGlobalSettings.enableCodecPlugin pour l'activer.

Si le message est vvc plugin not loaded, cela indique que le plugin n'a pas été intégré avec succès. Vérifiez si la bibliothèque du plugin a bien été importée dans le projet, ou appelez explicitement loadlibrary pour vous assurer que le plugin est chargé correctement.

Erreur 0x50020002 MEDIA_PLAYER_ERROR_CODEC_PREMIUM_INVALID

Cela indique qu'une licence Professional Edition n'a pas été obtenue. Le plugin de décodeur H.266 est une fonctionnalité de la Professional Edition. Pour plus d'informations sur l'obtention d'une licence Professional Edition, consultez Gérer les licences.

Impossible d'obtenir une vignette vidéo

La console ApsaraVideo VOD utilise le protocole HTTPS par défaut. Seules les ressources prenant en charge HTTPS peuvent être prévisualisées et affichées directement sous forme de captures d'écran. Vous pouvez également ouvrir les outils de développement du navigateur pour afficher les messages d'erreur spécifiques.

Vidéo illisible pendant la révision manuelle

ApsaraVideo VOD propose deux modes de révision. Si le mode de révision est défini sur « révision avant publication », la vidéo devient lisible uniquement après avoir passé la révision. Les deux modes de révision sont les suivants :

• Publication avant révision : Après le transcodage d'une vidéo, elle est marquée comme Normal par défaut et peut être lue directement. Vous devez ensuite réviser manuellement la vidéo. Si la vidéo est bloquée après la révision, elle ne peut pas être lue.

• Révision avant publication : Après le transcodage d'une vidéo, elle entre par défaut dans le processus de révision et est marquée comme Under Review. La vidéo devient lisible uniquement après avoir passé la révision manuelle.

VideoID

Pour des raisons de sécurité, ApsaraVideo VOD fournit un ID vidéo (videoID) au lieu d'une URL directe lorsque vous téléchargez un fichier multimédia. Vous pouvez également obtenir le videoID en appelant une OpenAPI ApsaraVideo VOD. Pour plus d'informations, consultez Obtenir une URL de lecture vidéo.

Après avoir téléchargé une vidéo sur ApsaraVideo VOD, vous obtenez un videoID.

Vous pouvez également obtenir le videoID dans la console ApsaraVideo VOD. La procédure est la suivante :

1. Connectez-vous à la console ApsaraVideo VOD.

2. Dans le volet de navigation de gauche, sous la section Media Files, cliquez sur Audio/Video.

3. Dans la liste des vidéos, obtenez le videoID.

Vous pouvez utiliser le videoID obtenu depuis la console pour tester le téléchargement et la lecture. Pour plus d'informations sur le téléchargement de fichiers vers ApsaraVideo VOD, consultez Présentation du SDK de téléchargement.

AccessKey ID et AccessKey secret

Un AccessKey ID et un AccessKey secret Alibaba Cloud sont les seuls identifiants permettant d'accéder aux API Alibaba Cloud. L'AccessKey ID est un identifiant d'identité. L'AccessKey secret est semblable à un mot de passe. Ne le divulguez jamais.

Pour obtenir vos identifiants :

1. Connectez-vous à la console ApsaraVideo VOD.

2. Placez le pointeur de la souris sur votre photo de profil dans le coin supérieur droit et cliquez sur AccessKey dans le menu contextuel.

3. Sur la page AccessKey, créez une paire AccessKey ou affichez l'AccessKey secret d'un AccessKey ID existant.

PlayKey

Une playKey (clé API) est une clé de lecture utilisée pour authentifier l'identité lorsque le SDK du lecteur obtient une URL de lecture vidéo. L'authentification de lecture est un mécanisme d'authentification secondaire basé sur l'authentification de sécurité AccessKey d'Alibaba Cloud. Elle peut efficacement prévenir le hotlinking. Par défaut, des playKeys sont fournies pour les plateformes Flash, HTML5, iOS et Android en fonction des plateformes que les utilisateurs peuvent utiliser pour la lecture.

Pour obtenir une clé :

1. Connectez-vous à la console ApsaraVideo VOD.

2. Dans le volet de navigation de gauche, sous Configuration Management, choisissez CDN Configuration > Download Settings. Activez le mode de téléchargement sécurisé.

3. Dans la section Get Key, saisissez l'Unique App Identifier et la Private Key.

4. Cliquez sur Generate and Download Key.

Playauth

Le lecteur prend en charge trois modes de lecture. Le mode playauth, implémenté via la méthode setAuthInfo, est le plus sécurisé et recommandé pour un usage commercial.

Un playauth est une chaîne chiffrée contenant des informations telles que le videoID, l'AccessKey ID et l'AccessKey secret. Le service ApsaraVideo VOD mélange et chiffre ces informations. Lorsque le lecteur reçoit le playauth, il peut lire la vidéo.

Flux : Le serveur obtient un identifiant de lecture > Le serveur envoie l'identifiant de lecture au client > La lecture vidéo est terminée.

1. Obtention d'un identifiant de lecture : Sur le serveur, appelez le SDK d'authentification de lecture (SDK côté serveur) pour obtenir un identifiant de lecture auprès du service ApsaraVideo VOD.

2. Finalisation de la lecture vidéo : Le SDK du lecteur utilise l'ID vidéo et l'identifiant de lecture pour obtenir l'URL de lecture de la vidéo auprès du service ApsaraVideo VOD. Il charge ensuite le flux vidéo et le décode pour la lecture.