Utilisation de variables dans les paramètres de votre tâche

Vous pouvez utiliser des variables, également appelées identifiants de format, dans vos paramètres de tâche. Les identifiants de format identifiants sont des valeurs que vous pouvez placer dans vos paramètres de tâche qui résolvent différemment dans vos sorties, en fonction des caractéristiques des fichiers d'entrée ou de la tâche. Ils sont particulièrement utiles dans les paramètres de sortie prédéfinis, les modèles de travail et les tâches que vous avez l'intention de dupliquer et de réutiliser.

Par exemple, vous pouvez utiliser l'identifiant de format de date $d$ pour votre paramètre Destination. Si vous voulez que vos sorties soient organisées selon la date et l'heure auxquelles la tâche commence, dans Destination, vous pouvez saisir s3://amzn-s3-demo-bucket1/$d$/. Pour une tâche qui démarre le 4 juin 2020, le service crée vos sorties dans s3://amzn-s3-demo-bucket1/20200604/.

Pour obtenir la liste des identifiants de format disponibles et des exemples de leur utilisation, reportez-vous à la section Liste des variables de paramètres avec exemples.

Pour plus d'informations sur les identifiants de format qui fonctionnent différemment dans les sorties de streaming, consultez Utilisation de variables de paramètres avec des sorties de streaming.

Liste des variables de paramètres avec exemples

Le tableau suivant fournit des informations sur chacun des identifiants de format que vous pouvez utiliser dans votre tâche AWS Elemental MediaConvert . Pour plus d'informations sur les identifiants de format qui fonctionnent différemment dans les sorties de streaming, consultez Utilisation de variables de paramètres avec des sorties de streaming.

Identifiant de format	Valeur à attribuer au cadre de travail	Paramètres de travail compatibles	Description et exemple
Date et heure	$dt$	Destination Modificateur de nom Modificateur de segment	UTCdate et heure de début de la tâche. Format : YYYYMMDDTHHMMSS Exemple : Pour une tâche qui commence à 3:05:28 PM le 4 juin 2020, $dt$ se résout en 20200604T150528.
Date	$d$	Destination Modificateur de nom Modificateur de segment	UTCdate de début de la tâche. Format : YYYYMMDD Exemple : pour une tâche qui démarre le 4 juin 2020, $d$ se résout en 20200604.
Heure	$t$	Destination Modificateur de nom Modificateur de segment	UTCheure de début de la tâche. Format : HHMMSS Exemple : Pour une tâche qui commence à 3:05:28 PM, $t$ se résout en 150528.
Débit Video	$rv$	Modificateur de nom Modificateur de segment	Débit vidéo de la sortie, en kilobits. Pour les QVBR sorties, le service utilise le débit maximal de la vidéo, en kilobits. Exemple : si vous définissez Encoding settings (Paramètres d'encodage), Video (Vidéo), Débit (bits/s) sur 50000000, $rv$ se résout en 50000.
Débit audio	$ra$	Modificateur de nom Modificateur de segment	Total de tous les débits binaires audio de la sortie, en kilobits. Exemple : si vous avez une sortie audio avec un seul onglet audio et que vous définissez Encoding settings (Paramètres d'encodage), Audio 1, Bit rate (Débit) (kbit/s) sur 256000, $ra$ est résolu en 256000.
Débit de conteneur	$rc$	Modificateur de nom Modificateur de segment	Débit audio et débit vidéo combinés pour la sortie, en kilobits. Exemple : vous avez une sortie avec un onglet de paramètres Vidéo et un onglet de paramètres Audio 1. Si vous définissez Encoding settings, Video, Débit (bits/s) sur 5000000 et que vous définissez Encodage settings, Audio, Débit (bits/s) sur 96000 (96 kilobits), $rc$ se résout en 5096.
Largeur de trame vidéo	$w$	Modificateur de nom Modificateur de segment	Largeur d'image, ou résolution horizontale, en pixels. Exemple : si vous définissez Encoding settings, Video, Resolution (w x h) sur 1280 x 720 , $w$ se résout en 1280.
Hauteur de trame vidéo	$h$	Modificateur de nom Modificateur de segment	Hauteur de trame, ou résolution verticale, en pixels. Exemple : si vous définissez Encoding settings, Video, Resolution (w x h) sur 1280 x 720 , $h$ se résout en 720.
Framerate	$f$	Modificateur de nom Modificateur de segment	Fréquence, en images par seconde, tronquée au nombre entier le plus proche. Exemple : Si votre fréquence d'image est 59.940, se$f$ se résout en 59.
Nom du fichier d'entrée	$fn$	Destination Modificateur de nom Modificateur de segment	Nom du fichier d'entrée, sans l'extension de fichier. Pour les tâches qui ont plusieurs entrées, il s'agit du premier fichier spécifié dans la tâche. Exemple : Si Input 1 pour votre tâche est s3://amzn-s3-demo-bucket/my-video.mov, $fn$ se résout en my-video.
Extension de fichier du conteneur de sortie	$ex$	Modificateur de nom Modificateur de segment	Varie en fonction du groupe de sortie. Pour les sorties File group (Groupe de fichiers), il s'agit de l'extension du fichier de sortie du conteneur. Pour les autres groupes de sortie, il s'agit de l'extension du manifeste. Exemple de groupe de fichiers : si vous choisissez MPEG2-TS pour les paramètres de sortie, Container $ex$ m2ts devient. Exemple de HLS groupe : si votre groupe de sortie estHLS, est $ex$ résolu àm3u8.
$	$$	Modificateur de nom Modificateur de segment	$ placé dans une séquence d'échappement. Exemple : Supposons que vous fournissiez les valeurs suivantes : Nom du fichier d'entrée : file1.mp4 Destination : s3://amzn-s3-demo-bucket/ Nom du modificateur : my-video$$hi-res- Votre chemin d'accès et nom du fichier de sortie se résout en s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4.

Utilisation de variables de paramètres avec des sorties de streaming

Les variables de vos paramètres de travail, également appelées identificateurs de format, fonctionnent différemment pour les sorties Apple HLS et les groupes DASH ISO de sorties. Les différences sont les suivantes :

Pour les HLS sorties Apple

Lorsque vous utilisez les identifiants de format de date et d'heure ($dt$, $t$, $d$) dans le paramètre Segment modifier (Modificateur de segment), ces identifiants de format se résolvent en l'heure de fin de chaque segment, plutôt qu'en l'heure de début de la tâche.

Note

Pour les tâches qui utilisent le transcodage accéléré, les segments peuvent s'achever en même temps. Cela signifie que les identificateurs de format de date et d'heure ne se résolvent pas toujours en valeurs uniques.

Pour les DASH ISO sorties

Vous pouvez utiliser deux identifiants de format supplémentaires dans le paramètre Name modifier (Modificateur de nom). Ils affectent le DASH manifeste en plus du nom du fichier de sortie. Voici les identifiants :

$Number$

Dans les noms de vos fichiers de sortie, $Number$ se résout en une série de nombres qui s'incrémentent à partir de 1. Cela remplace la valeur par défaut, numérotation du segment en neuf chiffres dans les noms de fichier des segments. Par exemple :

• Si vous spécifiez video_$Number$ pour Name modifier (Modificateur de nom), le service crée les fichiers nommés video_1.mp4, video_2.mp4, et ainsi de suite.

• Si vous spécifiez uniquement video_ pour Name modifier (Modificateur de nom), le service crée les fichiers nommés video_000000001.mp4, video_000000002.mp4, et ainsi de suite.

Dans votre DASH manifeste, AWS Elemental MediaConvert inclut duration et intègre startNumber l'SegmentTemplateélément, comme ceci : <SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>

Note

Si vous utilisez l'identificateur de format $Number$ dans une sortie, vous devez également l'utiliser dans toutes les autres sorties du groupe de sorties.

$Bandwidth$

Dans les noms de vos fichiers de sortie, $Bandwidth$ est résolu par la valeur de Video (Vidéo), Bitrate (Débit), plus la valeur de Audio, Bitrate (Débit) dans la sortie. Que vous incluiez ou pas cet identifiant de format, le service utilise la numérotation de segment à neuf chiffres dans les noms de fichier des segments.

Par exemple, supposons que vous spécifiez les valeurs suivantes :

• Vidéo, Débit (bits/s) : 50000000

• Audio, Débit (kbits/s) : 96.0 (96 000 bits/s)

• Name modifier (Modificateur du nom) : video_$Bandwidth$

La valeur de $Bandwidth$ est résolue à 50 096 000. Le service crée les fichiers de segment nommés video_50096000_000000001.mp4, video_50096000_000000002.mp4, et ainsi de suite.

Dans le manifeste, AWS Elemental MediaConvert inclut duration et startNumber à l'intérieur de l'SegmentTemplateélément, comme ceci :<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>.

$Time$

Dans vos noms de fichier de sortie, $Time$ se résout en la durée, en millisecondes, du segment. Lorsque vous incluez cet identifiant de format, le service n'utilise pas la numérotation de segment à neuf chiffres par défaut dans les noms de fichier de segment.

Par exemple, si vous spécifiez video180__$Time$ pour Name modifier (Modificateur de nom), le service crée les fichiers de segment nommés video180__345600.mp4, video180__331680.mp4, et ainsi de suite. Dans ces exemples, les durées des segments sont 345 600 ms et 331 680 ms.

Dans le manifeste, AWS Elemental MediaConvert inclut SegmentTimeline l'intérieur de l'SegmentTemplateélément, comme ceci :

<Representation id="5" width="320" height="180" bandwidth="200000" codecs="avc1.4d400c">
        <SegmentTemplate media="video180_$Time$.mp4" initialization="videovideo180_init.mp4">
          <SegmentTimeline>
            <S t="0" d="345600" r="2"/>
            <S t="1036800" d="316800"/>
          </SegmentTimeline>
        </SegmentTemplate>
      </Representation>

Note

Si vous utilisez l'identificateur de format $Time$ dans une sortie, vous devez également l'utiliser dans toutes les autres sorties du groupe de sorties.

Spécification d'un nombre minimum de chiffres

Pour les identifiants de format qui renvoient un nombre, vous pouvez spécifier un nombre minimal de chiffres dans lequel l'identifiant de format se résoudra. Lorsque vous le faites, le service ajoute des zéros avant toute valeur qui renverrait moins de chiffres.

Utilisez la syntaxe suivante pour spécifier le nombre de chiffres : %0[number of digits]. Placez cette valeur juste avant le $ final de l'identifiant de format.

Par exemple, supposons que votre hauteur de trame vidéo soit 720 et que vous vouliez spécifier un minimum de quatre chiffres, de telle sorte qu'elle s'affiche dans votre nom de fichier sous la forme 0720. Pour ce faire, utilisez l'identifiant de format suivant : $h%04$.

Note

Les valeurs qui sont trop volumineux pour être exprimées dans le nombre de chiffres que vous spécifiez se résolvent avec un plus grand nombre de chiffres.