Paramètres que vous spécifiez lorsque vous créez un Elastic Transcoder Job

Nom du pipeline que vous souhaitez qu'Elastic Transcoder utilise pour le transcodage. Le pipeline détermine plusieurs paramètres, notamment le compartiment Amazon S3 à partir duquel Elastic Transcoder obtient les fichiers à transcoder et le compartiment dans lequel Elastic Transcoder place les fichiers transcodés.

La valeur, le cas échéant, que vous souhaitez qu'Elastic Transcoder ajoute au nom de tous les fichiers créés par cette tâche, y compris les fichiers de sortie, les miniatures et les playlists. Si vous spécifiez une valeur, elle doit contenir un/quelque part après le premier caractère, ce qui simplifie la gestion des fichiers Amazon S3.

Nom des fichiers que vous voulez transcoder. Pour déterminer à partir de quel compartiment Amazon S3 extraire le fichier, Elastic Transcoder fait référence au champ Input Bucket du pipeline que vous avez spécifié pour cette tâche.

Si le nom d'un fichier inclut un préfixe, par exemple, cooking/lasagna.mpg incluez-le dans la clé. Si le fichier ne se trouve pas dans le compartiment spécifié, Elastic Transcoder renvoie une erreur.

Les paramètres de chiffrement, le cas échéant, utilisés pour déchiffrer vos fichiers d'entrée. Si votre fichier d'entrée est chiffré, vous devez spécifier le mode qu'Elastic Transcoder utilisera pour déchiffrer votre fichier.

Mode de chiffrement spécifique que vous souhaitez qu'Elastic Transcoder utilise pour déchiffrer vos fichiers.

Elastic Transcoder prend en charge les options suivantes :

La clé de chiffrement des données utilisée pour chiffrer votre fichier. La clé doit être codée en base64 et elle doit avoir l'une des longueurs de bits suivantes avant d'être codée en base64 :

96(AES-GCM uniquement)128, 192 ou. 256

La clé doit également être cryptée à l'aide de AWS KMS. Pour plus d'informations, consultez la section Chiffrement et déchiffrement des données dans le guide du développeur.AWS Key Management Service

Le condensé MD5 de la clé utilisée pour chiffrer votre fichier d'entrée et que vous souhaitez qu'Elastic Transcoder utilise comme somme de contrôle pour vous assurer que votre clé n'a pas été corrompue pendant le transport. La clé MD5 doit être codée en base64, et elle doit être exactement de 16 octets avant d'être codée en base64.

Série de bits aléatoires créée par un générateur de bits aléatoires, unique pour chaque opération de chiffrement, que vous avez utilisé pour chiffrer vos fichiers d'entrée. Le vecteur d'initialisation doit être codé en base64, et il doit être exactement de 16 octets avant d'être codé en base64.

Pour plus d'informations, reportez-vous à la section Vecteur d'initialisation.

Vous pouvez créer un fichier de sortie qui contient un extrait du fichier d'entrée. Clip Start Time indique l'emplacement du fichier d'entrée où vous souhaitez qu'un clip commence. Le format peut être soit HH:mm:ss.SSS (valeur maximale : 23:59:59.999 ; SSS étant le millième de secondes) ou sssss.SSS (valeur maximale : 86399.999). Si vous ne spécifiez aucune valeur, Elastic Transcoder démarre au début du fichier d'entrée.

Durée de l'extrait de clip. Le format peut être soit HH:mm:ss.SSS (valeur maximale : 23:59:59.999 ; SSS étant le millième de secondes) ou sssss.SSS (valeur maximale : 86399.999). Si vous ne spécifiez aucune valeur, Elastic Transcoder effectue des clips depuis l'heure de début du clip jusqu'à la fin du fichier.

Si vous spécifiez une valeur supérieure à la durée du fichier d'entrée, Elastic Transcoder transcode depuis l'heure de début du clip jusqu'à la fin du fichier et renvoie un message d'avertissement.

Politique qui détermine la manière dont Elastic Transcoder gère l'existence de plusieurs sous-titres.

Nom du fichier de légende du sidecar que vous souhaitez qu'Elastic Transcoder transcode et inclue dans les sorties.

Chaîne qui spécifie la langue du sous-titre dans l'un des formats suivants :

Pour plus d'informations sur les codes de langue ISO, consultez la liste des codes ISO 639-1.

Pour la génération de clips ou de sous-titres qui ne démarrent pas en même temps que le fichier vidéo associé, Elastic Transcoder TimeOffsetindique à Elastic Transcoder la partie de la vidéo à encoder avant d'inclure les sous-titres.

Spécifiez-le TimeOffset sous la forme [+-] SS.sss ou [+-] HH:MM:SS.ss.

Etiquette du sous-titre qui s'affiche dans le lecteur lorsque vous choisissez une langue. Nous vous conseillons d'indiquer le nom de la langue du sous-titre ici, dans la langue des sous-titres.

Préréglage à utiliser pour cette sortie. Le préréglage détermine les paramètres audio, vidéo et miniatures utilisés par Elastic Transcoder pour le transcodage.

Si vous précisez un préréglage pour la sortie actuelle pour lequel la valeur de Container est soit ts (MPEG-TS), soit fmp4 (Fragmented MP4), Segment Duration est la durée cible maximale de chaque segment en secondes. Pour les listes de lecture au format HLSv3, chaque segment multimédia est stocké dans un fichier .ts distinct. Pour les listes de lecture HLSv4, MPEG-DASH et Smooth, tous les segments multimédias d'une sortie sont stockés dans un seul fichier. Chaque segment correspond approximativement à la longueur de Segment Duration, mais certains segments peuvent être plus courts ou plus longs.

La plage de valeurs valides est comprise entre 1 et 60 secondes. Si la durée de la vidéo ne peut être divisée en segments égaux par Segment Duration, la durée du dernier segment correspond au reste de l'opération suivante :

total length/Segment Duration

Elastic Transcoder crée une liste de lecture spécifique à la sortie pour chaque sortie HLS que vous spécifiez dans Output Keys. Pour ajouter une sortie à une liste de lecture maître pour cette tâche, ajoutez-la dans Outputs in Master Playlist.

Elastic Transcoder applique cette segmentation à tous les sous-titres associés à la vidéo de sortie.

Le nom que vous souhaitez qu'Elastic Transcoder attribue au fichier transcodé et à la playlist. Elastic Transcoder enregistre le ou les fichiers dans le compartiment Amazon S3 spécifié par le champ Bucket dans le pipeline dans lequel vous spécifiez. Pipeline Si le compartiment contient déjà un fichier portant le nom spécifié, la sortie échoue. Cependant, d'autres sorties dans la même tâche peuvent réussir.

Le format des noms de fichiers dépend du type de conteneur et de si la durée du segment est définie. Si le type de conteneur n'est pas ts ou si la durée du segment n'est pas indiquée, le nom du fichier de sortie est une concaténation de Output Key Prefix et Output Key.de

Si le type de conteneur est défini ts et que la durée du segment est spécifiée, Elastic Transcoder utilise la valeur de Output Key pour nommer à la fois la playlist de sortie et les .ts fichiers :

Si une ts sortie segmentée n'est pas incluse dans une playlist principale, Elastic Transcoder traite la sortie comme HLSv3.

Le préfixe de clé de sortie regroupe tous les fichiers d'une tâche dans votre compartiment Amazon S3. Si vous souhaitez grouper les fichiers de chaque sortie au sein d'une tâche, vous pouvez inclure un préfixe dans la valeur de Output Key, par exemple :

OutputKeyPrefixiPhone/Key 00000.ts

OutputKeyPrefixKindleFireHD/Key 00000.ts

Nom du premier fichier de segment, basé sur la valeur que vous avez saisie pour le champ Output Key.

Si vous souhaitez qu'Elastic Transcoder crée des miniatures pour vos vidéos, sélectionnez Oui et spécifiez le format des noms de fichiers dans le champ Modèle de nom de fichier miniature.

Si vous avez sélectionné Yes pour Thumbnail Filename Pattern, spécifiez le format des noms de fichiers. Vous pouvez spécifier les valeurs suivantes dans n'importe quel ordre :

Le champ Thumbnail Filename Preview affiche un exemple de noms de fichiers pour les miniatures en fonction de la valeur que vous avez saisie dans le champ Thumbnail Filename Preview.

Lors de la création de miniatures, Elastic Transcoder enregistre automatiquement les fichiers au format (.jpg ou .png) qui apparaît dans le préréglage que vous avez spécifié. Preset Elastic Transcoder ajoute également l'extension de nom de fichier applicable.

Nombre de degrés dans le sens des aiguilles d'une montre selon lesquels vous souhaitez qu'Elastic Transcoder fasse pivoter la sortie par rapport à l'entrée. Si vous souhaitez qu'Elastic Transcoder détecte automatiquement si le fichier d'entrée fait l'objet d'une rotation, sélectionnez auto. Notez toutefois qu'Elastic Transcoder ne peut généralement détecter si la sortie doit être pivotée que si le fichier que vous transcodez contient des métadonnées de rotation.

Le format que vous spécifiez détermine si Elastic Transcoder génère un sous-titre intégré ou un sidecar pour cette sortie. Si vous laissez cette valeur vide, Elastic Transcoder renvoie une erreur.

Préfixe des noms de fichier de sous-titres, sous la forme description-{language}, où :

Si vous ne l'incluez pas {language} dans le modèle de nom de fichier, Elastic Transcoder ajoute automatiquement « {language} » à la valeur que vous spécifiez pour la description. En outre, Elastic Transcoder ajoute automatiquement le nombre à la fin des fichiers de segments.

Par exemple, supposons que vous transcodiez au format srt. Lorsque vous saisissez « Sydney-{language}-sunrise » et que la langue des sous-titre est l'anglais (en), le nom du premier fichier de sous-titre est Sydney-en-sunrise00000.srt.

Nom du premier fichier de sous-titre, basé sur la valeur que vous avez saisie pour le champ Captions Filename Pattern. L'aperçu utilise le code ISO anglais « en » pour montrer l'aspect qu'aura la valeur {language} dans votre nom de fichier.

Les paramètres de chiffrement, le cas échéant, que vous souhaitez qu'Elastic Transcoder applique à vos fichiers de sortie. Si vous choisissez d'utiliser le chiffrement, vous devez spécifier un mode à utiliser. Si vous choisissez de ne pas utiliser le chiffrement, Elastic Transcoder écrira un fichier non chiffré dans votre compartiment Amazon S3.

Mode de chiffrement spécifique que vous souhaitez qu'Elastic Transcoder utilise pour chiffrer vos fichiers de sortie individuellement. Elastic Transcoder prend en charge les options de mode de chiffrement suivantes :

Si vous avez choisi l'un des modes de chiffrement AES, vous devez également spécifier les trois valeurs suivantes (toutes les trois doivent être codées en base64) :

Si vous avez choisi l'un des modes de chiffrement AES et que vous souhaitez qu'Elastic Transcoder génère pour vous 128 une clé de chiffrement AES binaire, ne spécifiez aucune valeur pour la clé de chiffrement, la clé de chiffrement MD5 ou le vecteur d'initialisation du chiffrement. Une fois qu'Elastic Transcoder a généré la clé, vous pouvez la récupérer en appelant. ReadJob La clé n'est pas incluse dans l'CreateJobResponseobjet.

Si vous souhaitez qu'Elastic Transcoder génère une clé pour vous, laissez ce champ vide. Une fois qu'Elastic Transcoder a généré la clé, vous pouvez la récupérer en appelant Read Job. La clé n'est pas incluse dans l'objet Create Job Response.

Si vous choisissez de fournir votre propre clé, vous devez la chiffrer à l'aide d'AWS KMS. La clé doit être codée en base64, et elle doit avoir l'une des longueurs de bits suivantes avant d'être codée en base64 :

96(AES-GCM uniquement)128, 192 ou. 256

Si vous avez configuré Elastic Transcoder pour générer une clé pour vous, Elastic Transcoder laisse ce champ vide dans la réponse Create Job. Pour récupérer la clé de chiffrement des données que vous avez générée, soumettez une demande Read Job.

Pour plus d'informations sur le chiffrement de votre clé avec AWS KMS, consultez la section Chiffrement et déchiffrement des données dans le guide du développeur.AWS Key Management Service

Le résumé MD5 de la clé que vous souhaitez qu'Elastic Transcoder utilise pour chiffrer votre fichier de sortie, et que vous souhaitez qu'Elastic Transcoder utilise comme somme de contrôle pour vous assurer que votre clé n'a pas été corrompue pendant le transport. La clé MD5 doit être codée en base64, et elle doit être exactement de 16 octets avant d'être codée en base64.

Si Elastic Transcoder génère votre clé pour vous, vous devez laisser ce champ vide.

Série de bits aléatoires créée par un générateur de bits aléatoires, unique pour chaque opération de chiffrement, que vous souhaitez qu'Elastic Transcoder utilise pour chiffrer vos fichiers de sortie. Le vecteur d'initialisation doit être codé en base64, et il doit être exactement de 16 octets avant d'être codé en base64.

Si Elastic Transcoder génère votre clé pour vous, vous devez laisser ce champ vide.

Pour plus d'informations, reportez-vous à la section Vecteur d'initialisation.

ID des paramètres de filigrane utilisés par Elastic Transcoder pour ajouter des filigranes à la vidéo pendant le transcodage. Les paramètres sont contenus dans le préréglage spécifié par Preset pour la sortie actuelle. Dans ce préréglage, la valeur de Watermarks Id indique à Elastic Transcoder les paramètres à utiliser.

Nom du fichier .png ou .jpg que vous souhaitez utiliser pour le filigrane. Pour déterminer quel compartiment Amazon S3 contient le fichier spécifié, Elastic Transcoder vérifie le pipeline spécifié par Pipeline ; l'objet Input Bucket de ce pipeline identifie le bucket.

Si le nom du fichier comprend un préfixe, par exemple, logos/128x64.png, vous devez inclure le préfixe dans la clé. Si le fichier ne se trouve pas dans le compartiment spécifié, Elastic Transcoder renvoie une erreur.

Politique qui détermine la manière dont Elastic Transcoder gérera l'existence de plusieurs fichiers de pochette d'album.

Fichier à utiliser en tant que pochette d'album. Jusqu'à 20 conceptions graphiques peuvent être associées à un fichier audio.

Nom du fichier à utiliser en tant que pochette d'album. Pour déterminer quel compartiment Amazon S3 contient le fichier spécifié, Elastic Transcoder vérifie le pipeline spécifié par PipelineId; l'InputBucketobjet de ce pipeline identifie le compartiment.

Si le nom du fichier comprend un préfixe, par exemple, cooking/pie.jpg, vous devez inclure le préfixe dans la clé. Si le fichier ne se trouve pas dans le compartiment spécifié, Elastic Transcoder renvoie une erreur.

Format des pochettes d'album, le cas échéant. Les formats valides sont jpg et png.

Largeur maximum de la pochette de l'album en sortie, en pixels. Si vous le spécifiezauto, Elastic Transcoder utilise 600 comme valeur par défaut. Si vous spécifiez une valeur numérique, saisissez un nombre entier pair compris entre 32 et 4096 inclus.

Hauteur maximum de la pochette de l'album en sortie, en pixels. Si vous le spécifiezauto, Elastic Transcoder utilise 600 comme valeur par défaut. Si vous spécifiez une valeur numérique, saisissez un nombre entier pair compris entre 32 et 3072 inclus.

Valeur qui contrôle le dimensionnement de la pochette d'album en sortie :

Le tableau suivant montre les effets possibles des SizingPolicyparamètres sur la pochette de l'album en sortie :

Lorsque vous définissez cette PaddingPolicyoptionPad, Elastic Transcoder peut ajouter des barres blanches en haut et en bas et/ou sur les côtés gauche et droit de la pochette d'album en sortie afin que la taille totale de la pochette de sortie corresponde aux valeurs que vous avez spécifiées pour MaxWidthet. MaxHeight Pour de plus amples informations, veuillez consulter le tableau à AlbumArt:Art:SizingPolicy.

La clé de la key/value paire de métadonnées que vous souhaitez renvoyer avec le fichier de sortie. Chaque clé doit être une chaîne unique entre des 1-128 caractères et ne doit utiliser que les caractères de la liste suivante :

Vous pouvez utiliser les clés comme système de numérotation pour organiser vos métadonnées, pour stocker 128 caractères supplémentaires de métadonnées ou pour étiqueter les métadonnées stockées dans la valeur. Si vous souhaitez utiliser uniquement des métadonnées de valeur, vous pouvez insérer des chaînes jetables dans vos clés, par exemplekey1, et ignorer les clés lorsque vous récupérez vos métadonnées depuis Elastic Transcoder.

La valeur de la key/value paire de métadonnées que vous souhaitez renvoyer avec votre tâche. Chaque valeur doit être une chaîne entre des 0-256 caractères et ne doit utiliser que les caractères de la liste suivante :

Le nom que vous souhaitez qu'Elastic Transcoder attribue à une playlist principale. Si le nom comprend un caractère /, la partie du nom avant la dernière / doit être identique pour toutes les Playlist Names. Si vous créez plusieurs listes de lecture principales, chacune doit avoir un nom unique.

Tous les paramètres de durée de segments, les paramètres de découpe ou les paramètres de sous-titres doivent être identiques pour toutes les sorties de la liste de lecture. Pour les listes de lecture Smooth, les ratios Audio:Profile, Video:Profile et Frame Rate to Maximum Number of Frames Between Keyframes doivent être identiques pour toutes les sorties.

Format de la liste de lecture. Les formats valides sont HLSv3, HLSv4, MPEG-DASH et Smooth.

Pour chaque sortie de cette tâche que vous voulez inclure dans une liste de lecture principale, valeur du champ Output Key. Si vous incluez plusieurs sorties dans une liste de lecture, la valeur de Segment Duration pour toutes les sorties doit être identique.

Pour les playlists principales HLSv4, Elastic Transcoder choisit les combinaisons d'entrées audio et vidéo qui seront liées dans les playlists de sortie. Les premières entrées audio et vidéo seront liées et affichées en tant qu'expérience de lecture par défaut, ce qui vous permet de choisir votre valeur de lecture par défaut préférée. Pour les autres playlists individuelles de la playlist principale, Elastic Transcoder choisit les combinaisons de débits audio et vidéo qui offriront la meilleure lecture.

La méthode de protection du contenu pour votre sortie. La seule valeur valide est :

aes-128.

Cette valeur sera écrite dans l'methodattribut de la balise de EXT-X-KEY métadonnées de la liste de lecture de sortie.

Si vous souhaitez qu'Elastic Transcoder génère une clé pour vous, laissez ce champ vide. Une fois qu'Elastic Transcoder a généré la clé, vous pouvez la récupérer en appelant. ReadJob La clé n'est pas incluse dans l'CreateJobResponseobjet.

Si vous choisissez de fournir votre propre clé, vous devez la chiffrer à l'aide d'AWS KMS. La clé doit être codée en base64, et elle doit avoir l'une des longueurs de bits suivantes avant d'être codée en base64 :

96(AES-GCM uniquement)128, 192 ou. 256

Si vous avez configuré Elastic Transcoder pour générer une clé pour vous, Elastic Transcoder laisse ce champ vide dans la réponse. CreateJob Pour récupérer la clé de chiffrement des données que vous avez générée, soumettez une ReadJob demande.

Pour plus d'informations sur le chiffrement de votre clé avec AWS KMS, consultez la section Chiffrement et déchiffrement des données dans le guide du développeur.AWS Key Management Service

Si vous choisissez une méthode de protection du contenu HLS deaes-128, la clé doit être constituée de 128 bits. Si vous en avez un relative KeyStoragePolicy, Elastic Transcoder écrit votre clé dans un compartiment Amazon S3 avec un chiffrement côté serveur Amazon S3.

Le résumé MD5 de la clé que vous souhaitez qu'Elastic Transcoder utilise pour chiffrer votre fichier de sortie, et que vous souhaitez qu'Elastic Transcoder utilise comme somme de contrôle pour vous assurer que votre clé n'a pas été corrompue pendant le transport. La clé MD5 doit être codée en base64, et elle doit être exactement de 16 octets avant d'être codée en base64.

Si Elastic Transcoder génère votre clé pour vous, vous devez laisser ce champ vide.

Série de bits aléatoires créée par un générateur de bits aléatoires, unique pour chaque opération de chiffrement, que vous souhaitez qu'Elastic Transcoder utilise pour chiffrer vos fichiers de sortie. Le vecteur d'initialisation doit être codé en base64, et il doit être exactement de 16 octets avant d'être codé en base64.

Si Elastic Transcoder génère votre clé pour vous, vous devez laisser ce champ vide.

Pour plus d'informations, reportez-vous à la section Vecteur d'initialisation.

Emplacement de la clé de licence requise pour déchiffrer votre playlist HLS. L'URL doit être un chemin absolu et est référencée dans l'attribut URI de la balise de métadonnées EXT-X-KEY du fichier de playlist. Par exemple :

https://www.example.com/exampleKey/

Spécifiez si vous souhaitez qu'Elastic Transcoder écrive votre clé de licence HLS dans un compartiment Amazon S3. Si vous le souhaitezWithVariantPlaylists, Elastic Transcoder écrira votre clé chiffrée dans le même compartiment Amazon S3 que la playlist associée.

Les paramètres DRM utilisés pour limiter les personnes autorisées à consulter vos fichiers. Cela se fait en incluant un en-tête PlayReady DRM dans votre liste de lecture de sortie. Cela n'est pas utilisable pour les illustrations, les légendes, les miniatures ou les filigranes. PlayReady Les DRM chiffrent vos fichiers multimédias à l'aide aes-ctr du chiffrement.

Si vous utilisez les DRM pour une liste de lecture HLSv3, vos sorties doivent avoir une liste de lecture principale.

Pour plus d’informations, consultez Gestion des droits numériques.

Le format DRM de votre liste de lecture de sortie. Les formats valides sont discretix-3.0 et microsoft.

Pour les playlists de type Smooth, spécifiezmicrosoft. Pour les playlists de type HLSv3, spécifiez. discretix-3.0

La clé DRM de votre fichier, fournie par votre fournisseur de licence DRM. La clé doit être codée en base64, et elle doit avoir l'une des longueurs de bits suivantes avant d'être codée en base64 :

128, 192, ou 256.

La clé doit également être cryptée à l'aide de AWS KMS. Pour plus d'informations, consultez la section Chiffrement et déchiffrement des données dans le guide du développeur.AWS Key Management Service

L'ID de votre clé DRM, afin que votre fournisseur de licence DRM sache quelle clé fournir.

L'identifiant de la clé doit être fourni en big endian, et Elastic Transcoder le convertira en little endian avant de l'insérer dans les en-têtes DRM. PlayReady Si vous ne savez pas si votre serveur de licences fournit votre identifiant de clé en big ou en little endian, contactez votre fournisseur de DRM.

Le résumé MD5 de la clé utilisée pour le DRM sur votre fichier, et que vous souhaitez qu'Elastic Transcoder utilise comme somme de contrôle pour vous assurer que votre clé n'a pas été corrompue pendant le transport. La clé MD5 doit être codée en base64, et elle doit être exactement de 16 octets avant d'être codée en base64.

Série de bits aléatoires créée par un générateur de bits aléatoires, unique pour chaque opération de chiffrement, que vous souhaitez qu'Elastic Transcoder utilise pour chiffrer vos fichiers. Le vecteur d'initialisation doit être codé en base64, et sa longueur doit être exactement de 8 octets avant d'être codé en base64. Si aucun vecteur d'initialisation n'est fourni, Elastic Transcoder en génère un pour vous.

Pour plus d'informations, reportez-vous à la section Vecteur d'initialisation.

Emplacement de la clé de licence requise pour lire le contenu DRM. L'URL doit être un chemin absolu et est référencée par l' PlayReady en-tête. L' PlayReady en-tête est référencé dans l'en-tête de protection du manifeste client pour les sorties Smooth Streaming, et dans les balises de métadonnées EXT-X-DXDRM et EXT-XDXDRMINFO pour les sorties de playlist HLS. Un exemple d'URL se présente sous la forme suivante :

https://www.example.com/exampleKey/