ジョブ設定で変数を使用する - MediaConvert

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

ジョブ設定で変数を使用する

ジョブ設定では、変数 (形式識別子とも呼ばれる) を使用することができます。形式識別子は、入力ファイルまたはジョブの特性に応じて、出力で異なる解決をするジョブ設定に入れることができる値です。これらは、出力プリセット、ジョブテンプレート、および複製して再利用する予定のジョブで特に役立ちます。

例えば、Destination (送信先) 設定に日付形式の識別子 $d$ を使用できます。ジョブの開始日および開始時間で出力を整理する場合は、宛先s3://mediaconvert-output-bucket/$d$/ と入力します。2020 年 6 月 4 日に開始するジョブの場合、出力は、サービスによって、s3://mediaconvert-output-bucket/20200604/ に作成されます。

利用可能な形式識別子のリストとそれらの使用例については、設定変数の一覧 (例を含む) を参照してください。

ストリーミング出力では動作が異なる形式識別子の詳細については、ストリーミング出力で設定変数を使用する を参照してください。

設定変数の一覧 (例を含む)

次の表は、AWS Elemental MediaConvert ジョブで使用できる各形式識別子に関する情報を示しています。ストリーミング出力では動作が異なる形式識別子の詳細については、ストリーミング出力で設定変数を使用する を参照してください。

形式識別子 ジョブ設定に入力する値 互換ジョブ設定 説明と例
Date and time

$dt$

送信先

名前修飾子

セグメント修飾子

ジョブの開始時刻 (UTC)。

形式: YYYYMMDDTHHMMSS

例: 6 月 4 日、午後 3:05:28 に開始するジョブの場合、$dt$20200604T150528 に解決されます。

Date

$d$

送信先

名前修飾子

セグメント修飾子

ジョブの開始時間の日付 (UTC)。

形式: YYYYMMDD

例: 6 月 4 日に開始するジョブの場合、$d$20200604 に解決されます。

Time

$t$

送信先

名前修飾子

セグメント修飾子

ジョブの開始時刻 (UTC)。

形式: HHMMSS

例: 午後 3:05:28 に開始するジョブの場合、$t$150528 に解決されます。

Video bitrate

$rv$

名前修飾子

セグメント修飾子

出力のビデオビットレート (キロビット) です。QVBR 出力の場合、サービスでは、ビデオの最大ビットレート (キロビット) が使用されます。

例: エンコード設定ビデオビットレート (ビット/秒)50000000 に設定した場合、$rv$50000 に解決されます。

Audio bitrate

$ra$

名前修飾子

セグメント修飾子

出力のすべてのオーディオのビットレートの合計 (キロビット)。

例: 1 つのオーディオタブを持つ出力があり、エンコード設定Audio 1ビットレート (キロビット/秒)256000 に設定した場合、$ra$256000 に解決されます。

Container bitrate

$rc$

名前修飾子

セグメント修飾子

出力のオーディオとビデオの合計ビットレート (キロビット)。

例: [ビデオ] 設定タブおよび [オーディオ 1] 設定タブを含む出力があります。[エンコード設定]、[ビデオ]、[ビットレート (ビット/秒)] を 5000000 に設定し、[エンコード設定]、[オーディオ]、[ビットレート (ビット/秒)] を [96000] (96 キロビット) に設定した場合、$rc$5096 に解決されます。

Video frame width

$w$

名前修飾子

セグメント修飾子

フレーム幅または水平解像度 (ピクセル単位)。

例: [エンコード設定]、[ビデオ]、[解像度 (w x h)] を 1280 x 720 に設定した場合、$w$1280 に解決されます。

Video frame height

$h$

名前修飾子

セグメント修飾子

フレームの高さ、または垂直解像度 (ピクセル単位)。

例: [エンコード設定]、[ビデオ]、[解像度 (w x h)] を 1280 x 720 に設定した場合、$h$720 に解決されます。

Framerate

$f$

名前修飾子

セグメント修飾子

フレームレート (1 秒あたりのフレーム数) は、最も近い整数に切り捨てられます。

例: フレームレートが 59.940 の場合、$f$59 に解決されます。

Input file name

$fn$

送信先

名前修飾子

セグメント修飾子

入力ファイル名 (ファイル拡張子なし) です。複数の入力を持つジョブの場合は、このファイルがジョブで最初に指定されます。

例: ジョブの [Input 1] が s3://mediaconvert-input/my-video.mov の場合、$fn$my-video に解決されます。

Output container file extension

$ex$

名前修飾子

セグメント修飾子

出力グループによって異なります。[ファイルグループ] で、出力コンテナファイルの拡張子を表します。その他の出力グループの場合は、マニフェストの拡張子です。

ファイルグループの例: [Output settings] (出力設定)、[Container] (コンテナ) に MPEG2-TS を選択すると、$ex$m2ts に解決します。

HLS グループの例: 出力グループが HLS の場合、$ex$m3u8 に解決されます。

$

$$

名前修飾子

セグメント修飾子

エスケープ $

例:

次の値を指定するとします。

  • 入力ファイル名: file1.mp4

  • 送信先: s3://mediaconvert-input/

  • 名前修飾子: my-video$$hi-res-

出力ファイル名とパスは s3://mediaconvert-input/my-video$hi-res-file1.mp4 に解決されます。

ストリーミング出力で設定変数を使用する

ジョブ設定の変数 (形式識別子とも呼ばれる) は、Apple HLS と DASH ISO 出力グループの出力では動作が異なります。違いは以下のとおりです。

Apple HLS 出力の場合

セグメント修飾子の設定で日付と時刻のフォーマット識別子 ($dt$$t$$d$) でを使用する場合、これらのフォーマット識別子は、ジョブの開始時刻ではなく、各セグメントの完了時刻に解決されます。

注記

高速トランスコードを使用するジョブの場合、セグメントは同時に完了することがあります。つまり、日付と時刻の形式識別子は、常に一意の値に解決されるわけではありません。

DASH ISO 出力の場合

[名前修飾子] 設定では、他にも 2 つの形式識別子を使用できます。これらの形式識別子は、出力ファイル名だけでなく、DASH マニフェストにも影響します。識別子は次のとおりです。

$Number$

出力ファイル名の $Number$ は、1 から増加する数値に解決されます。その結果、セグメントファイル名のデフォルトの 9 桁のセグメント番号が置き換えられます。例:

  • Name 修飾子video_$Number$ を指定した場合、video_1.mp4video_2.mp4 などのセグメントファイルが作成されます。

  • Name 修飾子video_ のみを指定した場合、サービスは video_000000001.mp4video_000000002.mp4 といった名前のセグメントファイルを作成します。

DASH マニフェストで、AWS Elemental MediaConvert には、SegmentTemplate 要素内に duration および startNumber を含み、次のようになります。<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.mp4video_50096000_000000002.mp4 などのセグメントファイルが作成されます。

マニフェストで、AWS Elemental MediaConvert には、SegmentTemplate 要素内に duration および startNumber を含み、<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/> のようになります。

$Time$

出力ファイル名で、$Time$ はセグメントの期間 (ミリ秒) に解決されます。この形式識別子を含めた場合、サービスのセグメントファイル名にデフォルトの 9 桁のセグメント番号は使用されません。

例えば、Name 修飾子video180__$Time$ を指定した場合、サービスは video180__345600.mp4video180__331680.mp4 などのセグメントファイルを作成します。これらの例では、セグメント期間は、345,600 ミリ秒および 331,680 ミリ秒です。

マニフェストで、AWS Elemental MediaConvert には、SegmentTimeline 要素内に SegmentTemplate を含み、次のようになります。

<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$) を使用します。

注記

値が、指定した桁数で表すには大きすぎる場合は、それ以上の桁数で解決します。