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�:
- Sortie dans diff�rents formats de conteneurs MPEG-4 (MP4), Dynamic Adaptive Streaming over HTTP (DASH, �galement appel� MPEG-DASH) et le streaming HTTP en direct (HLS)
- Sortie � diff�rents d�bits et r�solutions, y compris en sortie audio uniquement
- Conversion en le format HDR (High Dynamic Range)
- Optimiser la sortie vid�o par programmation, y compris�:
- Configurer des param�tres d'encodage de bas niveau, tels que le d�bit
- Remixer du contenu multim�dia existant � l'aide de listes d'�ditions compl�tes
- D�finissez le mode de t�che sur le mode interactif � faible latence ou le mode de traitement par lot.
- Sp�cifier la normalisation du volume audio
- Configurer le chiffrement de la vid�o de sortie pour prendre en charge la gestion des droits num�riques et la protection du contenu
- 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�ches pour enregistrer et r�utiliser des configurations personnalis�es ou complexes pour les t�ches de transcodage
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�e | 4096 px |
Hauteur d'entr�e maximale | 4�096�px |
Largeur maximale de sortie | 4�096�px |
Hauteur de sortie maximale | 2�160�px |
Taille totale de sortie | 400�Go |
Dur�e EditList maximale | 24�heures |
Nombre maximal de flux vid�o | 70 |
Nombre maximal de flux audio | 50 |
Nombre maximal de flux de texte | 50 |
Nombre maximal de flux multiplex | 100 |
Nombre maximal de fichiers manifestes | 100 |
Nombre maximal de feuilles de sprites | 10 |
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.
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.
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�finitionmedia-hd0000000000.ts
�: fichier de s�quence vid�o en haute d�finition
media-sd.m3u8
�: playlist pour la variante en d�finition standardmedia-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 uniquementvideo-only-hd0000000000.m4s
�: fichier de s�quence vid�o uniquement en haute d�finitionvideo-only-sd0000000000.m4s
�: fichier de s�quence vid�o uniquement en d�finition standard
sd.mp4
�: fichier vid�o en d�finition standard autonomehd.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
- Lisez le guide de d�marrage rapide.
- D�couvrez comment effectuer des t�ches de l'API Transcoder sp�cifiques.