

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

# ジョブ設定で変数を使用する
<a name="using-variables-in-your-job-settings"></a>

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

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

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

ストリーミング出力では動作が異なる形式識別子の詳細については、[ストリーミング出力で設定変数を使用する](#using-settings-variables-with-streaming-outputs) を参照してください。

**Topics**
+ [設定変数の一覧 (例を含む)](#list-of-settings-variables-with-examples)
+ [ストリーミング出力で設定変数を使用する](#using-settings-variables-with-streaming-outputs)
+ [最小桁数を指定する](#specifying-a-minimum-number-of-digits)

## 設定変数の一覧 (例を含む)
<a name="list-of-settings-variables-with-examples"></a>

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


| 形式識別子 | ジョブ設定に入力する値 | 互換ジョブ設定 | 説明と例 | 
| --- |--- |--- |--- |
| Date and time |  `$dt$`  |  目的地 名前修飾子 セグメント修飾子  |  ジョブの開始時刻 (UTC)。 形式: YYYYMMDDTHHMMSS 例: 6 月 4 日、午後 3:05:28 に開始するジョブの場合、**\$1dt\$1** は `20200604T150528` に解決されます。  | 
| Date |  `$d$`  |  目的地 名前修飾子 セグメント修飾子  |  ジョブの開始時間の日付 (UTC)。 形式: YYYYMMDD 例: 6 月 4 日に開始するジョブの場合、**\$1d\$1** は `20200604` に解決されます。  | 
| Time |  `$t$`  |  目的地 名前修飾子 セグメント修飾子  |  ジョブの開始時刻 (UTC)。 形式: HHMMSS 例: 午後 3:05:28 に開始するジョブの場合、**\$1t\$1** は `150528` に解決されます。  | 
| Video bitrate |  `$rv$`  |  名前修飾子 セグメント修飾子  |  出力のビデオビットレート (キロビット) です。QVBR 出力の場合、サービスでは、ビデオの最大ビットレート (キロビット) が使用されます。 例: **エンコード設定**、**ビデオ**、**ビットレート (ビット/秒)** を **50000000** に設定した場合、**\$1rv\$1** は `50000` に解決されます。  | 
| Audio bitrate |  `$ra$`  |  名前修飾子 セグメント修飾子  |  出力のすべてのオーディオのビットレートの合計 (キロビット)。 例: 1 つのオーディオタブを持つ出力があり、**エンコード設定**、 **Audio 1**、**ビットレート (キロビット/秒)** を **256000** に設定した場合、**\$1ra\$1** は `256000` に解決されます。  | 
| Container bitrate |  `$rc$`  |  名前修飾子 セグメント修飾子  |  出力のオーディオとビデオの合計ビットレート (キロビット)。 例: [**ビデオ**] 設定タブおよび [**オーディオ 1**] 設定タブを含む出力があります。[**エンコード設定**]、[**ビデオ**]、[**ビットレート (ビット/秒)**] を **5000000** に設定し、[**エンコード設定**]、[**オーディオ**]、[**ビットレート (ビット/秒)**] を [**96000**] (96 キロビット) に設定した場合、**\$1rc\$1** は `5096` に解決されます。  | 
| Video frame width |  `$w$`  |  名前修飾子 セグメント修飾子  |  フレーム幅または水平解像度 (ピクセル単位)。 例: [**エンコード設定**]、[**ビデオ**]、[**解像度 (w x h)**] を **1280** x **720** に設定した場合、**\$1w\$1** は `1280` に解決されます。  | 
| Video frame height |  `$h$`  |  名前修飾子 セグメント修飾子  |  フレームの高さ、または垂直解像度 (ピクセル単位)。 例: [**エンコード設定**]、[**ビデオ**]、[**解像度 (w x h)**] を **1280** x **720** に設定した場合、**\$1h\$1** は `720` に解決されます。  | 
| Framerate |  `$f$`  |  名前修飾子 セグメント修飾子  |  フレームレート (1 秒あたりのフレーム数) は、最も近い整数に切り捨てられます。 例: フレームレートが **59.940** の場合、**\$1f\$1** は `59` に解決されます。  | 
| Input file name |  `$fn$`  |  目的地 名前修飾子 セグメント修飾子  |  入力ファイル名 (ファイル拡張子なし) です。複数の入力を持つジョブの場合は、このファイルがジョブで最初に指定されます。 例: ジョブの [**Input 1**] が **s3://amzn-s3-demo-bucket/my-video.mov** の場合、**\$1fn\$1** は `my-video` に解決されます。  | 
| Output container file extension |  `$ex$`  |  名前修飾子 セグメント修飾子  |  出力グループによって異なります。[**ファイルグループ**] で、出力コンテナファイルの拡張子を表します。その他の出力グループの場合は、マニフェストの拡張子です。 ファイルグループの例: [**Output settings**] (出力設定)、[**Container**] (コンテナ) に **MPEG2-TS** を選択すると、**\$1ex\$1** は `m2ts` に解決します。 HLS グループの例: 出力グループが HLS の場合、**\$1ex\$1** は `m3u8` に解決されます。  | 
| \$1 |  `$$`  |  名前修飾子 セグメント修飾子  |  エスケープ `$`。 例:  次の値を指定するとします。   入力ファイル名: **file1.mp4**   送信先: **s3://amzn-s3-demo-bucket/**   名前修飾子: **my-video\$1\$1hi-res-**   出力ファイル名とパスは `s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4` に解決されます。  | 

## ストリーミング出力で設定変数を使用する
<a name="using-settings-variables-with-streaming-outputs"></a>

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

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

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

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

\$1Number\$1  
出力ファイル名の `$Number$` は、1 から増加する数値に解決されます。その結果、セグメントファイル名のデフォルトの 9 桁のセグメント番号が置き換えられます。例:   
+ **Name 修飾子**に **video\$1\$1Number\$1** を指定した場合、`video_1.mp4`、`video_2.mp4` などのセグメントファイルが作成されます。
+ **Name 修飾子**に **video\$1** のみを指定した場合、サービスは `video_000000001.mp4`、`video_000000002.mp4` といった名前のセグメントファイルを作成します。
DASH マニフェストでは、 は次のように `SegmentTemplate`要素`startNumber`内に `duration`と AWS Elemental MediaConvert を含めます。 `<SegmentTemplate timescale="90000" media="main_video_$Number$.mp4" initialization="main_video_$Number$init.mp4" duration="3375000"/>`  
出力で `$Number$` 形式を使用する場合は、出力グループのその他のすべての出力でもその形式を使用する必要があります。

\$1Bandwidth\$1   
出力ファイル名で、`$Bandwidth$` は、出力の **[Video]** (ビデオ)、**[Bitrate]** (ビットレート) のほか、**[Audio]** (オーディオ)、**[Bitrate]** (ビットレート) に解決されます。この形式識別子を含むかどうかにかかわらず、サービスのセグメントファイル名では、9 桁のセグメント番号が使用されます。  
たとえば、次の値を指定したとします。  
+ **ビデオ**、**ビットレート (ビット/秒)**: **50000000** 
+  **オーディオ**、**ビットレート (キロビット/秒)**: **96.0** (96,000 ビット/秒)
+ **名前修飾子**: **video\$1\$1Bandwidth\$1**
\$1Bandwidth\$1 の値は 50,096,000 に解決されます。このサービスでは、`video_50096000_000000001.mp4`、`video_50096000_000000002.mp4` などのセグメントファイルが作成されます。  
マニフェストでは、 は `SegmentTemplate`要素`startNumber`内に `duration`と AWS Elemental MediaConvert を含めます。例: `<SegmentTemplate timescale="90000" media="main_video_$Bandwidth$.mp4" initialization="main_video_$Bandwidth$init.mp4" duration="3375000"/>`。

\$1Time\$1  
出力ファイル名で、`$Time$` はセグメントの期間 (ミリ秒) に解決されます。この形式識別子を含めた場合、サービスのセグメントファイル名にデフォルトの 9 桁のセグメント番号は使用されません。  
例えば、**Name 修飾子**に **video180\$1\$1\$1Time\$1** を指定した場合、サービスは `video180__345600.mp4`、`video180__331680.mp4` などのセグメントファイルを作成します。これらの例では、セグメント期間は、345,600 ミリ秒および 331,680 ミリ秒です。  
マニフェストでは、 は `SegmentTemplate`要素`SegmentTimeline`内に次のように 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>
```
出力で `$Time$` 形式を使用する場合は、出力グループのその他のすべての出力でもその形式を使用する必要があります。

\$1RepresentationID\$1  
出力ファイル名で、 はジョブ設定 の出力の数値順に`$RepresentationID$`解決されます。  
マニフェストでは、 は `SegmentTemplate`要素でこの識別子 AWS Elemental MediaConvert を使用して、各表現の正しいパスを参照します。  
この形式識別子は、表現 ID で DASH 出力を整理する必要がある場合に特に便利です。

## 最小桁数を指定する
<a name="specifying-a-minimum-number-of-digits"></a>

数値を返す形式識別子の場合は、その形式識別子によって解決される最小桁数を指定できます。この操作を行うと、桁数が少ない任意の値の前にゼロのパディングが追加されます。

桁数を指定するには、構文 **%0[number of digits]** を使用します。形式識別子の最終の `$` の直前にこの値を挿入します。

たとえば、ビデオフレームの高さが 720 で、ファイル名に `0720` と表示されるように最低 4 桁を指定するとします。そのためには、形式識別子 (**\$1h%04\$1**) を使用します。

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