Verwenden von Variablen in Ihren Jobeinstellungen - MediaConvert
Liste der Einstellungsvariablen mit BeispielenVerwenden von Einstellungsvariablen mit Streaming-AusgabenAngabe einer Mindestanzahl von Ziffern

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

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 MediaConvert Job verwenden können. 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 deinen 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.

Schließt in Ihrem DASH Manifest duration und startNumber innerhalb des SegmentTemplate Elements ein, etwa so: AWS Elemental MediaConvert <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.

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