작업 설정에서 변수 사용

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

예를 들어, 대상 설정에 날짜 형식 식별자 $d$(을)를 사용할 수 있습니다. 작업이 시작되는 날짜와 시간으로 출력을 정리하게 하려면 대상에 s3://DOC-EXAMPLE-BUCKET1/$d$/을(를) 입력하세요. 2020년 6월 4일에 시작하는 작업에 대한 서비스는 s3://DOC-EXAMPLE-BUCKET1/20200604/에 출력을 생성합니다.

사용 가능한 형식 식별자 목록 및 사용 방법에 대한 예제는 설정 변수 목록 및 예제을(를) 참조하세요.

스트리밍 출력에서 다르게 작동하는 형식 식별자에 대한 자세한 내용은 스트리밍 출력과 함께 설정 변수 사용을(를) 참조하세요.

설정 변수 목록 및 예제

다음 표에는 AWS MediaConvert Elemental 작업에 사용할 수 있는 각 형식 식별자에 대한 정보가 나와 있습니다. 스트리밍 출력에서 다르게 작동하는 형식 식별자에 대한 자세한 내용은 스트리밍 출력과 함께 설정 변수 사용을(를) 참조하세요.

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

스트리밍 출력과 함께 설정 변수 사용

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 매니페스트에서 AWS MediaConvert Elemental은 다음과 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자리 세그먼트 번호 부여를 사용합니다.

예를 들어 다음 값을 지정한다고 가정해 보겠습니다.

• 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 등으로 명명된 세그먼트 파일을 생성합니다.

매니페스트에서 AWS MediaConvert SegmentTemplate Elemental은 다음과 같이 요소 내부에 duration startNumber 포함시킵니다. <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입니다.

매니페스트에서 AWS MediaConvert SegmentTemplate Elemental은 다음과 같이 요소 내부에 SegmentTimeline 포함합니다.

<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을 추가합니다.

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

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

참고

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