Verwenden von Variablen in Ihren Jobeinstellungen

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.

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.

Weitere Informationen zu den Formatkennungen, die in Streaming-Ausgaben eine andere Funktion haben, finden Sie unter Verwendung von Einstellungsvariablen mit Streaming-Ausgaben.

Liste der Einstellungsvariablen mit Beispielen

Die folgende Tabelle enthält Informationen zu den einzelnen Formatbezeichnern, die Sie in Ihrem AWS Elemental-Job verwenden können. MediaConvert Weitere Informationen zu den Formatkennungen, die in Streaming-Ausgaben eine andere Funktion haben, finden Sie unter Verwendung von Einstellungsvariablen mit Streaming-Ausgaben.

Format-ID	Wert, der in die Jobeinstellung eingegeben werden soll	Kompatible Jobeinstellungen	Beschreibung und Beispiel
Datum und Uhrzeit	$dt$	Bestimmungsort Namensmodifikator Segmentmodifikator	UTCDatum und Uhrzeit der Startzeit des Jobs. Format: YYYYMMDDTHHMMSS Beispiel: Bei einer Aufgabe, die am 4. Juni 2020 um 15:05:28 Uhr beginnt, wird $dt$ in 20200604T150528 aufgelöst.
Datum	$d$	Bestimmungsort Namensmodifikator Segmentmodifikator	UTCDatum der Startzeit des Jobs. Format: YYYYMMDD Beispiel: Bei einer Aufgabe, die am 4. Juni 2020 beginnt, wird $d$ in 20200604 aufgelöst.
Zeit	$t$	Bestimmungsort Namensmodifikator Segmentmodifikator	UTCStartzeit des Jobs. Format: HHMMSS Beispiel: Bei einer Aufgabe, die um 15:05:28 Uhr beginnt, wird $t$ in 150528 aufgelöst.
Video-Bitrate	$rv$	Namensmodifikator Segmentmodifikator	Video-Bitrate der Ausgabe, in Kilobits Für QVBR Ausgaben verwendet der Dienst die maximale Video-Bitrate in Kilobit. Beispiel: Wenn Sie Encoding settings (Codierungseinstellungen), Video, Bitrate (bits/s) auf 50000000 festlegen, wird $rv$ in 50000 aufgelöst.
Audio-Bitrate	$ra$	Namensmodifikator Segmentmodifikator	Gesamtwert der Audio-Bitraten der Ausgabe, in Kilobits 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 Segmentmodifikator	Kombinierte Audio- und Video-Bitrate der Ausgabe, in Kilobits 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 Segmentmodifikator	Frame-Breite bzw. horizontale Auflösung, in Pixeln 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 Segmentmodifikator	Frame-Höhe bzw. vertikale Auflösung, in Pixeln 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 Segmentmodifikator	Framerate, in Frames pro Sekunde, verkürzt auf die nächste Ganzzahl Beispiel: Wenn die Framerate 59.940 lautet, wird $f$ in 59 aufgelöst.
Name der Eingabedatei	$fn$	Bestimmungsort Namensmodifikator Segmentmodifikator	Name der Eingabedatei, ohne Dateierweiterung Bei Aufgaben mit mehreren Eingabedateien ist dies die erste in der Aufgabe angegebene Datei. 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 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. Beispiel für eine Dateigruppe: Wenn Sie MPEG2-TS für die Ausgabeeinstellungen wählen, wird Container zu aufgelöst. $ex$ m2ts Beispiel für HLS Gruppe: Wenn Ihre Ausgabegruppe istHLS, wird $ex$ aufgelöst zu. m3u8
$	$$	Namensmodifikator Segmentmodifikator	Durch Escape-Zeichen geschütztes $. Beispiel: Angenommen, Sie geben folgende Werte ein: Name der Eingabedatei: file1.mp4 Ziel: s3://amzn-s3-demo-bucket/ Namensmodifikator: my-video$$hi-res- Name und Pfad der Ausgabedatei werden in s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4 aufgelöst.

Verwendung von Einstellungsvariablen mit Streaming-Ausgaben

Variablen in Ihren Jobeinstellungen, auch Formatbezeichner genannt, funktionieren für Ausgaben in Apple HLS und für DASH ISO Ausgabegruppen unterschiedlich. Hier die Unterschiede:

Für Apple-Ausgaben HLS

Wenn Sie die Formatkennungen für Datum und Uhrzeit ($dt$,$t$,$d$) in der Einstellung „Segmentmodifikator“ verwenden, werden diese Formatkennungen anhand der Abschlusszeit jedes Segments und nicht anhand der Startzeit des Jobs aufgelöst.

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.

Für Ausgaben DASH ISO

Sie können in der Einstellung Name modifier (Namensmodifikator) zwei weitere Formatkennungen nutzen. Diese wirken sich neben dem Namen der Ausgabedatei 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. Beispielsweise:

• 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.

In Ihrem DASH Manifest MediaConvert schließt AWS Elemental das Element ein duration und startNumber innerhalb des SegmentTemplate Elements ein, und zwar wie folgt: <SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>

Anmerkung

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.

Im Manifest MediaConvert schließt AWS Elemental das Element 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.

Im Manifest MediaConvert schließt AWS Elemental SegmentTimeline innerhalb des SegmentTemplate Elements wie folgt ein:

<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>

Anmerkung

Wenn Sie die Formatkennung $Time$ in einer Ausgabe verwenden, müssen Sie sie auch in jeder anderen Ausgabe der Ausgabegruppe verwenden.

Angabe einer Mindestanzahl von Ziffern

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.