Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# 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. Notez que les variables distinguent les majuscules et minuscules.
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/\$1d\$1/**. 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](#list-of-settings-variables-with-examples).
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](#using-settings-variables-with-streaming-outputs).
**Topics**
+ [Liste des variables de paramètres avec exemples](#list-of-settings-variables-with-examples)
+ [Utilisation de variables de paramètres avec des sorties de streaming](#using-settings-variables-with-streaming-outputs)
+ [Spécification d'un nombre minimum de chiffres](#specifying-a-minimum-number-of-digits)
## Liste des variables de paramètres avec exemples
Le tableau suivant fournit des informations sur chacun des identificateurs de format que vous pouvez utiliser dans le cadre de votre AWS Elemental MediaConvert tâche. 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](#using-settings-variables-with-streaming-outputs).
| 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 | Date et heure UTC de l'heure de début de la tâche. Format : AAAAMMJJTHHMMSS Exemple : Pour une tâche qui commence à 3:05:28 PM le 4 juin 2020, **\$1dt\$1** se résout en `20200604T150528`. |
| Date | `$d$` | Destination Modificateur de nom Modificateur de segment | Date UTC de l'heure de début de la tâche. Format : AAAAMMJJ. Exemple : pour une tâche qui démarre le 4 juin 2020, **\$1d\$1** se résout en `20200604`. |
| Heure | `$t$` | Destination Modificateur de nom Modificateur de segment | Heure de début UTC de la tâche. Format : HHMMSS Exemple : Pour une tâche qui commence à 3:05:28 PM, **\$1t\$1** 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 sorties QVBR, le service utilise le débit maximal vidéo, en kilobits. Exemple : si vous définissez **Encoding settings (Paramètres d'encodage)**, **Video (Vidéo)**, **Débit (bits/s)** sur **50000000**, **\$1rv\$1** 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**, **\$1ra\$1** 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), **\$1rc\$1** 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** , **\$1w\$1** 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** , **\$1h\$1** 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**\$1f\$1** 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**, **\$1fn\$1** 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**, ****\$1ex\$1**Container** est résolu en`m2ts`. Exemple de groupe HLS : Si votre groupe de sortie est HLS, **\$1ex\$1** se résout en `m3u8`. |
| \$1 | `$$` | 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\$1\$1hi-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 tâche, également appelés *identifiants de format*, fonctionnent différemment pour les sorties dans les groupes de sortie Apple HLS et DASH ISO. Les différences sont les suivantes :
**Pour les sorties Apple HLS**
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 sorties DASH ISO**
Vous pouvez utiliser deux identifiants de format supplémentaires dans le paramètre **Name modifier (Modificateur de nom)**. Ceux-ci affectent le manifeste DASH en plus du nom de fichier de sortie. Voici les identifiants :
\$1Number\$1
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\$1\$1Number\$1** 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\$1** 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 manifeste DASH, AWS Elemental MediaConvert inclut `duration` et `startNumber` contient l'`SegmentTemplate`élément, comme ceci : ``
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.
\$1Bandwidth\$1
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\$1\$1Bandwidth\$1**
La valeur de \$1Bandwidth\$1 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 :``.
\$1Time\$1
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\$1\$1\$1Time\$1** 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 :
```