Pr�sentation de l'API Transcoder

Cette page fournit une pr�sentation technique de l'API Transcoder, y compris les fonctionnalit�s, la terminologie et les concepts utiles. L'API Transcoder impl�mente 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�:

Pour en savoir plus sur les normes MP4 et MPEG-DASH, consultez le site Web de Moving Picture Experts Group. Pour en savoir plus sur la norme HLS, consultez la page HTTP Live�Streaming.

Conteneurs compatibles pour le chiffrement de contenu

Le tableau suivant pr�sente les conteneurs compatibles avec le chiffrement de contenu.

Protocole de streaming Conteneur Syst�me DRM Sch�ma de chiffrement
HLS TS ClearKey aes128
HLS TS FairPlay sampleAes
HLS fMP4 FairPlay mpegCenc cbcs uniquement
MPEG-DASH fMP4 Widevine mpegCenc cenc ou cbcs
MPEG-DASH fMP4 PlayReady mpegCenc cenc ou cbcs

Contr�le des acc�s

Le mod�le de contr�le des acc�s de l'API Transcoder est bas� sur Identity and Access�Management (IAM) de Google. Les autorisations IAM vous permettent de contr�ler avec pr�cision la mani�re dont les donn�es multim�dias peuvent �tre trait�es, et par qui.

Limites

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

Limites des t�ches
Largeur maximale de l'entr�e4096 px
Hauteur d'entr�e maximale4�096�px
Largeur maximale de sortie4�096�px
Hauteur de sortie maximale2�160�px
Taille totale de sortie400�Go
Dur�e EditList maximale24�heures
Nombre maximal de flux vid�o70
Nombre maximal de flux audio50
Nombre maximal de flux de texte50
Nombre maximal de flux multiplex100
Nombre maximal de fichiers manifestes100
Nombre maximal de feuilles de sprites10

Concepts

Cette section pr�sente des concepts importants concernant les fichiers vid�o et leur utilisation avec l'API Transcoder.

Composants d'un fichier vid�o

Chaque fichier vid�o poss�de un conteneur, qui constitue le wrapper pour l'ensemble du fichier. L'API Transcoder utilise des MuxStreams pour d�finir le conteneur. Chaque conteneur comprend un ensemble ElementaryStreams pour d�finir l'encodage des pistes audio, vid�o et de texte des sous-titres . La vid�o et l'audio sont compress�s � l'aide de codecs.

Dans l'exemple suivant, la vid�o est compress�e avec H.264 et l'audio avec AAC. Tous deux sont plac�s dans un conteneur MP4.

Composants d'un fichier vid�o et exemple
Figure�1. Composants d'un fichier vid�o (� gauche) et exemple de fichier MP4 (� droite).

Structure du protocole de streaming

Pour le streaming multim�dia, les fournisseurs de contenu encodent le m�me contenu � plusieurs (mesur�s en kilobits par seconde). Le fournisseur g�n�re ensuite fichier manifeste qui pointe vers les diff�rents fichiers avec des d�bits diff�rents. Le lecteur multim�dia en streaming utilise le fichier manifeste pour s�lectionner le fichier appropri�, puis extrait la vid�o par tranche de quelques secondes. Chaque d�bit peut �tre un seul fichier ou plusieurs fichiers courts, en fonction de ce que le lecteur accepte.

Les diff�rentes r�solutions des contenus multim�dias sont g�n�ralement encod�es pour cibler et diff�rents d�bits. Par exemple, les d�bits inf�rieurs sont encod�s en d�finition standard (SD) au lieu de haute d�finition (HD). L'ensemble des d�bits, r�solutions et codecs est appel� "�chelle � d�bit adaptatif" (ABR). Les fournisseurs de contenus en streaming peuvent ajuster leur propre �chelle en fonction des co�ts du CDN, des types d'appareils des utilisateurs, de la bande passante dans la r�gion et d'autres facteurs.

Composants d'une structure de protocole de streaming et exemple
Figure�2. Composants d'une structure de protocole de streaming (en haut) et exemple Impl�mentation de HTTP Live Streaming (HLS) (en bas)

Terminologie

Cette section fournit un glossaire contenant des termes utiles pour l'utilisation de l'API Transcoder.

Coupure publicitaire

Une coupure publicitaire est une courte annonce qui appara�t avant ou pendant la lecture d'un 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 ou ne diffuse aucune publicit�, et n'arr�te pas la lecture des contenus multim�dias. Les clients du lecteur vid�o sont responsables du traitement 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 de codec et profil

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, par exemple 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 conteneurs 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, par exemple une piste audio, vid�o ou de texte de sous-titres. Vous devez empaqueter les flux �l�mentaires avant de mapper et de partager le flux avec diff�rents formats de sortie.

Codage entropique

Le codage entropique est une forme de compression sans perte compatible avec l'API Transcoder. Lors de la configuration des t�ches, vous pouvez sp�cifier le codeur entropique CAVLC (Context-Adaptive Variable-Length Coding) ou CABAC (Context-Adaptive Binary Arithmetic Coding).

T�che

Une t�che est l'unit� de base pour la gestion du travail � r�aliser 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 �galement appel� r�gion. Vous pouvez r�pertorier et g�rer toutes les t�ches d'une r�gion.

Le cycle de vie d'une t�che comprend trois��tapes�: pr�parer, transcoder et empaqueter.

  • Pr�parer
    • T�l�charger les entr�es depuis Cloud�Storage
    • Analyser les entr�es
    • Valider les entr�es
  • Transcoder
    • Ex�cuter des op�rations de transcodage sur les entr�es
  • Empaqueter
    • Entr�es d'assemblage
    • Entr�es multiplex
    • Importer les 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 lors de la cr�ation et de l'envoi d'une t�che � l'API Transcoder. Vous pouvez sp�cifier des param�tres de configuration tels que des listes d'�ditions et l'endroit 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.

Mode du job

L'API Transcoder est compatible avec deux modes de t�che�: interactif et par lot.

Le mode interactif est le mode de t�che par d�faut. Utilisez ce mode si vous souhaitez le traitement des donn�es le plus rapidement possible ou si vous souhaitez de contr�ler quelles t�ches sont ex�cut�es en premier. Dans ce mode, le quota de nombre de t�ches simultan�es contr�le le nombre de t�ches ex�cut�es simultan�ment. Une fois ce quota atteint, toutes les t�ches que vous essayez de d�marrer sont refus�es.

Utiliser le mode de traitement par lot pour envoyer de nombreuses t�ches pour lesquelles la latence de traitement est inf�rieure essentielles en tant que jobs soumis en mode interactif par d�faut. Vous pouvez sp�cifier priorit� du traitement des t�ches pour une t�che dans ce mode. T�ches envoy�es en mode de traitement par lot avec la m�me priorit� sont plac�es dans une file d'attente "premier entr�, premier sorti" et ont l'�tat de t�che PENDING. en attendant leur ex�cution. Dans ce mode, le quota de nombre de t�ches en attente de traitement par lot contr�le le nombre de t�ches mises en file d'attente. Une fois ce quota atteint, toutes les t�ches que vous essayez de d�marrer sont rejet�s. Une t�che passe � l'�tat RUNNING lors de son ex�cution. Le quota de jobs simultan�s par lot contr�le le nombre de jobs ex�cut�s simultan�ment.

Vous pouvez utiliser les deux modes en m�me temps. Un mode n'a pas la priorit� l'autre. Pour plus d'informations sur la d�finition du mode de t�che, consultez l'article Cr�er des t�ches en mode de traitement par lot

Mod�le de t�che

Par d�faut, l'API Transcoder applique un mod�le pr�d�fini appel� preset/web-hd pour renseigner une configuration de t�che. Cette configuration de job g�n�re les fichiers de sortie suivants:

  • manifest.m3u8: le playlist principale pour un flux multim�dia HLS. Ce fichier contient des r�f�rences � des playlists pour la variante en haute d�finition (HD) de la sortie et la variante en d�finition standard (SD) de la sortie.
    • media-hd.m3u8�: playlist pour la variante en haute d�finition
      • media-hd0000000000.ts�: fichier de s�quence vid�o en haute d�finition
    • media-sd.m3u8�: playlist pour la variante en d�finition standard
      • media-sd0000000000.ts�: fichier de s�quence vid�o en d�finition standard
  • manifest.mpd�: playlist pour un flux multim�dia MPEG-DASH. Ce fichier contient des r�f�rences aux fichiers de s�quence vid�o uniquement et de s�quence audio uniquement.
    • audio-only0000000000.m4s�: fichier de s�quence audio uniquement
    • video-only-hd0000000000.m4s�: fichier de s�quence vid�o uniquement en haute d�finition
    • video-only-sd0000000000.m4s�: fichier de s�quence vid�o uniquement en d�finition standard
  • sd.mp4�: fichier vid�o en d�finition standard autonome
  • hd.mp4�: fichier vid�o en haute d�finition autonome

Vous pouvez cr�er et g�rer vos propres mod�les de t�che personnalis�s et les sp�cifier lors de la cr�ation des t�ches.

Pr�traitement

Le pr�traitement est l'�tape d'une t�che qui a lieu avant le transcodage principal.

Configuration du pr�traitement

Une configuration de pr�traitement repr�sente les param�tres que vous pouvez appliquer � une vid�o avant l'�tape de transcodage d'une t�che. Vous pouvez recadrer ou dans le cadre de cette configuration.

Mode de contr�le du taux

Le mode de contr�le du taux indique si une t�che doit �tre trait�e � l'aide du mode CRF (facteur de taux constant) ou VBR (taux variable). Le mode CRF garantit une qualit� constante tout au long des ressources multim�dias trait�es. Le mode VBR optimise le processus d'encodage afin de r�duire la taille de fichier des ressources multim�dias trait�es. Pour les cas d'utilisation par flux, s�lectionnez le mode de contr�le du taux VBR. � des fins d'archivage, s�lectionnez le mode de contr�le du taux CRF.

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