翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
ジョブ設定で変数を使用する
ジョブ設定では、変数 (形式識別子とも呼ばれる) を使用することができます。形式識別子は、入力ファイルまたはジョブの特性に応じて、出力で異なる解決をするジョブ設定に入れることができる値です。これらは、出力プリセット、ジョブテンプレート、および複製して再利用する予定のジョブで特に役立ちます。
例えば、Destination (送信先) 設定に日付形式の識別子 $d$
を使用できます。ジョブの開始日および開始時間で出力を整理する場合は、宛先に s3://DOC-EXAMPLE-BUCKET1/$d$/
と入力します。2020 年 6 月 4 日に開始するジョブの場合、出力は、サービスによって、s3://DOC-EXAMPLE-BUCKET1/20200604/
に作成されます。
利用可能な形式識別子のリストとそれらの使用例については、設定変数の一覧 (例を含む) を参照してください。
ストリーミング出力では動作が異なる形式識別子の詳細については、ストリーミング出力で設定変数を使用する を参照してください。
設定変数の一覧 (例を含む)
次の表は、AWS Elemental MediaConvert ジョブで使用できる各形式識別子に関する情報です。ストリーミング出力では動作が異なる形式識別子の詳細については、ストリーミング出力で設定変数を使用する を参照してください。
形式識別子 | ジョブ設定に入力する値 | 互換ジョブ設定 | 説明と例 |
---|---|---|---|
日付および時間 |
|
デスティネーション 名前修飾子 セグメント修飾子 |
ジョブの開始時刻 (UTC)。 形式: YYYYMMDDTHHMMSS 例: 6 月 4 日、午後 3:05:28 に開始するジョブの場合、 |
日付 |
|
デスティネーション 名前修飾子 セグメント修飾子 |
ジョブの開始時間の日付 (UTC)。 形式: YYYYMMDD 例: 6 月 4 日に開始するジョブの場合、 |
時間 |
|
デスティネーション 名前修飾子 セグメント修飾子 |
ジョブの開始時刻 (UTC)。 形式: HHMMSS 例: 午後 3:05:28 に開始するジョブの場合、 |
動画のビットレート |
|
名前修飾子 セグメント修飾子 |
出力のビデオビットレート (キロビット) です。QVBR 出力の場合、サービスでは、ビデオの最大ビットレート (キロビット) が使用されます。 例: エンコード設定、ビデオ、ビットレート (ビット/秒) を |
オーディオのビットレート |
|
名前修飾子 セグメント修飾子 |
出力のすべてのオーディオのビットレートの合計 (キロビット)。 例: 1 つのオーディオタブを持つ出力があり、エンコード設定、 Audio 1、ビットレート (キロビット/秒) を |
コンテナのビットレート |
|
名前修飾子 セグメント修飾子 |
出力のオーディオとビデオの合計ビットレート (キロビット)。 例: [ビデオ] 設定タブおよび [オーディオ 1] 設定タブを含む出力があります。[エンコード設定]、[ビデオ]、[ビットレート (ビット/秒)] を |
ビデオフレーム幅 |
|
名前修飾子 セグメント修飾子 |
フレーム幅または水平解像度 (ピクセル単位)。 例: [エンコード設定]、[ビデオ]、[解像度 (w x h)] を |
動画フレームの高さ |
|
名前修飾子 セグメント修飾子 |
フレームの高さ、または垂直解像度 (ピクセル単位)。 例: [エンコード設定]、[ビデオ]、[解像度 (w x h)] を |
Framerate |
|
名前修飾子 セグメント修飾子 |
フレームレート (1 秒あたりのフレーム数) は、最も近い整数に切り捨てられます。 例: フレームレートが |
入力ファイル名 |
|
デスティネーション 名前修飾子 セグメント修飾子 |
入力ファイル名 (ファイル拡張子なし) です。複数の入力を持つジョブの場合は、このファイルがジョブで最初に指定されます。 例: ジョブの [Input 1] が |
出力コンテナのファイル拡張子 |
|
名前修飾子 セグメント修飾子 |
出力グループによって異なります。[ファイルグループ] で、出力コンテナファイルの拡張子を表します。その他の出力グループの場合は、マニフェストの拡張子です。 ファイルグループの例: [Output settings] (出力設定)、[Container] (コンテナ) に MPEG2-TS を選択すると、 HLS グループの例: 出力グループが HLS の場合、 |
$ |
|
名前修飾子 セグメント修飾子 |
エスケープ 例: 次の値を指定するとします。
出力ファイル名とパスは |
ストリーミング出力で設定変数を使用する
ジョブ設定の変数 (形式識別子とも呼ばれる) は、Apple HLS と DASH ISO 出力グループの出力では動作が異なります。違いは以下のとおりです。
Apple HLS 出力の場合
セグメント修飾子の設定で日付と時刻のフォーマット識別子 ($dt$
、$t$
、$d$
) でを使用する場合、これらのフォーマット識別子は、ジョブの開始時刻ではなく、各セグメントの完了時刻に解決されます。
注記
高速トランスコードを使用するジョブの場合、セグメントは同時に完了することがあります。つまり、日付と時刻の形式識別子は、常に一意の値に解決されるわけではありません。
DASH ISO 出力の場合
[名前修飾子] 設定では、他にも 2 つの形式識別子を使用できます。これらの形式識別子は、出力ファイル名だけでなく、DASH マニフェストにも影響します。識別子は次のとおりです。
- $Number$
-
出力ファイル名の
$Number$
は、1 から増加する数値に解決されます。その結果、セグメントファイル名のデフォルトの 9 桁のセグメント番号が置き換えられます。例:-
Name 修飾子に
video_$Number$
を指定した場合、video_1.mp4
、video_2.mp4
などのセグメントファイルが作成されます。 -
Name 修飾子に
video_
のみを指定した場合、サービスはvideo_000000001.mp4
、video_000000002.mp4
といった名前のセグメントファイルを作成します。
DASH マニフェストでは、AWS Elemental は
SegmentTemplate
要素startNumber
内にduration
と を次のように MediaConvert 含めます。<SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>
注記
出力で
$Number$
形式を使用する場合は、出力グループのその他のすべての出力でもその形式を使用する必要があります。 -
- $Bandwidth$
-
出力ファイル名で、
$Bandwidth$
は、出力の [Video] (ビデオ)、[Bitrate] (ビットレート) のほか、[Audio] (オーディオ)、[Bitrate] (ビットレート) に解決されます。この形式識別子を含むかどうかにかかわらず、サービスのセグメントファイル名では、9 桁のセグメント番号が使用されます。たとえば、次の値を指定したとします。
-
ビデオ、ビットレート (ビット/秒):
50000000
-
オーディオ、ビットレート (キロビット/秒):
96.0
(96,000 ビット/秒) -
名前修飾子:
video_$Bandwidth$
$Bandwidth$ の値は 50,096,000 に解決されます。このサービスでは、
video_50096000_000000001.mp4
、
などのセグメントファイルが作成されます。video_50096000_000000002.mp4
マニフェストでは、AWS Elemental MediaConvert は
SegmentTemplate
要素startNumber
内にduration
と を含めます<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>
。 -
- $Time$
-
出力ファイル名で、
$Time$
はセグメントの期間 (ミリ秒) に解決されます。この形式識別子を含めた場合、サービスのセグメントファイル名にデフォルトの 9 桁のセグメント番号は使用されません。例えば、Name 修飾子に
video180__$Time$
を指定した場合、サービスはvideo180__345600.mp4
、video180__331680.mp4
などのセグメントファイルを作成します。これらの例では、セグメント期間は、345,600 ミリ秒および 331,680 ミリ秒です。マニフェストでは、AWS Elemental は次のように
SegmentTemplate
要素SegmentTimeline
内に 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>
注記
出力で
$Time$
形式を使用する場合は、出力グループのその他のすべての出力でもその形式を使用する必要があります。
最小桁数を指定する
数値を返す形式識別子の場合は、その形式識別子によって解決される最小桁数を指定できます。この操作を行うと、桁数が少ない任意の値の前にゼロのパディングが追加されます。
桁数を指定するには、構文 %0[number of
digits]
を使用します。形式識別子の最終の $
の直前にこの値を挿入します。
たとえば、ビデオフレームの高さが 720 で、ファイル名に 0720
と表示されるように最低 4 桁を指定するとします。そのためには、形式識別子 ($h%04$
) を使用します。
注記
値が、指定した桁数で表すには大きすぎる場合は、それ以上の桁数で解決します。