Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:FAQ sur le transcodage

Dernière mise à jour :Sep 14, 2026

Cette rubrique répond aux questions fréquemment posées concernant le transcodage dans ApsaraVideo VOD.

Comment résoudre un échec de transcodage ?

  • Vérifiez que le fichier source est lisible sur un appareil local. Cette étape est cruciale, car la plupart des échecs de transcodage proviennent de problèmes inhérents au fichier source lui-même. Les problèmes courants incluent l'absence de flux vidéo, des métadonnées invalides, des erreurs d'images ou une en-tête vidéo manquante. Ces anomalies peuvent déclencher la surveillance de l'efficacité du transcodage et entraîner l'échec de la tâche.

    • Exécutez la commande ffprobe -show_streams -show_format -of json -i [filePath] pour inspecter les métadonnées du fichier et détecter d'éventuels problèmes, tels qu'un atome moov manquant ou des anomalies de flux.

    • Exécutez la commande ffprobe -show_packets -i [filePath] pour vérifier l'intégrité du flux de données et vous assurer que la durée du flux correspond à celle indiquée dans les métadonnées.

      Remarque

      Une divergence entre la durée spécifiée dans les métadonnées et la durée réelle du flux peut provoquer l'échec du transcodage. Si un fichier contient des métadonnées invalides, utilisez un outil tel que FFmpeg pour le corriger localement avant de le télécharger pour transcodage.

  • Consultez la liste des Codes d'erreur pour identifier la cause précise de l'échec.

  • Pour éviter toute troncature ou tout échec de tâche, échappez tous les caractères spéciaux utilisés dans les filigranes textuels.

  • En cas d'échec d'une tâche de transcodage avec chiffrement, reportez-vous à la FAQ sur le chiffrement vidéo pour connaître les erreurs courantes liées au chiffrement standard HLS.

Problèmes de lecture avec le modèle Sans transcodage

Ce problème peut survenir pour les raisons suivantes :

  • Cause 1 : La vidéo source est corrompue et ne peut pas être lue.

  • Cause 2 : Seules les vidéos aux formats MP4, FLV, M3U8, MP3 et WEBM peuvent être lues directement sans transcodage.

    • Lorsque vous téléchargez une vidéo vers ApsaraVideo VOD en utilisant le groupe de modèles intégré No Transcoding, un flux vidéo de qualité d'origine est généré si la vidéo source est au format MP4, FLV, M3U8, MP3 ou WEBM. Pour les autres formats, un flux de vidéo d'origine est généré.

    • Un flux de vidéo d'origine ne peut pas être prévisualisé dans la console ApsaraVideo VOD, et vous ne pouvez pas obtenir son URL de lecture en appelant l'API Obtenir l'URL de lecture audio et vidéo. Vous pouvez uniquement obtenir l'URL du fichier source pour la lecture en appelant l'API Obtenir les informations du fichier source. En revanche, un flux vidéo de qualité d'origine peut être prévisualisé dans la console ApsaraVideo VOD, et vous pouvez obtenir son URL de lecture en appelant l'API Obtenir l'URL de lecture audio et vidéo.

  • Cause 3 : Le codec vidéo est incompatible avec le lecteur du navigateur.

    • Le conteneur de la vidéo source peut être au format MP4, mais si le flux vidéo à l'intérieur du conteneur est encodé en MPEG-4 Part 2 (mp4v), le lecteur HTML5 du navigateur ne prend pas en charge ce codec. Si vous téléchargez une telle vidéo en utilisant le groupe de modèles No Transcoding, elle ne pourra pas être lue. Les navigateurs prennent en charge les codecs H.264 et H.265.

    • Pour vérifier le codec, exécutez la commande ffprobe -show_streams -i [filePath] et examinez le champ codec_name dans la sortie. Si la valeur est mpeg4, la vidéo est encodée en MPEG-4 Part 2 et le navigateur ne peut pas la lire.

    • Pour résoudre ce problème, utilisez l'une des méthodes suivantes :

      • Utilisez FFmpeg localement pour transcoder la vidéo vers le codec H.264, puis retéléchargez le fichier vers le même emplacement Object Storage Service (OSS) en conservant le même nom de fichier. ApsaraVideo VOD générera une nouvelle URL de lecture basée sur le fichier retéléchargé.

      • Créez un groupe de modèles de transcodage utilisant le codec H.264 dans la console ApsaraVideo VOD, et utilisez-le pour transcoder la vidéo existante. Vous pourrez ensuite lire le flux transcodé.

Réduction de plusieurs flux audio à un seul flux

Actuellement, le transcodage ne conserve qu'un seul flux audio. Ce comportement est contrôlé par le paramètre audioMap=0 dans le paramètre Output. Si votre cas d'utilisation nécessite plusieurs flux audio, soumettez un ticket.

La résolution de sortie ne correspond pas aux paramètres

Dans les modèles de transcodage d'ApsaraVideo VOD, la fonction de rotation automatique de l'écran (LongShortMode) est activée par défaut. Lorsque cette fonction est activée, width correspond au côté long et height correspond au côté court. Vous devez définir uniquement l'une de ces valeurs et laisser l'autre vide. Si vous souhaitez imposer une résolution de sortie spécifique, vous devez désactiver la fonction de rotation automatique de l'écran. Notez que la désactivation de cette fonction peut entraîner un étirement ou une distorsion de la vidéo de sortie.

Orientation incorrecte de la vidéo après transcodage

Cela se produit généralement si la vidéo source contient un indicateur de rotation dans ses métadonnées, tel que rotation=-90, qui inverse la largeur et la hauteur de la vidéo lors du transcodage. Vous pouvez utiliser un outil comme FFmpeg pour inspecter les informations de rotation du fichier source. Pour vérifier les informations du fichier, exécutez la commande suivante :

ffprobe -show_streams -show_format -of json -i  [filepath]

Écran noir sur les fichiers M3U8 transcodés

Vérifiez d'abord si le flux vidéo de votre fichier source est valide. Si le premier segment Transport Stream (TS) du fichier source ne contient pas de données vidéo, le lecteur peut ne pas afficher la vidéo. Dans ce cas, essayez de transcoder d'abord le fichier source en MP4, puis transcodez le fichier MP4 résultant en M3U8. Cette procédure devrait résoudre le problème de lecture.

Problèmes d'exposition après conversion HDR vers SDR

Si votre vidéo source est au format HDR, sélectionnez SDR Mapping dans les paramètres de plage dynamique de votre modèle de transcodage.

La fonction SDR Mapping est en aperçu public. Des frais seront appliqués pour cette fonctionnalité à la fin de la période d'aperçu public. Pour plus d'informations, consultez la section Frais d'amélioration audio et vidéo. Si le problème persiste, soumettez un ticket pour obtenir de l'aide.

Gestion de la boîte moov lors du transcodage

Après le transcodage, ApsaraVideo VOD place la boîte moov au début du fichier MP4 par défaut. Ce comportement n'est pas personnalisable. Les fichiers ne contenant pas de boîte moov ne peuvent pas être traités et entraîneront l'échec de la tâche de transcodage.

Incohérence de durée lors de la conversion vidéo vers audio

Pour garantir la cohérence de la durée, la logique de transcodage d'ApsaraVideo VOD utilise le flux audio le plus court du fichier d'entrée comme base de synchronisation. Si les horodatages de certains segments du fichier source ne sont pas continus, le service peut être incapable de récupérer les informations multimédias du flux vidéo. Cela affecte l'estimation de la durée et peut entraîner une divergence.

Erreurs de lecture pour les fichiers audio uniquement

Vérifiez que le traitement vidéo est désactivé dans votre modèle de transcodage. Pour un fichier audio uniquement, vous devez désactiver le traitement vidéo. Vous pouvez effectuer cette configuration dans les paramètres du modèle.

Sur la page Add Transcoding Template Group de la console ApsaraVideo Media Processing, définissez le type de transcodage sur Normal Transcoding et le format de conteneur sur MP4 (.mp4). Dans les paramètres vidéo, définissez le codec sur H.264, la résolution sur By Long Side and Short Side, et les côtés long et court sur un nombre entier pair compris dans la plage [128, 4096].

Les paramètres de débit binaire ne sont pas appliqués

Vérifiez si vous avez activé le mécanisme de vérification du débit binaire dans votre modèle de transcodage. Dans la console ApsaraVideo VOD, vous trouverez cette fonctionnalité dans un modèle de transcodage régulier sous Conditional Transcoding Parameters, intitulée soit Check video bitrate, soit Check audio bitrate. Lorsque ce mécanisme est activé, le débit binaire défini dans le modèle peut ne pas prendre effet dans certaines conditions. Plus précisément, si l'encodeur de sortie est identique à l'encodeur source et que le débit binaire cible est supérieur au débit binaire source, le service réinitialise soit le débit binaire de sortie pour qu'il corresponde au débit binaire source, soit ignore le transcodage du flux, selon votre configuration.

Quelle est la durée d'une tâche de transcodage ?

Important

Les valeurs de référence ci-dessous décrivent la vitesse de traitement dans des conditions de test typiques, une fois que la tâche de transcodage a commencé. Ces valeurs n'incluent aucun temps d'attente dans la file d'attente, ne représentent pas le temps total d'achèvement de la tâche et ne constituent pas un accord de niveau de service (SLA).

Pour un scénario de transcodage typique vers H.264 720P, les vitesses de traitement pour différents algorithmes de transcodage sont les suivantes :

Algorithme de transcodage

Vitesse de traitement

Description

transcodage régulier

Vitesse moyenne : env. 3x

Cette valeur reflète la vitesse de traitement pendant la phase de transcodage dans des conditions typiques.

Narrowband HD™ 1,0

Vitesse moyenne : env. 1,5x

Le temps de traitement est généralement plus long que celui du transcodage régulier.

Narrowband HD™ 2,0

Généralement bien inférieur à la vitesse 1x

Le temps de traitement est souvent plus long que la durée de la vidéo source. Le temps réel dépend de la tâche spécifique.

Multiplicateur de vitesse

Speed multiplier = Duration of video processed per unit of processing time

Example:
A 3x speed means that approximately 3 minutes of video content can be processed in 1 minute of processing time.
Therefore, excluding queuing time, a 30-minute video would theoretically take about 10 minutes to process.
Remarque
  • Les valeurs de référence s'appliquent uniquement aux scénarios de transcodage H.264 720P typiques.

  • Ces valeurs ne doivent pas être utilisées pour estimer le temps total d'achèvement de la tâche.

  • La vitesse de traitement est généralement plus faible pour les résolutions plus élevées, les codages plus complexes ou les paramètres plus intensifs.

  • Les différences de débit binaire, de fréquence d'images, de format de conteneur et de structure de flux de la vidéo source peuvent affecter considérablement le temps de traitement.

  • La complexité de traitement de Narrowband HD™ 2,0 est nettement supérieure à celle du transcodage régulier et de Narrowband HD™ 1,0.

  • Consultez l'état de la tâche ou la notification d'achèvement pour connaître le temps de traitement réel.

Interrogation de la progression du transcodage

ApsaraVideo VOD ne fournit pas d'API pour interroger la progression en temps réel d'une tâche de transcodage. Vous pouvez toutefois configurer des notifications d'événements pour recevoir des notifications concernant l'état de la tâche.

Puis-je effectuer un transcodage par lot ?

ApsaraVideo VOD ne prend pas directement en charge les opérations de transcodage par lot pour les médias existants. Le système transcode automatiquement les vidéos lors du processus de téléchargement en utilisant des modèles de transcodage ou des workflows. Cependant, si vous stockez vos médias dans vos propres compartiments Object Storage Service (OSS), vous pouvez réaliser un transcodage par lot en intégrant Intelligent Media Management (IMM). Vous pouvez créer un projet IMM, puis définir une tâche de traitement par lot en utilisant des critères tels qu'une correspondance de préfixe pour transcoder efficacement plusieurs vidéos. Pour plus d'informations, consultez la section Traitement par lot dans OSS.

Pourquoi mes tâches de transcodage échouent-elles continuellement ?

Les échecs de tâches peuvent avoir diverses causes. Vérifiez toujours le message d'erreur renvoyé. Si vous recevez une erreur d'échec de prétraitement, cela signifie que le service n'a pas pu décoder votre fichier source. Dans ce cas, soumettez un ticket et fournissez les informations suivantes pour nous aider à diagnostiquer le problème : votre ID de compte Alibaba Cloud et l'ID de la vidéo.

ApsaraVideo VOD prend-il en charge le transcodage en temps réel ?

ApsaraVideo VOD est un service de transcodage basé sur des fichiers et ne prend pas en charge le transcodage en temps réel.

Transcodage par lot pour les vidéos existantes

ApsaraVideo VOD ne prend pas en charge le transcodage par lot pour les vidéos déjà téléchargées.

Le filigrane n'apparaît pas après le transcodage

Vérifiez les paramètres du modèle de filigrane utilisé pour le transcodage, tels que ses dimensions (largeur × hauteur) et ses décalages. Assurez-vous que ces paramètres placent le filigrane dans les limites de la résolution de la vidéo. Si les paramètres du filigrane le placent en dehors du cadre vidéo, il ne sera pas visible, même si la tâche de transcodage se termine avec succès.

Sur la page Edit Watermark Template, les paramètres de décalage correspondent aux champs Horizontal Offset et Vertical Offset. Vérifiez-les conjointement avec la Size (Width × Height) et la Position du filigrane pour vous assurer que celui-ci ne dépasse pas du cadre vidéo.

Si la vidéo source comporte des bandes noires (letterboxing), le filigrane peut être inscrit dans la zone des bandes noires. Lorsque la couleur du filigrane est proche de celle des bandes noires (par exemple, un filigrane noir sur des bandes noires), le filigrane devient invisible en raison d'un contraste insuffisant. Modifiez la couleur de police du filigrane pour une couleur offrant un fort contraste avec les bandes noires (par exemple, blanc), ou ajustez le décalage horizontal (Dx) et le décalage vertical (Dy) pour déplacer le filigrane vers le centre du cadre, loin de la zone des bandes noires.

Absence de rappels pour les échecs de transcodage

Lorsque vous configurez des notifications d'événements pour le transcodage, si vous vous abonnez uniquement à l'événement Single Definition Transcoding Complete (StreamTranscodeComplete) et non à l'événement TranscodeComplete, vous risquez de ne pas recevoir de notifications d'échec dans certains scénarios. Par exemple, si vous téléchargez un fichier source corrompu qui entraîne l'échec de tous les flux de sortie, ApsaraVideo VOD envoie un rappel d'échec pour l'événement TranscodeComplete. Comme vous n'êtes pas abonné à cet événement, vous ne recevrez pas de notification d'échec du transcodage.

Comment configurer le transcodage pour les vidéos chiffrées DRM et non chiffrées ?

Vous ne pouvez pas produire des flux chiffrés et non chiffrés à partir du même groupe de modèles de transcodage. Créez deux groupes de modèles de transcodage distincts et utilisez le groupe approprié pour chaque vidéo :

  1. Créez un groupe de modèles de transcodage pour la sortie chiffrée. Activez le chiffrement DRM et définissez le format de conteneur sur HLS.

  2. Créez un groupe de modèles de transcodage pour la sortie non chiffrée. N'activez pas le chiffrement.

  3. Utilisez un workflow ou spécifiez différents ID de groupes de modèles de transcodage lors du téléchargement des vidéos. Assignez le groupe activé pour DRM aux vidéos nécessitant un chiffrement, et le groupe non chiffré aux vidéos qui n'en nécessitent pas.

Actuellement, vous ne pouvez déclencher le transcodage chiffré DRM qu'à partir de la console ApsaraVideo VOD, et uniquement en utilisant un workflow. Cela s'applique aussi bien aux vidéos en cours de téléchargement qu'aux vidéos déjà téléchargées.