

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Verwenden von Variablen in Ihren Jobeinstellungen
<a name="using-variables-in-your-job-settings"></a>

Variablen, die Sie in den Aufgabeneinstellungen verwenden können, werden auch *Formatkennungen* genannt. Formatkennungen sind Werte, die Sie in den Aufgabeneinstellungen angeben können. Je nach Eigenschaften der Eingabedateien oder der Aufgabe werden sie unterschiedlich aufgelöst. Sie sind besonders nützlich in Ausgabevoreinstellungen, Aufgabenvorlagen und Aufgaben, die Sie duplizieren und wiederverwenden möchten. Beachten Sie, dass bei Variablen zwischen Groß- und Kleinschreibung unterschieden wird.

Sie können beispielsweise die Datumsformatkennung `$d$` für die Einstellung **Destination (Ziel)** verwenden. Wenn die Ausgaben nach Datum und Uhrzeit des Aufgabenbeginns sortiert werden sollen, geben Sie für **Destination (Ziel)** den Wert **s3://amzn-s3-demo-bucket1/$d$/** ein. Beginnt eine Aufgabe am 4. Juni 2020, erstellt der Service die Ausgaben in `s3://amzn-s3-demo-bucket1/20200604/`.

Eine Liste der verfügbaren Formatkennungen und Beispiele für deren Verwendung finden Sie unter [Liste der Einstellungsvariablen mit Beispielen](#list-of-settings-variables-with-examples).

Weitere Informationen zu den Formatkennungen, die in Streaming-Ausgaben eine andere Funktion haben, finden Sie unter [Verwendung von Einstellungsvariablen bei Streaming-Ausgaben](#using-settings-variables-with-streaming-outputs).

**Topics**
+ [Liste der Einstellungsvariablen mit Beispielen](#list-of-settings-variables-with-examples)
+ [Verwendung von Einstellungsvariablen bei Streaming-Ausgaben](#using-settings-variables-with-streaming-outputs)
+ [Angabe einer Mindestanzahl von Ziffern](#specifying-a-minimum-number-of-digits)

## Liste der Einstellungsvariablen mit Beispielen
<a name="list-of-settings-variables-with-examples"></a>

Die folgende Tabelle enthält Informationen zu den einzelnen Formatbezeichnern, die Sie in Ihrem AWS Elemental MediaConvert Job verwenden können. Weitere Informationen zu den Formatkennungen, die in Streaming-Ausgaben eine andere Funktion haben, finden Sie unter [Verwendung von Einstellungsvariablen bei Streaming-Ausgaben](#using-settings-variables-with-streaming-outputs).


| Format-ID | Wert, der in die Jobeinstellung eingegeben werden soll | Kompatible Jobeinstellungen | Beschreibung und Beispiel | 
| --- |--- |--- |--- |
| Datum und Uhrzeit | `$dt$` | Ziel<br />Namensmodifikator<br />Segmentmodifikator | Datum und Uhrzeit (UTC) des Aufgabenstarts<br />Format: JJJJMMTTTHHMMSS<br />Beispiel: Bei einer Aufgabe, die am 4. Juni 2020 um 15:05:28 Uhr beginnt, wird **$dt$** in `20200604T150528` aufgelöst.  | 
| Date | `$d$` | Ziel<br />Namensmodifikator<br />Segmentmodifikator | Datum (UTC) des Aufgabenstarts <br />Format: JJJJMMTT<br />Beispiel: Bei einer Aufgabe, die am 4. Juni 2020 beginnt, wird **$d$** in `20200604` aufgelöst.  | 
| Zeit | `$t$` | Ziel<br />Namensmodifikator<br />Segmentmodifikator | Aufgabenstart (UTC) <br />Format: HHMMSS<br />Beispiel: Bei einer Aufgabe, die um 15:05:28 Uhr beginnt, wird **$t$** in `150528` aufgelöst.  | 
| Video-Bitrate | `$rv$` | Namensmodifikator<br />Segmentmodifikator | Video-Bitrate der Ausgabe, in Kilobits Bei QVBR-Ausgaben verwendet der Service die maximale Video-Bitrate in Kilobits.<br />Beispiel: Wenn Sie **Encoding settings (Codierungseinstellungen)**, **Video**, **Bitrate (bits/s)** auf **50000000** festlegen, wird **$rv$** in `50000` aufgelöst. | 
| Audio-Bitrate | `$ra$` | Namensmodifikator<br />Segmentmodifikator | Gesamtwert der Audio-Bitraten der Ausgabe, in Kilobits<br />Beispiel: Wenn Sie eine Ausgabe mit einer einzigen Audio-Registerkarte haben und **Encoding settings (Codierungseinstellungen)**, **Audio 1**, **Bitrate (kbit/s)** auf **256000** festlegen, wird **$ra$** in `256000` aufgelöst. | 
| Container-Bitrate | `$rc$` | Namensmodifikator<br />Segmentmodifikator | Kombinierte Audio- und Video-Bitrate der Ausgabe, in Kilobits<br />Beispiel: Sie haben eine Ausgabe mit den Einstellungsregisterkarten **Video** und **Audio 1**. Wenn Sie **Encoding settings (Codierungseinstellungen)**, **Video**, **Bitrate (bits/s)** auf **5000000** und **Encoding settings (Codierungseinstellung)**, **Audio**, **Bitrate (bits/s)** auf **96000** (96 Kilobits) festlegen, wird **$rc$** in `5096` aufgelöst. | 
| Frame-Breite des Videos | `$w$` | Namensmodifikator<br />Segmentmodifikator | Frame-Breite bzw. horizontale Auflösung, in Pixeln<br />Beispiel: Wenn Sie **Encoding settings (Codierungseinstellungen)**, **Video**, **Resolution (w x h) (Auflösung, B x H)** auf **1280** x **720** festlegen, wird **$w$** in `1280` aufgelöst. | 
| Frame-Höhe des Videos | `$h$` | Namensmodifikator<br />Segmentmodifikator | Frame-Höhe bzw. vertikale Auflösung, in Pixeln<br />Beispiel: Wenn Sie **Encoding settings (Codierungseinstellungen)**, **Video**, **Resolution (w x h) (Auflösung, B x H)** auf **1280** x **720** festlegen, wird **$h$** in `720` aufgelöst. | 
| Framerate | `$f$` | Namensmodifikator<br />Segmentmodifikator | Framerate, in Frames pro Sekunde, verkürzt auf die nächste Ganzzahl <br />Beispiel: Wenn die Framerate **59.940** lautet, wird **$f$** in `59` aufgelöst.  | 
| Name der Eingabedatei | `$fn$` | Ziel<br />Namensmodifikator<br />Segmentmodifikator | Name der Eingabedatei, ohne Dateierweiterung Bei Aufgaben mit mehreren Eingabedateien ist dies die erste in der Aufgabe angegebene Datei.<br />Beispiel: Wenn **Input 1 (Eingabe 1)** in der Aufgabe **s3://amzn-s3-demo-bucket/my-video.mov** lautet, wird **$fn$** in `my-video` aufgelöst. | 
| Dateierweiterung des Ausgabe-Containers | `$ex$` | Namensmodifikator<br />Segmentmodifikator | Variiert je nach Ausgabegruppe Bei Ausgaben vom Typ **File group (Dateigruppe)** ist das die Erweiterung der Ausgabe-Container-Datei. Bei anderen Ausgabegruppen ist es die Erweiterung des Manifests.<br />Beispiel für eine Dateigruppe: Wenn Sie **MPEG2-TS** für die **Ausgabeeinstellungen** wählen, wird **Container** zu **$ex$** aufgelöst. `m2ts`<br />Beispiel für HLS-Gruppe: Wenn Ihre Ausgabegruppe eine HLS-Gruppe ist, wird **$ex$** in `m3u8` aufgelöst. | 
| $ | `$$` | Namensmodifikator<br />Segmentmodifikator | Durch Escape-Zeichen geschütztes `$`.<br />Beispiel: <br />Angenommen, Sie geben folgende Werte ein:   Name der Eingabedatei: **file1.mp4**   Ziel: **s3://amzn-s3-demo-bucket/**   Namensmodifikator: **my-video$$hi-res-**  <br />Name und Pfad der Ausgabedatei werden in `s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4` aufgelöst. | 

## Verwendung von Einstellungsvariablen bei Streaming-Ausgaben
<a name="using-settings-variables-with-streaming-outputs"></a>

Die Variablen in den Aufgabeneinstellungen, die auch *Formatkennungen* genannt werden, funktionieren bei Ausgaben in Apple HLS- und DASH ISO-Ausgabegruppen anders. Hier die Unterschiede:

**Bei Apple HLS-Ausgaben**  
Wenn Sie die Formatbezeichner für Datum und Uhrzeit (`$dt$`,`$t$`,`$d$`) in der Einstellung **„Segmentmodifikator“** verwenden, beziehen sich diese Formatbezeichner auf die Abschlusszeit jedes Segments und nicht auf die Startzeit des Jobs.

**Anmerkung**  
Bei Aufgaben mit beschleunigter Transcodierung können Segmente zur selben Zeit abgeschlossen werden. Das bedeutet, dass die Formatkennungen für Datum und Uhrzeit nicht immer in eindeutige Werte aufgelöst werden.

**Bei DASH ISO-Ausgaben**  
Sie können in der Einstellung **Name modifier (Namensmodifikator)** zwei weitere Formatkennungen nutzen. Sie wirken sich nicht nur auf den Namen der Ausgabedatei, sondern auch auf das DASH-Manifest aus. Hier die Kennungen:

$Number$  
In den Namen der Ausgabedatei wird `$Number$` in eine Reihe von Zahlen aufgelöst, die jeweils um 1 erhöht werden. Dies ersetzt die standardmäßige neunstellige Segmentnummer in den Namen der Segmentdateien. Beispiel:   
+ Wenn Sie **video\_$Number$** für **Name modifier (Namensmodifikator)** angeben, erstellt der Service die Segmentdateien `video_1.mp4`, `video_2.mp4` usw.
+ Wenn Sie nur **video\_** für **Name modifier (Namensmodifikator)** angeben, erstellt der Service die Segmentdateien `video_000000001.mp4`, `video_000000002.mp4` usw.
Schließt in Ihrem DASH-Manifest `duration` und `startNumber` innerhalb des `SegmentTemplate` Elements ein, etwa wie folgt: AWS Elemental MediaConvert `<SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>`  
Wenn Sie die Formatkennung `$Number$` in einer Ausgabe verwenden, müssen Sie sie auch in jeder anderen Ausgabe der Ausgabegruppe verwenden.

$Bandwidth$   
In den Namen der Ausgabedateien wird `$Bandwidth$` in der Wert von **Video**, **Bitrate** plus dem Wert von **Audio**, **Bitrate** der Ausgabe aufgelöst. Ob Sie dieses Formatkennung einbinden oder nicht, der Service verwendet immer neunstellige Segmentnummern in den Namen der Segmentdateien.  
Angenommen, Sie geben folgende Werte an:  
+ **Video**, **Bitrate (bits/s)**: **50000000** 
+  **Audio**, **Bitrate (kbits/s)**: **96.0** (96.000 bits/s)
+ **Name modifier (Namensmodifikator)**: **video\_$Bandwidth$**
Der Wert für $Bandwidth$ wird in 50.096.000 aufgelöst. Der Service erstellt die Segmentdateien `video_50096000_000000001.mp4`, `video_50096000_000000002.mp4` usw.  
Schließt im Manifest AWS Elemental MediaConvert ein `duration` und `startNumber` innerhalb des `SegmentTemplate` Elements, etwa so:`<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>`.

$Time$  
In den Namen der Ausgabedateien wird `$Time$` in die Dauer des Segments in Millisekunden aufgelöst. Wenn Sie diese Formatkennung verwenden, fügt der Service nicht die standardmäßige neunstellige Segmentnummer in die Namen der Segmentdateien ein.  
Wenn Sie beispielsweise **video180\_\_$Time$** für **Name modifier (Namensmodifikator)** eingeben, erstellt der Service die Segmentdateien `video180__345600.mp4`, `video180__331680.mp4` usw. In diesen Beispielen liegt die Segmentdauer bei 345.600 ms und 331.680 ms.  
Schließt im Manifest `SegmentTimeline` innerhalb des `SegmentTemplate` Elements wie folgt ein: AWS Elemental MediaConvert   

```
<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>
```
Wenn Sie die Formatkennung `$Time$` in einer Ausgabe verwenden, müssen Sie sie auch in jeder anderen Ausgabe der Ausgabegruppe verwenden.

$RepräsentationID$  
Wird in Ihren Ausgabedateinamen in die numerische Reihenfolge der Ausgabe in Ihren Jobeinstellungen `$RepresentationID$` aufgelöst.  
 AWS Elemental MediaConvert Verwendet diesen Bezeichner im `SegmentTemplate` Element im Manifest, um auf die richtigen Pfade für jede Darstellung zu verweisen.  
Diese Format-ID ist besonders nützlich, wenn Sie Ihre DASH-Ausgaben nach Repräsentations-ID organisieren müssen.

## Angabe einer Mindestanzahl von Ziffern
<a name="specifying-a-minimum-number-of-digits"></a>

Bei Formatkennungen, die eine Zahl zurückgeben, können Sie angeben, in wie viele Ziffern die Formatkennung mindestens aufgelöst werden muss. Wenn Sie dies tun, fügt der Service vor Werten mit weniger Ziffern Nullen als Platzhalter ein.

Mit folgender Syntax geben Sie die Anzahl an Ziffern an: **%0[number of digits]**. Setzen Sie diesen Wert direkt vor das letzte `$` der Formatkennung.

Angenommen, die Frame-Höhe des Videos liegt bei 720 und Sie möchten festlegen, dass mindestens vier Ziffern im Dateinamen enthalten sind, also `0720` zu sehen ist. Hierzu verwenden Sie die Formatkennung **$h%04$**.

**Anmerkung**  
Werte, die mehr als die angegebenen Stellen haben, werden auch in mehr Ziffern aufgelöst.