작업 설정에서 변수 사용 - MediaConvert

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

작업 설정에서 변수 사용

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

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

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

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

설정 변수 목록 및 예제

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

형식 식별자 작업 설정 값 호환 가능한 작업 설정 설명 및 예제
날짜 및 시간

$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://amzn-s3-demo-bucket/my-video.mov인 경우, $fn$은(는) my-video이(가) 됩니다.

출력 컨테이너 파일 확장명

$ex$

이름 수정자

세그먼트 수정자

출력 그룹에 따라 다릅니다. File group(파일 그룹) 출력의 경우, 출력 컨테이너 파일의 확장자입니다. 다른 출력 그룹의 경우에는 매니페스트의 확장자입니다.

파일 그룹의 예: 출력 설정 , 컨테이너 에 대해 MPEG2-TS를 선택하면 가 로 $ex$ 해석됩니다m2ts.

HLS 그룹 예: 출력 그룹이 인 경우 가 로 HLS $ex$ 해석됩니다m3u8.

$

$$

이름 수정자

세그먼트 수정자

이스케이프된 $.

예제:

다음 값을 제공한다고 가정해 보세요.

  • 입력 파일 이름: file1.mp4

  • 대상: s3://amzn-s3-demo-bucket/

  • 이름 수정자: my-video$$hi-res-

출력 파일 이름과 경로는 s3://amzn-s3-demo-bucket/my-video$hi-res-file1.mp4가 됩니다.

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

형식 식별자라고도 하는 작업 설정의 변수는 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 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자리 세그먼트 번호 부여를 사용합니다.

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

  • 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 Elemental은 다음과 같이 SegmentTemplate 요소 startNumber 내부에 duration 및 를 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입니다.

매니페스트에서 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을 추가합니다.

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

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

참고

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