

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 작업 설정에서 변수 사용
<a name="using-variables-in-your-job-settings"></a>

작업 설정에서 *format identifiers(형식 식별자)*라고도 하는 변수를 사용할 수 있습니다. 형식 식별자는 입력 파일 또는 작업의 특성에 따라 출력에서 다르게 해결되는 작업 설정에 넣을 수 있는 값입니다. 이들은 출력 사전 설정, 작업 템플릿, 복제 및 재사용하려는 작업에 특히 유용합니다. 변수는 대/소문자를 구분합니다.

예를 들어, **대상** 설정에 날짜 형식 식별자 `$d$`(을)를 사용할 수 있습니다. 작업이 시작되는 날짜와 시간으로 출력을 정리하게 하려면 **대상**에 **s3://amzn-s3-demo-bucket1/$d$/**을(를) 입력하세요. 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$` | Destination<br />이름 수정자<br />세그먼트 수정자 | 작업 시작 날짜와 시간(UTC)<br />형식: YYYYMMDDTHHMMSS<br />예제: 2020년 6월 4일 오후 3시 05분 28초에 시작하는 작업의 경우, **$dt$**은(는) `20200604T150528`이(가) 됩니다. | 
| Date | `$d$` | Destination<br />이름 수정자<br />세그먼트 수정자 | 작업 시작 날짜(UTC) <br />형식: YYYYMMDD<br />예제: 2020년 6월 4일에 시작하는 작업의 경우, **$d$**은(는) `20200604`이(가) 됩니다. | 
| Time | `$t$` | Destination<br />이름 수정자<br />세그먼트 수정자 | 작업 시작 시간(UTC) <br />형식: HHMMSS<br />예제: 오후 3시 05분 28초에 시작하는 작업의 경우, **$t$**은(는) `150528`이(가) 됩니다. | 
| Video bitrate | `$rv$` | 이름 수정자<br />세그먼트 수정자 | 출력의 비디오 비트레이트(킬로비트)입니다. QVBR 출력의 경우, 서비스에서 최대 비디오 비트레이트(킬로비트)를 사용합니다.<br />예제: **Encoding settings(인코딩 설정)**, **Video(비디오)**, **비트레이트(bits/s)**를 **50000000**(으)로 설정하면, **$rv$**은(는) `50000`이(가) 됩니다. | 
| Audio bitrate | `$ra$` | 이름 수정자<br />세그먼트 수정자 | 출력의 모든 오디오 비트레이트(킬로비트)의 합계입니다.<br />예제: 단일 오디오 탭이 있는 출력이 있고 **Encoding settings(인코딩 설정)**, **Audio 1(오디오 1)**, **비트레이트(kbit/s)**가 **256000**인 경우, **$ra$**는 `256000`이(가) 됩니다. | 
| Container bitrate | `$rc$` | 이름 수정자<br />세그먼트 수정자 | 출력에 대한 오디오 및 비디오 결합 비트레이트(킬로비트).<br />예제: **Video(비디오)** 설정 탭과 **Audio 1(오디오 1)** 설정 탭이 있는 출력이 있습니다. **Encoding settings(인코딩 설정)**, **Video(비디오)**, **비트레이트(bits/s)**를 **5000000**으로 설정하고 **Encoding settings(인코딩 설정)**, **Audio(오디오)**, **비트레이트(bits/s)**를 **96000**(96킬로비트)으로 설정한 경우, **$rc$**는 `5096`이 됩니다. | 
| Video frame width | `$w$` | 이름 수정자<br />세그먼트 수정자 | 프레임 너비 또는 수평 해상도(픽셀 단위)입니다.<br />예제: **Encoding settings(인코딩 설정)**, **Video(비디오)**, **해상도(w x h)**를 **1280**x**720**으로 설정하면 **$w$**은(는) `1280`이(가) 됩니다. | 
| Video frame height | `$h$` | 이름 수정자<br />세그먼트 수정자 | 프레임 높이 또는 세로 해상도(픽셀 단위)입니다.<br />예제: **Encoding settings(인코딩 설정)**, **Video(비디오)**, **해상도(w x h)**를 **1280**x**720**으로 설정하면 **$h$**은(는) `720`이(가) 됩니다. | 
| Framerate | `$f$` | 이름 수정자<br />세그먼트 수정자 | 프레임 속도(초당 프레임 수)는 정수만 남기고 자릅니다.<br />예제: 프레임 속도가 **59.940**인 경우 **$f$**은(는) `59`이(가) 됩니다. | 
| Input file name | `$fn$` | Destination<br />이름 수정자<br />세그먼트 수정자 | 파일 확장명이 없는 입력 파일의 이름 다중 입력이 있는 작업의 경우 작업에서 지정된 첫 번째 파일입니다.<br />예제: 작업의 **Input 1(입력 1)**이 **s3://amzn-s3-demo-bucket/my-video.mov**인 경우, **$fn$**은(는) `my-video`이(가) 됩니다. | 
| Output container file extension | `$ex$` | 이름 수정자<br />세그먼트 수정자 | 출력 그룹에 따라 다릅니다. **File group(파일 그룹)** 출력의 경우, 출력 컨테이너 파일의 확장자입니다. 다른 출력 그룹의 경우에는 매니페스트의 확장자입니다.<br />파일 그룹 예제: **MPEG2-TS**를 **Output settings(출력 설정)**, **Container(컨테이너)**에 대해 선택하는 경우, **$ex$**은(는) `m2ts`이(가) 됩니다.<br />HLS 그룹의 예제: 출력 그룹이 HLS이면 **$ex$**은(는) `m3u8`이(가) 됩니다. | 
| $ | `$$` | 이름 수정자<br />세그먼트 수정자 | 이스케이프된 `$`.<br />예제: <br />다음 값을 제공한다고 가정해 보세요.+  입력 파일 이름: **file1.mp4** <br />+  대상: **s3://amzn-s3-demo-bucket/** <br />+  이름 수정자: **my-video$$hi-res-** <br />출력 파일 이름과 경로는 `s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4`가 됩니다. | 

## 스트리밍 출력과 함께 설정 변수 사용
<a name="using-settings-variables-with-streaming-outputs"></a>

*format identifiers(형식 식별자)*라고도 하는 작업 설정의 변수는 Apple HLS 및 DASH ISO 출력 그룹의 출력에 대해 다르게 작동합니다. 차이점은 다음과 같습니다.

**Apple HLS 출력의 경우**  
**세그먼트 수정자** 설정에서 날짜 및 시간 형식 식별자(`$dt$`, `$t$`, `$d$`)를 사용하면, 이러한 형식 식별자는 작업 시작 시간이 아닌 각 세그먼트의 완료 시간이 됩니다.

**참고**  
가속화된 트랜스코딩을 사용하는 작업의 경우 세그먼트가 동시에 완료될 수 있습니다. 즉, 날짜 및 시간 형식 식별자가 항상 고유한 값이 되지는 않습니다.

**DASH ISO 출력의 경우**  
**Name modifier(이름 수정자)** 설정에서 두 개의 추가 형식 식별자를 사용할 수 있습니다. 이는 출력 파일 이름 외에 DASH 매니페스트에 영향을 줍니다. 식별자는 다음과 같습니다.

$Number$  
출력 파일 이름에서 `$Number$`은(는) 1에서 시작해서 증가하는 일련의 숫자가 됩니다. 이는 세그먼트 파일 이름의 기본 9자리 세그먼트 번호를 대체합니다. 예제:   
+ **video\_$Number$**을(를) **Name modifier(이름 수정자)**로 지정하면 서비스는 `video_1.mp4`, `video_2.mp4` 등으로 명명된 세그먼트 파일을 작성합니다.
+ **video\_**만 **Name modifier(이름 수정자)**(으)로 지정하면 서비스는 `video_000000001.mp4`, `video_000000002.mp4` 등으로 명명된 세그먼트 파일을 작성합니다.
DASH 매니페스트에는 다음과 같이 `SegmentTemplate` 및 AWS Elemental MediaConvert `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자리 세그먼트 번호 부여를 사용합니다.  
예를 들어 다음 값을 지정한다고 가정해 보겠습니다.  
+ **Video(비디오)**, **비트레이트(bits/s)**: **50000000** 
+  **Audio(오디오)**, **비트레이트(kbits/s)**: **96.0**(96,000 bits/s)
+ **이름 수정자**: **video\_$Bandwidth$**
$Bandwidth$의 값은 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"/>`.

$Time$  
출력 파일 이름에서 `$Time$`은(는) 세그먼트의 지속 시간(밀리초)이 됩니다. 이 형식 식별자를 포함하면 서비스는 세그먼트 파일 이름에 9자리 세그먼트 번호 부여를 사용하지 않습니다.  
예를 들어, **video180\_\_$Time$**을(를) **Name modifier(이름 수정자)**로 지정하면 서비스는 `video180__345600.mp4`, `video180__331680.mp4` 등으로 명명된 세그먼트 파일을 작성합니다. 이 예제에서 세그먼트 지속 시간은 345,600ms와 331,680ms입니다.  
매니페스트에서는 다음과 같이 `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$` 형식 식별자를 사용하는 경우, 출력 그룹의 다른 모든 출력에서도 해당 형식 식별자를 사용해야 합니다.

$RepresentationID$  
출력 파일 이름에서는 작업 설정에서 출력의 숫자 순서로 `$RepresentationID$` 해석합니다.  
매니페스트에서는 `SegmentTemplate` 요소의이 식별자를 AWS Elemental MediaConvert 사용하여 각 표현에 대한 올바른 경로를 참조합니다.  
이 형식 식별자는 표현 ID로 DASH 출력을 구성해야 할 때 특히 유용합니다.

## 최소 자릿수 지정
<a name="specifying-a-minimum-number-of-digits"></a>

숫자를 반환하는 형식 식별자의 경우, 형식 식별자가 해석할 최소 자릿수를 지정할 수 있습니다. 이렇게 하면 서비스는 더 적은 자릿수를 반환하는 모든 값 앞에 패딩으로 0을 추가합니다.

다음 구문을 사용하여 자릿수를 지정합니다. **%0[number of digits]** 형식 식별자의 마지막 `$` 바로 앞에 이 값을 넣으세요.

예를 들어, 비디오 프레임 높이가 720이고 파일 이름에 `0720`와(과) 같이 최소 4자리를 지정한다고 가정합니다. 이를 수행하려면 다음 형식 식별자를 사용하세요. **$h%04$** 

**참고**  
지정한 자릿수로 표현하기에는 너무 큰 값은 더 많은 자릿수가 됩니다.