Présentation de l'API Transcoder

Cette page fournit une présentation technique de l'API Transcoder, y compris des fonctionnalités, la terminologie et des concepts utiles. L'API Transcoder met en œuvre une API REST et RPC qui vous permet d'envoyer, de surveiller et de gérer des tâches de transcodage dans Google Cloud. Pour envoyer des tâches à l'aide de l'API Transcoder, vous devez d'abord importer les éléments multimédias dans Cloud Storage. Après le traitement d'une tâche, l'API Transcoder enregistre le contenu multimédia obtenu dans Cloud Storage.

Fonctionnalités

L'API Transcoder est compatible avec les fonctionnalités suivantes :

  • Insérer des images clés pour permettre aux clients du lecteur vidéo d'insérer des annonces
  • Créer des miniatures à partir d'une fiche technique sur les images vidéo générée
  • Créer des modèles de tâche pour enregistrer et réutiliser des configurations personnalisées ou complexes pour le transcodage de tâches
  • Pour en savoir plus sur les normes MP4 et MPEG-DASH, consultez le site Web du groupe d'experts en mouvement. Pour en savoir plus sur la norme HLS, consultez la page HTTP Live Streaming.

    Entrées et sorties compatibles

    Le tableau suivant présente les formats d'entrée et de sortie compatibles avec l'API Transcoder.

    Formats d'entrée et de sortie acceptés
    Entrées
    ConteneursAVI, GXF, MKV (Matroska), MOV, MPEG2-TS, MP4, MXF (OP1A uniquement), WMV
    Codecs vidéoDNxHD, DV/DVCProHD, DV25, DV50, H.261, H.262, H.263, H.264 (AVC), H.265 (HEVC), MPEG-1, MPEG-2, MPEG-4 partie 2, ProRes, Theora, VC-1, VP8, VP9, XDCAM
    Codecs audioAAC, AC3, AIFF, E-AC3, MP3, Opus, PCM, WAV, WMA, WMA2, Vorbis
    Sous-titresclauses contractuelles types, SRT, VTT
    SuperpositionsJPG
    Résultats
    ConteneursApple HLS (avec MPEG2-TS, fMP4), MPEG-DASH (avec fMP4), MP4 autonome
    Codecs vidéoH.264 (AVC), H.265 (HEVC), VP9
    Codecs audioAAC-HE, AAC-HEv2, AAC-LC, AC3, E-AC3 et MP3
    Sous-titresCEA-608/708, WebVTT
    ImagesMosaïques JPG, images individuelles

    Contrôle des accès

    Le modèle de contrôle d'accès de l'API Transcoder est basé sur la gestion de l'authentification et des accès de Google. Les autorisations précises d'IAM vous permettent de contrôler ce que vous pouvez faire avec les données multimédias et par qui.

    Limites

    Le tableau suivant indique les limites par tâche de transcodage.

    Limites de tâches
    Taille totale de la saisie400 Go
    Taille totale de sortie400 Go
    Durée maximale : EditList24 heures
    Nombre maximal de flux vidéo30
    Nombre maximal de flux audio50
    Nombre maximal de flux de texte50
    Nombre maximal de flux multiple100
    Nombre maximal de fichiers manifestes100
    Nombre maximal de feuilles de sprites10

    Concepts et terminologie

    Cette section fournit un glossaire des termes utiles pour utiliser l'API Transcoder.

    Coupure publicitaire

    Une coupure publicitaire est une courte annonce qui apparaît avant ou pendant la lecture du contenu multimédia. L'API Transcoder accepte une image clé de coupure publicitaire dans la configuration de la tâche. L'API Transcoder n'insère ni ne diffuse d'annonces, et n'arrête pas la lecture des contenus multimédias. les clients de lecteur vidéo sont responsables de la gestion de l'image clé.

    Atom

    Un élément atom est une structure de données fondamentale permettant de définir les métadonnées et l'emplacement d'une vidéo. Une vidéo peut comprendre une hiérarchie imbriquée complexe de différents types d'élément atom, y compris des éléments atom audio, d'édition et de texte.

    Élément atom audio

    Un élément atom audio associe l'audio d'un flux élémentaire à une liste d'éditions.

    Type et profil de codec

    Lorsque vous sélectionnez le codec pour un flux vidéo, vous spécifiez le type de codec, tel que H.264 et le profil, tel que le profil high par défaut.

    Conteneur

    Un conteneur est un wrapper qui décrit la relation entre les différents composants d'un flux multiplexé, y compris les fichiers multimédias et les métadonnées. L'API Transcoder est compatible avec les formats de conteneur MP4, MPEG-DASH et HLS.

    Élément atom d'édition

    Un élément atom d'édition définit les décalages de début et de fin pour les segments spécifiques d'un flux que vous souhaitez combiner dans une liste d'éditions.

    Modifier la liste

    Une liste d'éditions définit une séquence d'éditions sous la forme d'une chronologie pour le fichier ou le fichier manifeste résultant d'une tâche de transcodage.

    Flux élémentaire

    Un flux élémentaire est un encodage d'un fichier d'entrée, tel qu'une piste de texte audio, vidéo ou de sous-titre. Vous devez empaqueter les flux élémentaires avant de les mapper et de les partager dans différents formats de sortie.

    Encodage entropique

    L'encodage entropique est une forme de compression sans perte compatible avec l'API Transcoder. Lors de la configuration des tâches, vous pouvez spécifier les codeurs d'entropie en cas de codage binaire et CAB (Context-Adaptive Variable-Length Coding)

    Tâche

    Une tâche est l'unité de base pour gérer le travail avec l'API Transcoder. Lorsque vous envoyez une tâche à l'API Transcoder, elle est traitée de manière asynchrone dans un emplacement géographique appelé région. Vous pouvez répertorier et gérer l'ensemble des tâches d'une région.

    Le cycle de vie d'une tâche comprend trois étapes: la préparation, le transcodage et le package.

    • Préparation
      • Télécharger les entrées depuis Cloud Storage
      • Analyser les entrées
      • Valider les entrées
    • Transcodage
      • Exécuter des opérations de transcodage sur les entrées
    • Package
      • Assembler les entrées
      • Entrées multiplex
      • Importer des sorties dans Cloud Storage

    Une tâche possède un état mis à jour. Le service signale les erreurs à l'aide du champ error.

    Configuration de la tâche

    Une configuration de tâche représente un grand nombre des paramètres que vous pouvez personnaliser lorsque vous créez et envoyez une tâche à l'API Transcoder. Vous pouvez spécifier des paramètres de configuration tels que des listes de modification et l'emplacement où insérer des tags de coupure publicitaire dans un fichier manifeste de sortie. Vous pouvez créer des configurations de tâches réutilisables en tant que modèles de tâches à utiliser dans une région Google Cloud.

    Modèle de tâche

    Par défaut, l'API Transcoder applique un modèle prédéfini appelé preset/web-hd pour insérer une configuration de tâche. Vous pouvez créer et gérer vos propres modèles de tâches personnalisées, et les spécifier lors de la création de tâches.

    Prétraitement.

    Le prétraitement est l'étape d'une tâche qui a lieu avant le transcodage principal. Lors de la configuration de la phase de prétraitement, vous pouvez appliquer des filtres tels que la couleur, la suppression et la déblocage. Le déblocage peut aider à réduire les artefacts de bloc résultant de la compression.

    Configuration du prétraitement

    Une configuration de prétraitement représente les paramètres des filtres que vous pouvez appliquer à une vidéo avant le transcodage d'une tâche. Vous pouvez appliquer de nombreux filtres, comme la saturation des couleurs, le filtrage anti-bloc et la suppression des bruits de fond.

    Mode de contrôle du débit

    Le mode de contrôle du débit indique s'il faut traiter une tâche à l'aide des modes facteur de vitesse constante (CRF) ou débit variable (VBR). Le formulaire d'observation fournit une qualité constante pour tous les éléments multimédias traités. La technologie VBR optimise le processus d'encodage pour réduire la taille des fichiers des éléments multimédias traités. Pour les cas d'utilisation du streaming, sélectionnez le mode de contrôle du débit VBR. À des fins d'archivage, sélectionnez le mode de contrôle du débit du formulaire d'observation.

    Fichier manifeste

    Un fichier manifeste est une description du contenu et des métadonnées disponibles d'un flux multimédia adaptatif vers un client. Dans l'API Transcoder, vous pouvez configurer une tâche pour générer un fichier manifeste avec un nom de fichier, une liste de flux multiplexés ainsi que le type du fichier manifeste, qui doit être au format HLS ou MPEG-DASH.

    Élément atom de texte

    Un élément atom de texte mappe le texte d'un flux élémentaire à une liste d'éditions.

    Flux de texte

    Un flux de texte encode les données de texte associées à une vidéo, telles que des sous-titres.

    Étape suivante