Jobs - Get
Get Job
작업을 가져옵니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}/jobs/{jobName}?api-version=2022-07-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
Media Services 계정 이름입니다. |
job
|
path | True |
string |
작업 이름입니다. |
resource
|
path | True |
string |
Azure 구독 내 리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독의 고유 식별자입니다. |
transform
|
path | True |
string |
변환 이름입니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
Other Status Codes |
자세한 오류 정보입니다. |
예제
Get a Job by name
샘플 요청
샘플 응답
{
"name": "job1",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/exampleTransform/jobs/job1",
"type": "Microsoft.Media/mediaservices/transforms/jobs",
"properties": {
"created": "2021-06-01T00:00:00Z",
"state": "Queued",
"input": {
"@odata.type": "#Microsoft.Media.JobInputs",
"inputs": [
{
"@odata.type": "#Microsoft.Media.JobInputAsset",
"files": [],
"inputDefinitions": [],
"assetName": "job1-InputAsset"
}
]
},
"lastModified": "2021-06-01T00:00:00Z",
"outputs": [
{
"@odata.type": "#Microsoft.Media.JobOutputAsset",
"state": "Queued",
"progress": 0,
"label": "example-custom-label",
"assetName": "job1-OutputAsset"
}
],
"priority": "Low",
"correlationData": {}
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2021-06-01T00:00:00Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-06-01T00:00:00Z"
}
}
정의
Name | Description |
---|---|
Aac |
AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다. |
Aac |
AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다. |
Absolute |
클립 시간을 미디어 파일의 절대 시간 위치로 지정합니다. 절대 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다. |
Analysis |
비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 이 구성 요소 사용 비용을 줄일 수도 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다. |
Attribute |
트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다. |
Audio |
모든 오디오 코덱에 대한 공통 속성을 정의합니다. |
Audio |
수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다. |
Audio |
Audio Analyzer 사전 설정은 음성 전사를 포함하여 미리 정의된 AI 기반 분석 작업 집합을 적용합니다. 현재 미리 설정은 단일 오디오 트랙을 사용하여 콘텐츠를 처리하도록 지원합니다. |
Audio |
오디오 오버레이의 속성을 설명합니다. |
Audio |
오디오 트랙을 선택하는 TrackSelection입니다. |
Blur |
흐림 유형 |
Built |
표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다. |
Channel |
단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다. |
Complexity |
속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 인코딩 속도가 빠르지만 압축 효율성이 낮을 경우 복잡성을 속도로 설정합니다. |
Copy |
입력 오디오 비트 스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다. |
Copy |
다시 인코딩하지 않고 입력 비디오 비트스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다. |
created |
리소스를 만든 ID 유형입니다. |
DDAudio |
Dolby AC3(디지털 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다. Dolby Digital Audio 지원에 대한 현재 구현은 1((모노), 2(스테레오), 6(5.1side)의 오디오 채널 번호입니다. 오디오 샘플링 빈도: 32K/44.1K/48KHz; AC3 사양에서 지원하는 오디오 비트 전송률 값: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps. |
Deinterlace |
인터레이스 해제 설정에 대해 설명합니다. |
Deinterlace |
디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다. |
Deinterlace |
인터레이스 해제에 대한 필드 패리티이며 기본값은 Auto입니다. |
Encoder |
비디오 인코딩에 사용할 기본 제공 사전 설정입니다. |
Entropy |
이 계층에 사용할 엔트로피 모드입니다. 지정하지 않으면 인코더는 프로필 및 수준에 적합한 모드를 선택합니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Face |
존재하는 모든 얼굴을 감지(선택적으로 수정)하기 위해 비디오를 분석할 때 사용할 모든 설정을 설명합니다. |
Face |
이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다. |
Fade |
입력 미디어에 적용되는 페이드 효과의 속성을 설명합니다. |
Filters |
인코딩하기 전에 입력 미디어에 적용할 인터레이싱 해제, 회전 등과 같은 모든 필터링 작업에 대해 설명합니다. |
From |
IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 모든 파일을 검색하는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용되어 입력 파일 집합에서 단일 트랙을 선택할 수 있습니다. |
From |
IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 각 입력 파일을 보는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용하여 지정된 각 파일에서 트랙을 선택합니다. |
H264Complexity |
인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다. |
H264Layer |
H.264 비디오 코덱을 사용하여 입력 비디오를 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정을 설명합니다. |
H264Rate |
비디오 속도 제어 모드 |
H264Video |
H.264 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다. |
H264Video |
현재 기준, 기본, 높음, High422, High444를 지원합니다. 기본값은 Auto입니다. |
H265Complexity |
인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다. |
H265Layer |
입력 비디오를 H.265 비디오 코덱을 사용하여 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정에 대해 설명합니다. |
H265Video |
H.265 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다. |
H265Video |
현재 Main을 지원합니다. 기본값은 Auto입니다. |
Image |
입력 비디오에서 썸네일을 생성하기 위한 기본 속성에 대해 설명합니다. |
Image |
출력 이미지 파일의 속성을 설명합니다. |
Input |
단일 파일에 대한 InputDefinition입니다. TrackSelections의 범위는 지정된 파일로 지정됩니다. |
Insights |
서비스에서 생성하려는 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오로만 필요한 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용일 것으로 예상하는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건에서 작업이 오류 발생합니다. |
Interleave |
오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다. |
Job |
작업 리소스 유형입니다. 진행률 및 상태는 작업을 폴링하거나 EventGrid를 사용하여 이벤트를 구독하여 얻을 수 있습니다. |
Job |
JobOutput 오류에 대한 세부 정보입니다. |
Job |
오류 분류에 도움이 됩니다. |
Job |
오류를 설명하는 오류 코드입니다. |
Job |
JobOutput 오류에 대한 세부 정보입니다. |
Job |
작업에 입력할 자산을 나타냅니다. |
Job |
작업의 입력 파일을 나타냅니다. |
Job |
HTTPS 작업 입력을 나타냅니다. |
Job |
작업에 대한 입력 목록을 설명합니다. |
Job |
시퀀스에는 각 클립이 JobInput인 정렬된 클립 목록이 포함됩니다. 시퀀스는 단일 입력으로 처리됩니다. |
Job |
JobOutput으로 사용되는 자산을 나타냅니다. |
Job |
작업을 다시 시도할 수 있음을 나타냅니다. 재시도에 실패하면 Azure Portal을 통해 Azure 지원 문의하세요. |
Job |
JobOutput의 상태를 설명합니다. |
Jpg |
JPEG 썸네일을 생성하기 위한 설정에 대해 설명합니다. |
Jpg |
입력 비디오에서 일련의 JPEG 이미지를 생성하기 위한 속성에 대해 설명합니다. |
Jpg |
입력 비디오에서 JPEG 이미지를 생성하는 설정을 설명합니다. |
Mp4Format |
출력 ISO MP4 파일의 속성을 설명합니다. |
Multi |
GOP 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다. |
Output |
생성된 출력 파일을 나타냅니다. |
Png |
PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다. |
Png |
입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다. |
Png |
입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다. |
Preset |
인코더에 대한 선택적 구성 설정의 개체입니다. |
Priority |
Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다. |
Rectangle |
입력 미디어를 처리하기 전에 입력 미디어에 적용된 사각형 창의 속성을 설명합니다. |
Rotation |
인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다. |
Select |
특성 및 특성 필터를 지정하여 입력에서 오디오 트랙을 선택합니다. |
Select |
트랙 식별자를 지정하여 입력에서 오디오 트랙을 선택합니다. |
Select |
특성 및 특성 필터를 지정하여 입력에서 비디오 트랙을 선택합니다. |
Select |
트랙 식별자를 지정하여 입력에서 비디오 트랙을 선택합니다. |
Standard |
표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다. |
Stretch |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
Track |
트랙을 필터링할 TrackAttribute입니다. |
Transport |
MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다. |
Utc |
클립 시간을 미디어 파일의 Utc 시간 위치로 지정합니다. Utc 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다. |
Video |
입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다. |
Video |
오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다. |
Video |
비디오 오버레이의 속성을 설명합니다. |
Video |
비디오 동기화 모드 |
Video |
비디오 트랙을 선택하는 TrackSelection입니다. |
AacAudio
AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
bitrate |
integer |
출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다. |
channels |
integer |
오디오의 채널 수입니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
profile |
AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다. |
|
samplingRate |
integer |
Hertz의 인코딩에 사용할 샘플링 속도입니다. |
AacAudioProfile
AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다.
Name | 형식 | Description |
---|---|---|
AacLc |
string |
출력 오디오를 AAC-LC(낮은 복잡성 프로필)로 인코딩하도록 지정합니다. |
HeAacV1 |
string |
출력 오디오를 HE-AAC v1 프로필로 인코딩하도록 지정합니다. |
HeAacV2 |
string |
출력 오디오를 HE-AAC v2 프로필로 인코딩하도록 지정합니다. |
AbsoluteClipTime
클립 시간을 미디어 파일의 절대 시간 위치로 지정합니다. 절대 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
time |
string |
입력 미디어의 타임라인 시간 위치입니다. 일반적으로 ISO8601 기간으로 지정됩니다. 예: 30초 동안 PT30S. |
AnalysisResolution
비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 이 구성 요소 사용 비용을 줄일 수도 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다.
Name | 형식 | Description |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
string |
AttributeFilter
트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다.
Name | 형식 | Description |
---|---|---|
All |
string |
모든 트랙이 포함됩니다. |
Bottom |
string |
특성이 오름차순으로 정렬될 때 첫 번째 트랙이 포함됩니다. 일반적으로 가장 작은 비트 전송률을 선택하는 데 사용됩니다. |
Top |
string |
특성이 내림차순으로 정렬될 때 첫 번째 트랙이 포함됩니다. 일반적으로 가장 큰 비트 전송률을 선택하는 데 사용됩니다. |
ValueEquals |
string |
지정된 값과 동일한 특성을 가진 모든 트랙이 포함됩니다. |
Audio
모든 오디오 코덱에 대한 공통 속성을 정의합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
bitrate |
integer |
출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다. |
channels |
integer |
오디오의 채널 수입니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
samplingRate |
integer |
hertz의 인코딩에 사용할 샘플링 속도입니다. |
AudioAnalysisMode
수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다.
Name | 형식 | Description |
---|---|---|
Basic |
string |
이 모드는 음성-텍스트 변환 전사 및 VTT 자막/캡션 파일 생성을 수행합니다. 이 모드의 출력에는 키워드, 기록, 타이밍 정보만 포함된 Insights JSON 파일이 포함됩니다. 자동 언어 감지 기능과 화자 분할 기능은 이 모드에 포함되어 있지 않습니다. |
Standard |
string |
기본 모드에 포함된 모든 작업을 수행하고 언어 감지 및 화자 일기화를 추가로 수행합니다. |
AudioAnalyzerPreset
Audio Analyzer 사전 설정은 음성 전사를 포함하여 미리 정의된 AI 기반 분석 작업 집합을 적용합니다. 현재 미리 설정은 단일 오디오 트랙을 사용하여 콘텐츠를 처리하도록 지원합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
audioLanguage |
string |
BCP-47 형식의 'language tag-region'(예: 'en-US')을 사용하여 입력의 오디오 페이로드에 대한 언어입니다. 콘텐츠의 언어를 알고 있는 경우 해당 언어를 지정하는 것이 좋습니다. 자동 언어 검색은 기본 모드에 포함되지 않으므로 AudioAnalysisMode::Basic에 대해 언어를 명시적으로 지정해야 합니다. 언어가 지정되지 않았거나 Null로 설정된 경우 자동 언어 검색이 첫 번째 검색된 언어를 선택하고 파일의 지속시간 동안 선택된 언어로 처리합니다. 현재 첫 번째 언어가 검색된 후 언어 간에 동적으로 전환하는 기능은 지원되지 않습니다. 자동 검색은 명확하게 식별 가능한 음성을 사용하여 오디오 녹음에 가장 적합합니다. 자동 검색에서 언어를 찾지 못하면 전사가 'en-US'로 대체됩니다." 지원되는 언어 목록은 여기에서 확인할 수 있습니다. https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전 |
mode |
수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다. |
AudioOverlay
오디오 오버레이의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
audioGainLevel |
number |
오버레이의 게인 오디오 수준입니다. 값은 [0, 1.0] 범위에 있어야 합니다. 기본값은 1.0입니다. |
end |
string |
오버레이가 끝나는 입력 비디오를 참조하는 끝 위치입니다. 값은 ISO 8601 형식이어야 합니다. 예를 들어 PT30S는 입력 비디오로 30초 동안 오버레이를 종료합니다. 지정하지 않았거나 값이 입력 비디오 기간보다 크면 오버레이 미디어 기간이 입력 비디오 기간보다 크면 입력 비디오가 끝날 때까지 오버레이가 적용되고, 그렇지 않으면 오버레이 미디어 기간만큼 오버레이가 지속됩니다. |
fadeInDuration |
string |
오버레이가 입력 비디오로 페이드 인되는 기간입니다. 값은 ISO 8601 기간 형식이어야 합니다. 지정하지 않으면 기본 동작은 페이드 인(PT0S와 동일)이 없는 것입니다. |
fadeOutDuration |
string |
오버레이가 입력 비디오에서 페이드 아웃되는 기간입니다. 값은 ISO 8601 기간 형식이어야 합니다. 지정하지 않으면 기본 동작은 페이드 아웃(PT0S와 동일)이 없는 것입니다. |
inputLabel |
string |
오버레이로 사용할 작업 입력의 레이블입니다. 입력은 정확히 하나의 파일을 지정해야 합니다. 이미지 파일은 JPG, PNG, GIF 또는 BMP 형식 또는 오디오 파일(예: WAV, MP3, WMA, M4A 파일) 또는 비디오 파일에 지정할 수 있습니다. 지원되는 오디오 및 비디오 파일 형식의 전체 목록은 를 참조 https://aka.ms/mesformats 하세요. |
start |
string |
오버레이가 시작되는 입력 비디오를 참조하는 시작 위치입니다. 값은 ISO 8601 형식이어야 합니다. 예를 들어 PT05S는 입력 비디오에 5초 동안 오버레이를 시작합니다. 지정하지 않으면 오버레이가 입력 비디오의 시작 부분에서 시작됩니다. |
AudioTrackDescriptor
오디오 트랙을 선택하는 TrackSelection입니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
channelMapping |
단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다. |
BlurType
흐림 유형
Name | 형식 | Description |
---|---|---|
Black |
string |
검은색: 차단 필터 |
Box |
string |
상자: 디버그 필터, 경계 상자만 |
High |
string |
높음: 흐림 효과 필터 혼동 |
Low |
string |
낮음: 박스카 흐림 필터 |
Med |
string |
메드: 가우스 흐림 필터 |
BuiltInStandardEncoderPreset
표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
configurations |
인코더에 대한 선택적 구성 설정입니다. 구성은 ContentAwareEncoding 및 H265ContentAwareEncoding BuiltInStandardEncoderPreset에 대해서만 지원됩니다. |
|
presetName |
비디오 인코딩에 사용할 기본 제공 사전 설정입니다. |
ChannelMapping
단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다.
Name | 형식 | Description |
---|---|---|
BackLeft |
string |
왼쪽 뒤 채널입니다. 왼쪽 서라운드 채널이라고도 합니다. |
BackRight |
string |
오른쪽 뒤 채널입니다. 오른쪽 서라운드 채널이라고도 합니다. |
Center |
string |
가운데 채널입니다. |
FrontLeft |
string |
왼쪽 앞 채널입니다. |
FrontRight |
string |
오른쪽 앞 채널입니다. |
LowFrequencyEffects |
string |
빈도가 낮은 효과 채널입니다. 하위우퍼라고도 합니다. |
StereoLeft |
string |
왼쪽 스테레오 채널입니다. 다운 믹스 레프트라고도 합니다. |
StereoRight |
string |
오른쪽 스테레오 채널입니다. 다운 믹스 오른쪽이라고도 합니다. |
Complexity
속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 인코딩 속도가 빠르지만 압축 효율성이 낮을 경우 복잡성을 속도로 설정합니다.
Name | 형식 | Description |
---|---|---|
Balanced |
string |
속도와 품질 간의 균형을 맞추는 설정을 사용하도록 인코더를 구성합니다. |
Quality |
string |
전체 인코딩 시간이 느려지도록 최적화된 설정을 사용하여 더 높은 품질의 출력을 생성하도록 인코더를 구성합니다. |
Speed |
string |
더 빠른 인코딩에 최적화된 설정을 사용하도록 인코더를 구성합니다. 인코딩 시간을 줄이기 위해 품질이 희생됩니다. |
CopyAudio
입력 오디오 비트 스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
CopyVideo
다시 인코딩하지 않고 입력 비디오 비트스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
createdByType
리소스를 만든 ID 유형입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DDAudio
Dolby AC3(디지털 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다. Dolby Digital Audio 지원에 대한 현재 구현은 1((모노), 2(스테레오), 6(5.1side)의 오디오 채널 번호입니다. 오디오 샘플링 빈도: 32K/44.1K/48KHz; AC3 사양에서 지원하는 오디오 비트 전송률 값: 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 320000, 384000, 448000, 512000, 576000, 640000 bps.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
bitrate |
integer |
출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다. |
channels |
integer |
오디오의 채널 수입니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
samplingRate |
integer |
Hertz의 인코딩에 사용할 샘플링 속도입니다. |
Deinterlace
인터레이스 해제 설정에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
mode |
디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다. |
|
parity |
인터레이스 해제에 대한 필드 패리티이며 기본값은 Auto입니다. |
DeinterlaceMode
디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다.
Name | 형식 | Description |
---|---|---|
AutoPixelAdaptive |
string |
입력 비디오의 각 프레임에 자동 픽셀 적응 해제 인터레이싱을 적용합니다. |
Off |
string |
원본 비디오의 인터레이스 해제를 사용하지 않도록 설정합니다. |
DeinterlaceParity
인터레이스 해제에 대한 필드 패리티이며 기본값은 Auto입니다.
Name | 형식 | Description |
---|---|---|
Auto |
string |
필드 순서 자동 검색 |
BottomFieldFirst |
string |
입력 비디오의 맨 아래 필드 첫 번째 처리를 적용합니다. |
TopFieldFirst |
string |
입력 비디오의 맨 위 필드 첫 번째 처리를 적용합니다. |
EncoderNamedPreset
비디오 인코딩에 사용할 기본 제공 사전 설정입니다.
Name | 형식 | Description |
---|---|---|
AACGoodQualityAudio |
string |
192kbps로 인코딩된 AAC 스테레오 오디오만 포함하는 단일 MP4 파일을 생성합니다. |
AdaptiveStreaming |
string |
H.264 비디오 및 스테레오 AAC 오디오를 사용하여 GOP 정렬 MP4 파일 집합을 생성합니다. 입력, 해상도, 비트 전송률 및 프레임 속도를 기준으로 비트 전송률 사다리를 자동 생성합니다. 자동 생성된 사전 설정은 입력 해상도를 초과하지 않습니다. 예를 들어 입력이 720p일 때 출력은 아무리 높아도 720p로 유지됩니다. |
ContentAwareEncoding |
string |
콘텐츠 인식 인코딩을 사용하여 GOP 맞춤 MP4 세트를 생성합니다. 입력 콘텐츠에 따라 서비스가 입력 콘텐츠의 초기 경량 분석을 수행하고 그 결과를 사용하여 적응 스트리밍으로 전송을 위해 최적 레이어 수, 적합한 비트 전송률 및 해상도 설정을 결정합니다. 이 사전 설정은 출력 파일이 낮은 비트 전송률로 제공되지만 시청자에게 여전히 좋은 경험을 제공하는 품질로 유지되는 낮은 품질 및 중간 품질의 복합 비디오에 특히 효과적입니다. 출력에는 비디오 및 오디오가 인터리브된 MP4 파일이 포함됩니다. |
ContentAwareEncodingExperimental |
string |
콘텐츠 인식 인코딩을 위한 실험적 사전 설정을 노출합니다. 입력 콘텐츠가 있는 경우 서비스는 적응 스트리밍을 통해 배달을 위한 최적의 계층 수, 적절한 비트 전송률 및 해상도 설정을 자동으로 결정하려고 시도합니다. 기본 알고리즘은 시간에 따라 계속 발전합니다. 출력에는 비디오 및 오디오가 인터리브된 MP4 파일이 포함됩니다. |
CopyAllBitrateNonInterleaved |
string |
입력 자산의 모든 동영상 및 오디오 스트림을 인터리브되지 않은 동영상 및 오디오 출력 파일로 복사합니다. 이 사전 설정을 사용하여 기존 자산을 자르거나 GOP(키 프레임) 정렬 MP4 파일 그룹을 스트리밍할 수 있는 자산으로 변환할 수 있습니다. |
DDGoodQualityAudio |
string |
192kbps로 인코딩된 DD(Digital Dolby) 스테레오 오디오만 포함하는 단일 MP4 파일을 생성합니다. |
H264MultipleBitrate1080p |
string |
6000kbps에서 400kbps, 스테레오 AAC 오디오에 이르는 8개의 GOP 정렬 MP4 파일 집합을 생성합니다. 해상도는 1080p에서 시작하여 180p로 내려갑니다. |
H264MultipleBitrate720p |
string |
3400kbps에서 400kbps, 스테레오 AAC 오디오에 이르는 6개의 GOP 정렬 MP4 파일 집합을 생성합니다. 해상도는 720p에서 시작하여 180p로 내려갑니다. |
H264MultipleBitrateSD |
string |
1900kbps에서 400kbps에 이르는 5개의 GOP 정렬 MP4 파일 집합과 스테레오 AAC 오디오를 생성합니다. 해상도는 480p에서 시작하여 240p로 내려갑니다. |
H264SingleBitrate1080p |
string |
비디오가 6750kbps의 H.264 코덱과 1080픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다. |
H264SingleBitrate720p |
string |
비디오가 4500kbps의 H.264 코덱과 720픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다. |
H264SingleBitrateSD |
string |
비디오가 2200kbps의 H.264 코덱과 480픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다. |
H265AdaptiveStreaming |
string |
H.265 비디오 및 스테레오 AAC 오디오가 포함된 GOP 정렬 MP4 파일 집합을 만듭니다. 입력, 해상도, 비트 전송률 및 프레임 속도를 기준으로 비트 전송률 사다리를 자동 생성합니다. 자동 생성된 사전 설정은 입력 해상도를 초과하지 않습니다. 예를 들어 입력이 720p일 때 출력은 아무리 높아도 720p로 유지됩니다. |
H265ContentAwareEncoding |
string |
콘텐츠 인식 인코딩을 사용하여 GOP 맞춤 MP4 세트를 생성합니다. 입력 콘텐츠에 따라 서비스가 입력 콘텐츠의 초기 경량 분석을 수행하고 그 결과를 사용하여 적응 스트리밍으로 전송을 위해 최적 레이어 수, 적합한 비트 전송률 및 해상도 설정을 결정합니다. 이 사전 설정은 출력 파일이 낮은 비트 전송률로 제공되지만 시청자에게 여전히 좋은 경험을 제공하는 품질로 유지되는 낮은 품질 및 중간 품질의 복합 비디오에 특히 효과적입니다. 출력에는 비디오 및 오디오가 인터리브된 MP4 파일이 포함됩니다. |
H265SingleBitrate1080p |
string |
비디오가 3500kbps의 H.265 코덱과 1080픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다. |
H265SingleBitrate4K |
string |
비디오가 9500kbps의 H.265 코덱과 2160픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다. |
H265SingleBitrate720p |
string |
비디오가 1800kbps의 H.265 코덱과 720픽셀의 그림 높이로 인코딩되고 스테레오 오디오가 128kbps의 AAC-LC 코덱으로 인코딩되는 MP4 파일을 생성합니다. |
EntropyMode
이 계층에 사용할 엔트로피 모드입니다. 지정하지 않으면 인코더는 프로필 및 수준에 적합한 모드를 선택합니다.
Name | 형식 | Description |
---|---|---|
Cabac |
string |
컨텍스트 CABAC(Adaptive Binary Arithmetic Coder) 엔트로피 인코딩. |
Cavlc |
string |
컨텍스트 CAVLC(적응 변수 길이 코더) 엔트로피 인코딩. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
FaceDetectorPreset
존재하는 모든 얼굴을 감지(선택적으로 수정)하기 위해 비디오를 분석할 때 사용할 모든 설정을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
blurType |
흐림 유형 |
|
experimentalOptions |
object |
사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전 |
mode |
이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다. |
|
resolution |
비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 이 구성 요소 사용 비용을 줄일 수도 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다. |
FaceRedactorMode
이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다.
Name | 형식 | Description |
---|---|---|
Analyze |
string |
분석 모드는 얼굴을 감지하고 결과를 사용하여 메타데이터 파일을 출력합니다. Redact 모드에서 얼굴이 흐리게 표시되기 전에 메타데이터 파일을 편집할 수 있습니다. |
Combined |
string |
결합 모드는 분석된 얼굴을 편집하는 것이 바람직하지 않을 때 한 패스로 분석 및 수정 단계를 수행합니다. |
Redact |
string |
수정 모드는 분석 모드에서 메타데이터 파일을 사용하고 찾은 얼굴을 수정합니다. |
Fade
입력 미디어에 적용되는 페이드 효과의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
duration |
string |
비디오의 페이드 효과 기간입니다. 값은 ISO 8601 형식(예: 5초 동안 색을 페이드 인/아웃하는 PT05S) 또는 프레임 수(예: 시작 시간에서 10프레임 페이드하려면 10개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%을 페이드하려면 10%)일 수 있습니다. |
fadeColor |
string |
페이드 인/아웃의 색입니다. CSS Level1 색 https://developer.mozilla.org/en-US/docs/Web/CSS/color_value/color_keywords 또는 RGB/16진수 값(예: rgb(255,0,0), 0xFF0000 또는 #FF0000 |
start |
string |
페이드를 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 기본값은 0입니다. |
Filters
인코딩하기 전에 입력 미디어에 적용할 인터레이싱 해제, 회전 등과 같은 모든 필터링 작업에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
crop |
입력 비디오를 자르는 사각형 창의 매개 변수입니다. |
|
deinterlace |
인터레이싱 해제 설정입니다. |
|
fadeIn |
입력 미디어에 적용된 페이드 효과의 속성을 설명합니다. |
|
fadeOut |
입력 미디어에 적용된 페이드 효과의 속성을 설명합니다. |
|
overlays | Overlay[]: |
입력 비디오에 적용할 오버레이의 속성입니다. 오디오, 이미지 또는 비디오 오버레이일 수 있습니다. |
rotation |
인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다. |
FromAllInputFile
IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 모든 파일을 검색하는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용되어 입력 파일 집합에서 단일 트랙을 선택할 수 있습니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
includedTracks | TrackDescriptor[]: |
입력에서 트랙의 메타데이터 및 선택을 정의하는 TrackDescriptors 목록입니다. |
FromEachInputFile
IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 각 입력 파일을 보는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용하여 지정된 각 파일에서 트랙을 선택합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
includedTracks | TrackDescriptor[]: |
입력에서 트랙의 메타데이터 및 선택을 정의하는 TrackDescriptors 목록입니다. |
H264Complexity
인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다.
Name | 형식 | Description |
---|---|---|
Balanced |
string |
속도와 품질 간의 균형을 이루는 설정을 사용하도록 인코더에 지시합니다. |
Quality |
string |
전체 인코딩 시간이 느려지도록 더 높은 품질의 출력을 생성하도록 최적화된 설정을 사용하도록 인코더에 지시합니다. |
Speed |
string |
더 빠른 인코딩에 최적화된 설정을 사용하도록 인코더에 지시합니다. 인코딩 시간을 줄이기 위해 품질이 저하됩니다. |
H264Layer
H.264 비디오 코덱을 사용하여 입력 비디오를 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정을 설명합니다.
Name | 형식 | Description |
---|---|---|
adaptiveBFrame |
boolean |
이 레이어를 인코딩할 때 적응형 B 프레임을 사용할지 여부입니다. 지정하지 않으면 비디오 프로필에서 사용을 허용할 때마다 인코더가 켜집니다. |
bFrames |
integer |
이 레이어를 인코딩할 때 사용할 B 프레임의 수입니다. 지정하지 않으면 인코더는 비디오 프로필 및 수준에 따라 적절한 숫자를 선택합니다. |
bitrate |
integer |
이 계층을 생성할 때 입력 비디오를 인코딩할 초당 평균 비트 전송률입니다. 이 이름은 반드시 입력해야 합니다. |
bufferWindow |
string |
VBV 버퍼 창 길이입니다. 값은 ISO 8601 형식이어야 합니다. 값은 [0.1-100] 초 범위에 있어야 합니다. 기본값은 5초입니다(예: PT5S). |
crf |
number |
이 계층을 인코딩할 때 사용할 CRF의 값입니다. 이 설정은 비디오 코덱의 RateControlMode가 CRF 모드로 설정된 경우에 적용됩니다. CRF 값의 범위는 0에서 51 사이이며, 값이 낮으면 파일 크기가 높아질수록 품질이 향상됩니다. 값이 높을수록 압축이 늘어나지만, 어느 시점에서 품질 저하가 발견됩니다. 기본값은 23입니다. |
entropyMode |
이 계층에 사용할 엔트로피 모드입니다. 지정하지 않으면 인코더는 프로필 및 수준에 적합한 모드를 선택합니다. |
|
frameRate |
string |
이 계층을 인코딩할 프레임 속도(초당 프레임 수)입니다. 값은 M/N 형식일 수 있습니다. 여기서 M과 N은 정수(예: 30000/1001)이거나 숫자 형식(예: 30 또는 29.97)입니다. 인코더는 프로필 및 수준에 따라 허용되는 프레임 속도에 제약 조건을 적용합니다. 지정하지 않으면 인코더는 입력 비디오와 동일한 프레임 속도를 사용합니다. |
height |
string |
이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다. |
label |
string |
다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다. |
level |
string |
현재 수준 최대 6.2를 지원합니다. 값은 자동이거나 H.264 프로필과 일치하는 숫자일 수 있습니다. 지정하지 않으면 기본값은 자동이며, 이를 통해 인코더는 이 계층에 적합한 수준을 선택할 수 있습니다. |
maxBitrate |
integer |
VBV 버퍼를 다시 채우기 위해 가정해야 하는 최대 비트 전송률(초당 비트)입니다. 지정하지 않으면 기본적으로 비트 전송률과 동일한 값으로 설정됩니다. |
profile |
현재 기준, Main, High, High422, High444를 지원합니다. 기본값은 Auto입니다. |
|
referenceFrames |
integer |
이 레이어를 인코딩할 때 사용할 참조 프레임의 수입니다. 지정하지 않으면 인코더는 인코더 복잡성 설정에 따라 적절한 숫자를 결정합니다. |
slices |
integer |
이 레이어를 인코딩할 때 사용할 조각 수입니다. 지정하지 않으면 기본값은 0입니다. 즉, 인코더는 각 프레임에 단일 조각을 사용합니다. |
width |
string |
이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다. |
H264RateControlMode
비디오 속도 제어 모드
Name | 형식 | Description |
---|---|---|
ABR |
string |
대상 비트 전송률에 도달한 ABR(평균 비트 전송률) 모드: 기본 모드입니다. |
CBR |
string |
대상 비트 전송률 주위의 비트 전송률 변형을 강화하는 CBR(상수 비트 전송률) 모드입니다. |
CRF |
string |
일정한 주관적 품질을 대상으로 하는 CRF(상수 비율 비율) 모드입니다. |
H264Video
H.264 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
complexity |
인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다. |
|
keyFrameInterval |
string |
두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
layers |
인코더에서 생성할 출력 H.264 계층의 컬렉션입니다. |
|
rateControlMode |
비디오 속도 제어 모드 |
|
sceneChangeDetection |
boolean |
인코더가 장면 변경 시 키 프레임을 삽입해야 하는지 여부입니다. 지정하지 않으면 기본값은 false입니다. 이 플래그는 인코더가 단일 출력 비디오를 생성하도록 구성된 경우에만 true로 설정해야 합니다. |
stretchMode |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
|
syncMode |
비디오 동기화 모드 |
H264VideoProfile
현재 기준, 기본, 높음, High422, High444를 지원합니다. 기본값은 Auto입니다.
Name | 형식 | Description |
---|---|---|
Auto |
string |
적절한 H.264 프로필을 자동으로 확인하도록 인코더에 지시합니다. |
Baseline |
string |
기준 프로필 |
High |
string |
높은 프로필. |
High422 |
string |
높은 4:2:2 프로필. |
High444 |
string |
높은 4:4:4 예측 프로필. |
Main |
string |
기본 프로필 |
H265Complexity
인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다.
Name | 형식 | Description |
---|---|---|
Balanced |
string |
속도와 품질 간의 균형을 맞추는 설정을 사용하도록 인코더에 지시합니다. |
Quality |
string |
전체 인코딩 시간이 느려지도록 더 높은 품질의 출력을 생성하도록 최적화된 설정을 사용하도록 인코더에 지시합니다. |
Speed |
string |
인코더에 더 빠른 인코딩에 최적화된 설정을 사용하도록 지시합니다. 인코딩 시간을 줄이기 위해 품질이 희생됩니다. |
H265Layer
입력 비디오를 H.265 비디오 코덱을 사용하여 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
adaptiveBFrame |
boolean |
이 레이어를 인코딩할 때 적응형 B 프레임을 사용할지 여부를 지정합니다. 지정하지 않으면 비디오 프로필에서 사용을 허용할 때마다 인코더가 켜집니다. |
bFrames |
integer |
이 레이어를 인코딩할 때 사용할 B 프레임의 수입니다. 지정하지 않으면 인코더는 비디오 프로필 및 수준에 따라 적절한 숫자를 선택합니다. |
bitrate |
integer |
이 계층을 생성할 때 입력 비디오를 인코딩할 초당 평균 비트 전송률입니다. 예를 들어 대상 비트 전송률이 3000Kbps 또는 3Mbps이면 이 값이 30000000이어야 합니다. 필수 필드입니다. |
bufferWindow |
string |
VBV 버퍼 창 길이입니다. 값은 ISO 8601 형식이어야 합니다. 값은 [0.1-100] 초 범위에 있어야 합니다. 기본값은 5초입니다(예: PT5S). |
crf |
number |
이 계층을 인코딩할 때 사용할 CRF의 값입니다. 이 설정은 비디오 코덱의 RateControlMode가 CRF 모드로 설정된 경우에 적용됩니다. CRF 값의 범위는 0에서 51 사이이며, 값이 낮으면 파일 크기가 높아질수록 품질이 향상됩니다. 값이 높을수록 압축이 늘어나지만, 어느 시점에서 품질 저하가 발견됩니다. 기본값은 28입니다. |
frameRate |
string |
이 계층을 인코딩할 프레임 속도(초당 프레임 수)입니다. 값은 M/N 형식일 수 있습니다. 여기서 M과 N은 정수(예: 30000/1001)이거나 숫자 형식(예: 30 또는 29.97)입니다. 인코더는 프로필 및 수준에 따라 허용되는 프레임 속도에 제약 조건을 적용합니다. 지정하지 않으면 인코더는 입력 비디오와 동일한 프레임 속도를 사용합니다. |
height |
string |
이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다. |
label |
string |
다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다. |
level |
string |
현재 수준 최대 6.2를 지원합니다. 값은 자동이거나 H.265 프로필과 일치하는 숫자일 수 있습니다. 지정하지 않으면 기본값은 Auto이며, 인코더가 이 계층에 적합한 수준을 선택할 수 있습니다. |
maxBitrate |
integer |
VBV 버퍼를 다시 채우기 위해 가정해야 하는 최대 비트 전송률(초당 비트)입니다. 지정하지 않으면 기본적으로 비트 전송률과 동일한 값으로 설정됩니다. |
profile |
현재 Main을 지원합니다. 기본값은 Auto입니다. |
|
referenceFrames |
integer |
이 레이어를 인코딩할 때 사용할 참조 프레임의 수입니다. 지정하지 않으면 인코더는 인코더 복잡성 설정에 따라 적절한 숫자를 결정합니다. |
slices |
integer |
이 레이어를 인코딩할 때 사용할 조각 수입니다. 지정하지 않으면 기본값은 0입니다. 즉, 인코더는 각 프레임에 단일 조각을 사용합니다. |
width |
string |
이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다. |
H265Video
H.265 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
complexity |
인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다. |
|
keyFrameInterval |
string |
두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
layers |
인코더에서 생성할 출력 H.265 계층의 컬렉션입니다. |
|
sceneChangeDetection |
boolean |
인코더가 장면 변경 시 키 프레임을 삽입해야 하는지 여부를 지정합니다. 지정하지 않으면 기본값은 false입니다. 이 플래그는 인코더가 단일 출력 비디오를 생성하도록 구성된 경우에만 true로 설정해야 합니다. |
stretchMode |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
|
syncMode |
비디오 동기화 모드 |
H265VideoProfile
현재 Main을 지원합니다. 기본값은 Auto입니다.
Name | 형식 | Description |
---|---|---|
Auto |
string |
적절한 H.265 프로필을 자동으로 확인하도록 인코더에 지시합니다. |
Main |
string |
주 프로필(https://x265.readthedocs.io/en/default/cli.html?highlight=profile#profile-level-tier) |
Main10 |
string |
기본 10 프로필(https://en.wikipedia.org/wiki/High_Efficiency_Video_Coding#Main_10) |
Image
입력 비디오에서 썸네일을 생성하기 위한 기본 속성에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
keyFrameInterval |
string |
두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
range |
string |
미리 보기 생성을 중지할 입력 비디오에서 미리 설정된 변환 시작 시간을 기준으로 하는 위치입니다. 값은 ISO 8601 형식(예: 시작 시간에서 5분 30초에 중지하는 PT5M30S) 또는 프레임 수(예: 시작 시 프레임의 300번째 프레임에서 중지하려면 300)일 수 있습니다. 이 값이 1이면 시작 시간에 썸네일 하나만 생성하거나 스트림 기간에 대한 상대 값(예: 시작 시간부터 스트림 기간의 절반에서 중지하는 50%)을 의미합니다. 기본값은 100%로, 스트리밍 끝부분에서 중지함을 의미합니다. |
start |
string |
썸네일 생성을 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 또한 인코더가 비디오의 처음 몇 초에서 최상의 썸네일을 선택하고, 단계와 범위에 대한 다른 설정에 관계없이 하나의 썸네일만 생성하도록 지시하는 {Best} 매크로를 지원합니다. 기본값은 {Best} 매크로입니다. |
step |
string |
썸네일이 생성되는 간격입니다. 값은 ISO 8601 형식(예: 5초마다 한 이미지의 경우 PT05S) 또는 프레임 수(예: 30프레임마다 하나의 이미지에 대해 30개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%마다 한 이미지의 경우 10%)일 수 있습니다. 참고: 단계 값은 처음 생성된 축소판 그림에 영향을 줍니다. 이는 변환 사전 설정 시작 시간에 지정된 것과 정확히 일치하지 않을 수 있습니다. 이는 시작 시간과 시작 시간의 단계 위치 간에 가장 적합한 썸네일을 첫 번째 출력으로 선택하려고 하는 인코더 때문입니다. 기본값은 10%이므로 스트림의 기간이 길면 처음 생성된 축소판 그림이 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 가깝게 예상되는 경우 Step에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 1로 설정합니다. |
stretchMode |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
|
syncMode |
비디오 동기화 모드 |
ImageFormat
출력 이미지 파일의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filenamePattern |
string |
출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
InputFile
단일 파일에 대한 InputDefinition입니다. TrackSelections의 범위는 지정된 파일로 지정됩니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filename |
string |
이 입력 정의가 적용되는 파일의 이름입니다. |
includedTracks | TrackDescriptor[]: |
입력에서 트랙의 메타데이터 및 선택을 정의하는 TrackDescriptors 목록입니다. |
InsightsType
서비스에서 생성하려는 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오로만 필요한 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용일 것으로 예상하는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건에서 작업이 오류 발생합니다.
Name | 형식 | Description |
---|---|---|
AllInsights |
string |
오디오 및 비디오 인사이트를 모두 생성합니다. 오디오 또는 비디오 인사이트가 실패하면 실패합니다. |
AudioInsightsOnly |
string |
오디오 전용 인사이트를 생성합니다. 있는 경우에도 비디오를 무시합니다. 오디오가 없으면 실패합니다. |
VideoInsightsOnly |
string |
비디오 전용 인사이트를 생성합니다. 있는 경우 오디오를 무시합니다. 비디오가 없으면 실패합니다. |
InterleaveOutput
오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다.
Name | 형식 | Description |
---|---|---|
InterleavedOutput |
string |
출력에는 오디오와 비디오가 모두 포함됩니다. |
NonInterleavedOutput |
string |
출력은 비디오 전용 또는 오디오 전용입니다. |
Job
작업 리소스 유형입니다. 진행률 및 상태는 작업을 폴링하거나 EventGrid를 사용하여 이벤트를 구독하여 얻을 수 있습니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
리소스의 이름입니다. |
properties.correlationData |
object |
고객이 제공한 키, Job 및 JobOutput 상태 이벤트에서 반환될 값 쌍입니다. |
properties.created |
string |
고객이 작업을 만든 UTC 날짜 및 시간('YYYY-MM-DDThh:mm:ssZ' 형식)입니다. |
properties.description |
string |
고객이 선택 사항으로 제공하는 작업 설명입니다. |
properties.endTime |
string |
이 작업이 처리를 완료한 UTC 날짜 및 시간입니다. |
properties.input | JobInput: |
작업에 대한 입력입니다. |
properties.lastModified |
string |
고객이 마지막으로 작업을 업데이트한 UTC 날짜 및 시간('YYYY-MM-DDThh:mm:ssZ' 형식)입니다. |
properties.outputs | JobOutput[]: |
작업에 대한 출력입니다. |
properties.priority |
작업을 처리해야 하는 우선 순위입니다. 우선 순위가 높은 작업은 우선 순위가 낮은 작업보다 먼저 처리됩니다. 설정하지 않은 경우 기본값은 보통입니다. |
|
properties.startTime |
string |
이 작업이 처리를 시작한 UTC 날짜 및 시간입니다. |
properties.state |
작업의 현재 상태입니다. |
|
systemData |
이 리소스와 관련된 시스템 메타데이터입니다. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
JobError
JobOutput 오류에 대한 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
category |
오류 분류에 도움이 됩니다. |
|
code |
오류를 설명하는 오류 코드입니다. |
|
details |
이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다. |
|
message |
string |
사람이 읽을 수 있는 언어 종속적 오류 표현입니다. |
retry |
작업을 다시 시도할 수 있음을 나타냅니다. 재시도에 실패하면 Azure Portal을 통해 Azure 지원 문의하세요. |
JobErrorCategory
오류 분류에 도움이 됩니다.
Name | 형식 | Description |
---|---|---|
Account |
string |
오류는 계정 정보와 관련이 있습니다. |
Configuration |
string |
오류는 구성과 관련이 있습니다. |
Content |
string |
오류는 입력 파일의 데이터와 관련이 있습니다. |
Download |
string |
오류는 다운로드와 관련이 있습니다. |
Service |
string |
오류는 서비스 관련입니다. |
Upload |
string |
업로드 관련 오류입니다. |
JobErrorCode
오류를 설명하는 오류 코드입니다.
Name | 형식 | Description |
---|---|---|
ConfigurationUnsupported |
string |
입력 파일과 적용된 구성 설정의 조합에 문제가 발생했습니다. 구성 설정을 수정하고 동일한 입력으로 다시 시도하거나 구성과 일치하도록 입력을 변경합니다. |
ContentMalformed |
string |
입력 파일에 검사 입력 콘텐츠(예: 0 바이트 파일 또는 손상/디코딩할 수 없는 파일)에 문제가 있었습니다. |
ContentUnsupported |
string |
입력 파일의 유효성을 검사 입력 형식(유효한 미디어 파일이 아니거나 지원되지 않는 파일/코덱)에 문제가 있었습니다. |
DownloadNotAccessible |
string |
입력 파일을 다운로드하는 동안 파일에 액세스할 수 없습니다. 원본의 가용성을 검사. |
DownloadTransientError |
string |
입력 파일을 다운로드하는 동안 전송 중에 문제가 발생했습니다(스토리지 서비스, 네트워크 오류). 세부 정보를 확인하고 원본을 검사. |
IdentityUnsupported |
string |
계정 ID를 확인하는 동안 오류가 발생했습니다. ID 구성을 확인하고 수정하고 다시 시도합니다. 실패하면 지원에 문의하세요. |
ServiceError |
string |
심각한 서비스 오류, 지원에 문의하세요. |
ServiceTransientError |
string |
일시적인 오류입니다. 다시 시도하지 못한 경우 지원에 문의하세요. |
UploadNotAccessible |
string |
출력 파일을 업로드하는 동안 대상에 연결할 수 없습니다. 대상의 가용성을 검사. |
UploadTransientError |
string |
출력 파일을 업로드하는 동안 전송 중에 문제가 발생했습니다(스토리지 서비스, 네트워크 오류) 세부 정보를 확인하고 대상을 검사. |
JobErrorDetail
JobOutput 오류에 대한 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
code |
string |
오류 세부 정보를 설명하는 코드입니다. |
message |
string |
사람이 읽을 수 있는 오류 표현입니다. |
JobInputAsset
작업에 입력할 자산을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
assetName |
string |
입력 자산의 이름입니다. |
end | ClipTime: |
처리가 종료되는 입력 미디어의 타임라인 지점을 정의합니다. 기본값은 입력 미디어의 끝입니다. |
files |
string[] |
파일 목록입니다. JobInputHttp에 필요합니다. 각각 최대 4,000자입니다. 쿼리 문자열은 중요한 데이터 노출을 방지하기 위해 서비스 응답에서 반환되지 않습니다. |
inputDefinitions | InputDefinition[]: |
InputDefinitions 목록을 정의합니다. 각 InputDefinition에 대해 트랙 선택 및 관련 메타데이터 목록을 정의합니다. |
label |
string |
JobInputClip에 할당된 레이블로, 변환에 사용되는 참조를 충족하는 데 사용됩니다. 예를 들어 'xyz' 레이블이 있는 이미지 파일을 가져와서 인코딩하기 전에 입력 비디오에 오버레이로 적용하도록 변환을 작성할 수 있습니다. 작업을 제출할 때 JobInputs 중 정확히 하나는 이미지 파일이어야 하며 레이블 'xyz'가 있어야 합니다. |
start | ClipTime: |
처리가 시작될 입력 미디어의 타임라인 지점을 정의합니다. 기본값은 입력 미디어의 시작 부분으로 설정됩니다. |
JobInputClip
작업의 입력 파일을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
end | ClipTime: |
처리가 종료되는 입력 미디어의 타임라인 지점을 정의합니다. 기본값은 입력 미디어의 끝입니다. |
files |
string[] |
파일 목록입니다. JobInputHttp에 필요합니다. 각각 최대 4,000자입니다. 쿼리 문자열은 중요한 데이터 노출을 방지하기 위해 서비스 응답에서 반환되지 않습니다. |
inputDefinitions | InputDefinition[]: |
InputDefinitions 목록을 정의합니다. 각 InputDefinition에 대해 트랙 선택 및 관련 메타데이터 목록을 정의합니다. |
label |
string |
JobInputClip에 할당된 레이블로, 변환에 사용되는 참조를 충족하는 데 사용됩니다. 예를 들어 'xyz' 레이블이 있는 이미지 파일을 가져와서 인코딩하기 전에 입력 비디오에 오버레이로 적용하도록 변환을 작성할 수 있습니다. 작업을 제출할 때 JobInputs 중 정확히 하나는 이미지 파일이어야 하며 레이블 'xyz'가 있어야 합니다. |
start | ClipTime: |
처리가 시작될 입력 미디어의 타임라인 지점을 정의합니다. 기본값은 입력 미디어의 시작 부분으로 설정됩니다. |
JobInputHttp
HTTPS 작업 입력을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
baseUri |
string |
HTTPS 작업 입력에 대한 기본 URI입니다. 제공된 파일 이름과 연결됩니다. 기본 URI가 제공되지 않으면 제공된 파일 목록은 정규화된 URI로 간주됩니다. 최대 길이는 4,000자입니다. 쿼리 문자열은 중요한 데이터 노출을 방지하기 위해 서비스 응답에 반환되지 않습니다. |
end | ClipTime: |
처리가 종료되는 입력 미디어의 타임라인 지점을 정의합니다. 기본값은 입력 미디어의 끝입니다. |
files |
string[] |
파일 목록입니다. JobInputHttp에 필요합니다. 각각 최대 4,000자입니다. 쿼리 문자열은 중요한 데이터 노출을 방지하기 위해 서비스 응답에 반환되지 않습니다. |
inputDefinitions | InputDefinition[]: |
InputDefinitions 목록을 정의합니다. 각 InputDefinition에 대해 트랙 선택 및 관련 메타데이터 목록을 정의합니다. |
label |
string |
변환에 사용되는 참조를 충족하는 데 사용되는 JobInputClip에 할당된 레이블입니다. 예를 들어 'xyz' 레이블이 있는 이미지 파일을 가져와서 인코딩하기 전에 입력 비디오에 오버레이로 적용하도록 변환을 작성할 수 있습니다. 작업을 제출할 때 JobInputs 중 정확히 하나는 이미지 파일이어야 하며 레이블 'xyz'가 있어야 합니다. |
start | ClipTime: |
처리가 시작될 입력 미디어의 타임라인 지점을 정의합니다. 기본적으로 입력 미디어의 시작 부분으로 설정됩니다. |
JobInputs
작업에 대한 입력 목록을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
inputs | JobInput[]: |
작업에 대한 입력 목록입니다. |
JobInputSequence
시퀀스에는 각 클립이 JobInput인 정렬된 클립 목록이 포함됩니다. 시퀀스는 단일 입력으로 처리됩니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
inputs | JobInputClip[]: |
타임라인 구성하는 JobInputs입니다. |
JobOutputAsset
JobOutput으로 사용되는 자산을 나타냅니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
assetName |
string |
출력 자산의 이름입니다. |
endTime |
string |
이 작업 출력이 처리를 완료한 UTC 날짜 및 시간입니다. |
error |
JobOutput이 오류 상태이면 오류의 세부 정보가 포함됩니다. |
|
label |
string |
고유하게 식별할 수 있도록 JobOutput에 할당된 레이블입니다. 이 기능은 Transform에 두 개 이상의 TransformOutput이 있는 경우 유용합니다. 그러면 작업에 둘 이상의 JobOutput이 있습니다. 이러한 경우 작업을 제출할 때 Transform의 TransformOutputs와 동일한 순서로 두 개 이상의 JobOutputs를 추가합니다. 그런 다음 이벤트 또는 GET 요청을 통해 작업을 검색할 때 레이블을 사용하여 JobOutput을 쉽게 식별할 수 있습니다. 레이블이 제공되지 않으면 기본값 '{presetName}_{outputIndex}'이(가) 사용됩니다. 여기서 사전 설정 이름은 해당 TransformOutput의 사전 설정 이름이고 출력 인덱스는 작업 내에서 이 JobOutput의 상대 인덱스입니다. 이 인덱스는 해당 Transform 내에서 해당 TransformOutput의 상대 인덱스와 동일합니다. |
presetOverride | Preset: |
해당 변환 출력의 사전 설정을 재정의하는 데 사용되는 사전 설정입니다. |
progress |
integer |
JobOutput이 처리 중 상태이면 작업 완료 백분율이 포함됩니다. 값은 예상값이며 작업 완료 시간을 예측하는 데 사용되지 않습니다. JobOutput이 완료되었는지 확인하려면 State 속성을 사용합니다. |
startTime |
string |
이 작업 출력이 처리를 시작한 UTC 날짜 및 시간입니다. |
state |
JobOutput의 상태를 설명합니다. |
JobRetry
작업을 다시 시도할 수 있음을 나타냅니다. 재시도에 실패하면 Azure Portal을 통해 Azure 지원 문의하세요.
Name | 형식 | Description |
---|---|---|
DoNotRetry |
string |
문제를 조사한 다음, 기본 문제가 수정되면 작업을 수정하여 다시 제출하거나 다시 시도해야 합니다. |
MayRetry |
string |
일정 기간 동안 기다렸다가 동일한 작업을 다시 제출한 후 문제가 해결될 수 있습니다. |
JobState
JobOutput의 상태를 설명합니다.
Name | 형식 | Description |
---|---|---|
Canceled |
string |
작업이 취소되었습니다. 작업에 대한 최종 상태입니다. |
Canceling |
string |
작업이 취소되는 중입니다. 작업에 대한 일시적인 상태입니다. |
Error |
string |
작업에 오류가 발생했습니다. 작업에 대한 최종 상태입니다. |
Finished |
string |
작업이 완료되었습니다. 작업에 대한 최종 상태입니다. |
Processing |
string |
작업이 처리 중입니다. 작업에 대한 일시적인 상태입니다. |
Queued |
string |
작업이 대기 중 상태이며 리소스를 사용할 수 있게 되기를 기다리고 있습니다. 이는 임시 상태입니다. |
Scheduled |
string |
작업이 사용 가능한 리소스에서 실행되도록 예약되고 있습니다. 큐에 대기 상태와 처리 상태 사이의 일시적인 상태입니다. |
JpgFormat
JPEG 썸네일을 생성하기 위한 설정에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filenamePattern |
string |
출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
JpgImage
입력 비디오에서 일련의 JPEG 이미지를 생성하기 위한 속성에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
keyFrameInterval |
string |
두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
layers |
Jpg |
인코더에서 생성할 출력 JPEG 이미지 계층의 컬렉션입니다. |
range |
string |
미리 보기 생성을 중지할 입력 비디오에서 미리 설정된 변환 시작 시간을 기준으로 하는 위치입니다. 값은 ISO 8601 형식(예: 시작 시간에서 5분 30초에서 중지하는 PT5M30S) 또는 프레임 수(예: 시작 시 프레임에서 300번째 프레임에서 중지하는 300)일 수 있습니다. 이 값이 1이면 시작 시간에 썸네일 하나만 생성하거나 스트림 기간에 대한 상대 값(예: 시작 시간부터 스트림 기간의 절반에서 중지하는 50%)을 의미합니다. 기본값은 100%로, 스트리밍 끝부분에서 중지함을 의미합니다. |
spriteColumn |
integer |
썸네일 스프라이트 이미지에 사용되는 열 수를 설정합니다. 행 수가 자동으로 계산되고 스프라이트의 각 축소판 그림에 대한 좌표 매핑을 사용하여 VTT 파일이 생성됩니다. 참고: 이 값은 양의 정수여야 하며 출력 이미지 해상도가 JPEG 최대 픽셀 해상도 제한인 65535x65535를 초과하지 않도록 적절한 값을 사용하는 것이 좋습니다. |
start |
string |
썸네일 생성을 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 또한 인코더가 비디오의 처음 몇 초에서 최상의 썸네일을 선택하고, 단계와 범위에 대한 다른 설정에 관계없이 하나의 썸네일만 생성하도록 지시하는 {Best} 매크로를 지원합니다. 기본값은 {Best} 매크로입니다. |
step |
string |
미리 보기가 생성되는 간격입니다. 값은 ISO 8601 형식(예: 5초마다 한 이미지의 경우 PT05S) 또는 프레임 수(예: 30프레임마다 하나의 이미지에 대해 30개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%마다 하나의 이미지에 대해 10%)일 수 있습니다. 참고: 단계 값은 처음 생성된 미리 보기에 영향을 줍니다. 변환 사전 설정 시작 시간에 정확히 지정되지 않을 수 있습니다. 이는 시작 시간과 시작 시간의 단계 위치 사이에 가장 적합한 썸네일을 첫 번째 출력으로 선택하려고 하는 인코더 때문입니다. 기본값은 10%이므로 스트림의 기간이 길면 처음 생성된 미리 보기가 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 근접할 것으로 예상되는 경우 단계에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 1로 설정합니다. |
stretchMode |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
|
syncMode |
비디오 동기화 모드 |
JpgLayer
입력 비디오에서 JPEG 이미지를 생성하는 설정을 설명합니다.
Name | 형식 | Description |
---|---|---|
height |
string |
이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다. |
label |
string |
다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다. |
quality |
integer |
JPEG 출력의 압축 품질입니다. 범위는 0-100이고 기본값은 70입니다. |
width |
string |
이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다. |
Mp4Format
출력 ISO MP4 파일의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filenamePattern |
string |
출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
outputFiles |
생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다. |
MultiBitrateFormat
GOP 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filenamePattern |
string |
출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
outputFiles |
생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다. |
OutputFile
생성된 출력 파일을 나타냅니다.
Name | 형식 | Description |
---|---|---|
labels |
string[] |
인코더가 비디오 및 오디오를 출력 파일에 멀티플렉싱하는 방법을 설명하는 레이블 목록입니다. 예를 들어 인코더가 v1과 v2 레이블이 있는 두 개의 비디오 레이어와 레이블 a1이 있는 오디오 계층을 생성하는 경우 '[v1, a1]'과 같은 배열은 인코더에게 v1이 나타내는 비디오 트랙과 a1이 나타내는 오디오 트랙이 있는 출력 파일을 생성하도록 지시합니다. |
PngFormat
PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filenamePattern |
string |
출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
PngImage
입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
keyFrameInterval |
string |
두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
layers |
Png |
인코더에서 생성할 출력 PNG 이미지 계층의 컬렉션입니다. |
range |
string |
미리 보기 생성을 중지할 입력 비디오에서 미리 설정된 변환 시작 시간을 기준으로 하는 위치입니다. 값은 ISO 8601 형식(예: 시작 시간에서 5분 30초에서 중지하는 PT5M30S) 또는 프레임 수(예: 시작 시 프레임에서 300번째 프레임에서 중지하는 300)일 수 있습니다. 이 값이 1이면 시작 시간에 썸네일 하나만 생성하거나 스트림 기간에 대한 상대 값(예: 시작 시간부터 스트림 기간의 절반에서 중지하는 50%)을 의미합니다. 기본값은 100%로, 스트리밍 끝부분에서 중지함을 의미합니다. |
start |
string |
썸네일 생성을 시작할 위치의 입력 비디오 위치입니다. 값은 ISO 8601 형식(예: 5초에서 시작할 경우 PT05S), 프레임 수(예: 10번째 프레임에서 시작할 경우 10개) 또는 스트림 기간의 상대값(예: 스트림 기간의 10%에서 시작할 경우 10%)이 될 수 있습니다. 또한 인코더가 비디오의 처음 몇 초에서 최상의 썸네일을 선택하고, 단계와 범위에 대한 다른 설정에 관계없이 하나의 썸네일만 생성하도록 지시하는 {Best} 매크로를 지원합니다. 기본값은 {Best} 매크로입니다. |
step |
string |
미리 보기가 생성되는 간격입니다. 값은 ISO 8601 형식(예: 5초마다 한 이미지의 경우 PT05S) 또는 프레임 수(예: 30프레임마다 하나의 이미지에 대해 30개) 또는 스트림 기간에 대한 상대 값(예: 스트림 기간의 10%마다 하나의 이미지에 대해 10%)일 수 있습니다. 참고: 단계 값은 처음 생성된 미리 보기에 영향을 줍니다. 변환 사전 설정 시작 시간에 정확히 지정되지 않을 수 있습니다. 이는 시작 시간과 시작 시간의 단계 위치 사이에 가장 적합한 썸네일을 첫 번째 출력으로 선택하려고 하는 인코더 때문입니다. 기본값은 10%이므로 스트림의 기간이 길면 처음 생성된 미리 보기가 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 근접할 것으로 예상되는 경우 단계에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 1로 설정합니다. |
stretchMode |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
|
syncMode |
비디오 동기화 모드 |
PngLayer
입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다.
Name | 형식 | Description |
---|---|---|
height |
string |
이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다. |
label |
string |
다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다. |
width |
string |
이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다. |
PresetConfigurations
인코더에 대한 선택적 구성 설정의 개체입니다.
Name | 형식 | Description |
---|---|---|
complexity |
속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 더 빠른 인코딩을 위해 복잡성을 속도로 설정하지만 압축 효율성은 낮습니다. |
|
interleaveOutput |
오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다. |
|
keyFrameIntervalInSeconds |
number |
키 프레임 간격(초)입니다. 예: KeyFrameIntervalInSeconds를 2로 설정하여 일부 플레이어의 재생 버퍼링을 줄입니다. |
maxBitrateBps |
integer |
최대 비트 전송률(초당 비트)입니다(상위 비디오 계층에 대한 임계값). 예: 복잡성이 높은 콘텐츠에 대해 매우 높은 비트 전송률 출력을 생성하지 않도록 MaxBitrateBps를 6000000으로 설정합니다. |
maxHeight |
integer |
출력 비디오 계층의 최대 높이입니다. 예: MaxHeight를 720으로 설정하여 입력이 4K인 경우에도 최대 720P의 출력 계층을 생성합니다. |
maxLayers |
integer |
출력 비디오 계층의 최대 수입니다. 예: 최대 4개의 출력 계층이 생성되어 인코딩 작업의 전체 비용을 제어하도록 MaxLayers를 4로 설정합니다. |
minBitrateBps |
integer |
최소 비트 전송률(초당 비트 수)입니다(아래쪽 비디오 계층의 임계값). 예: MinBitrateBps를 200000으로 설정하여 네트워크 대역폭이 낮은 사용자를 포함하는 하위 계층을 만듭니다. |
minHeight |
integer |
출력 비디오 계층의 최소 높이입니다. 예: MinHeight를 360으로 설정하여 180P와 같은 더 작은 해상도의 출력 계층을 방지합니다. |
Priority
Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다.
Name | 형식 | Description |
---|---|---|
High |
string |
다른 항목보다 우선해야 하는 TransformOutput에 사용됩니다. |
Low |
string |
기본 및 높은 우선 순위 TransformOutputs 후에 생성할 수 있는 TransformOutput에 사용됩니다. |
Normal |
string |
기본 우선 순위에서 생성할 수 있는 TransformOutput에 사용됩니다. |
Rectangle
입력 미디어를 처리하기 전에 입력 미디어에 적용된 사각형 창의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
height |
string |
사각형 영역의 높이(픽셀)입니다. 이는 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다. |
left |
string |
왼쪽 여백의 픽셀 수입니다. 이는 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다. |
top |
string |
위쪽 여백의 픽셀 수입니다. 이는 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다. |
width |
string |
사각형 영역의 너비(픽셀)입니다. 이는 절대 픽셀 값(예: 100)이거나 비디오 크기(예: 50%)를 기준으로 할 수 있습니다. |
Rotation
인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다.
Name | 형식 | Description |
---|---|---|
Auto |
string |
필요에 따라 자동으로 검색 및 회전합니다. |
None |
string |
비디오를 회전하지 마세요. 출력 형식이 지원하는 경우 회전에 대한 메타데이터는 그대로 유지됩니다. |
Rotate0 |
string |
비디오를 회전하지 말고 회전에 대한 메타데이터를 제거합니다. |
Rotate180 |
string |
시계 방향으로 180도 회전합니다. |
Rotate270 |
string |
시계 방향으로 270도 회전합니다. |
Rotate90 |
string |
시계 방향으로 90도 회전합니다. |
SelectAudioTrackByAttribute
특성 및 특성 필터를 지정하여 입력에서 오디오 트랙을 선택합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
attribute |
트랙을 필터링할 TrackAttribute입니다. |
|
channelMapping |
단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다. |
|
filter |
트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다. |
|
filterValue |
string |
트랙을 필터링할 값입니다. Filter 속성에 AttributeFilter.ValueEquals를 지정하는 경우에만 사용됩니다. |
SelectAudioTrackById
트랙 식별자를 지정하여 입력에서 오디오 트랙을 선택합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
channelMapping |
단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다. |
|
trackId |
integer |
선택할 식별자 추적 |
SelectVideoTrackByAttribute
특성 및 특성 필터를 지정하여 입력에서 비디오 트랙을 선택합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
attribute |
트랙을 필터링할 TrackAttribute입니다. |
|
filter |
트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다. |
|
filterValue |
string |
트랙을 필터링할 값입니다. Filter 속성에 AttributeFilter.ValueEquals를 지정하는 경우에만 사용됩니다. TrackAttribute.Bitrate의 경우 초당 비트(예: '1500000')의 정수 값이어야 합니다. TrackAttribute.Language는 비디오 트랙에 대해 지원되지 않습니다. |
SelectVideoTrackById
트랙 식별자를 지정하여 입력에서 비디오 트랙을 선택합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
trackId |
integer |
선택할 식별자 추적 |
StandardEncoderPreset
표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
codecs | Codec[]: |
입력 비디오를 인코딩할 때 사용할 코덱 목록입니다. |
experimentalOptions |
object |
사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전 |
filters |
인코딩하기 전에 입력 미디어에 적용되는 하나 이상의 필터링 작업입니다. |
|
formats | Format[]: |
인코더에서 생성할 출력 목록입니다. |
StretchMode
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.
Name | 형식 | Description |
---|---|---|
AutoFit |
string |
출력의 활성 비디오 영역이 입력과 동일한 가로 세로 비율을 가지도록 하면서 출력 해상도를 적용하기 위해 출력(레터박스 또는 필라 상자 포함)을 채우세요. 예를 들어 입력이 1920x1080이고 인코딩 사전 설정이 1280x1280을 요청하는 경우 출력은 1280x1280으로, 가로 세로 비율이 16:9인 내부 사각형 1280x720을 포함하고 기둥 상자 영역은 왼쪽과 오른쪽에서 너비가 280픽셀입니다. |
AutoSize |
string |
출력 해상도를 재정의하고 패딩 없이 입력의 표시 가로 세로 비율과 일치하도록 변경합니다. 예를 들어, 입력이 1920x1080이고 인코딩 사전 설정에서 1280x1280을 요청하는 경우 사전 설정의 값이 재정의되고 출력이 1280x720이 되어 16:9의 입력 가로 세로 비율이 유지됩니다. |
None |
string |
입력 비디오의 픽셀 가로 세로 비율 또는 디스플레이 가로 세로 비율을 고려하지 않고 출력 해상도를 엄격하게 준수합니다. |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID 유형입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
TrackAttribute
트랙을 필터링할 TrackAttribute입니다.
Name | 형식 | Description |
---|---|---|
Bitrate |
string |
트랙의 비트 전송률입니다. |
Language |
string |
트랙의 언어입니다. |
TransportStreamFormat
MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
filenamePattern |
string |
출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
outputFiles |
생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다. |
UtcClipTime
클립 시간을 미디어 파일의 Utc 시간 위치로 지정합니다. Utc 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
time |
string |
Utc 시간을 기준으로 입력 미디어의 타임라인 시간 위치입니다. |
Video
입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
keyFrameInterval |
string |
두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다. |
label |
string |
코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다. |
stretchMode |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
|
syncMode |
비디오 동기화 모드 |
VideoAnalyzerPreset
오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
audioLanguage |
string |
BCP-47 형식의 'language tag-region'(예: 'en-US')을 사용하여 입력의 오디오 페이로드에 대한 언어입니다. 콘텐츠의 언어를 알고 있는 경우 해당 언어를 지정하는 것이 좋습니다. 자동 언어 검색은 기본 모드에 포함되지 않으므로 AudioAnalysisMode::Basic에 대해 언어를 명시적으로 지정해야 합니다. 언어가 지정되지 않았거나 Null로 설정된 경우 자동 언어 검색이 첫 번째 검색된 언어를 선택하고 파일의 지속시간 동안 선택된 언어로 처리합니다. 현재 첫 번째 언어가 검색된 후 언어 간에 동적으로 전환하는 기능은 지원되지 않습니다. 자동 검색은 명확하게 식별 가능한 음성을 사용하여 오디오 녹음에 가장 적합합니다. 자동 검색에서 언어를 찾지 못하면 전사가 'en-US'로 대체됩니다." 지원되는 언어 목록은 여기에서 확인할 수 있습니다. https://go.microsoft.com/fwlink/?linkid=2109463 |
experimentalOptions |
object |
사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전 |
insightsToExtract |
서비스에서 생성할 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오 전용이 될 것으로 예상되는 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용으로 예상되는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건의 작업은 오류가 발생합니다. |
|
mode |
수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다. |
VideoOverlay
비디오 오버레이의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |
audioGainLevel |
number |
오버레이의 게인 오디오 수준입니다. 값은 [0, 1.0] 범위에 있어야 합니다. 기본값은 1.0입니다. |
cropRectangle |
오버레이 이미지 또는 비디오를 자르는 데 사용되는 선택적 사각형 창입니다. |
|
end |
string |
오버레이가 끝나는 입력 비디오를 참조하는 끝 위치입니다. 값은 ISO 8601 형식이어야 합니다. 예를 들어 PT30S는 입력 비디오로 30초 동안 오버레이를 종료합니다. 지정하지 않았거나 값이 입력 비디오 기간보다 크면 오버레이 미디어 기간이 입력 비디오 기간보다 크면 입력 비디오가 끝날 때까지 오버레이가 적용되고, 그렇지 않으면 오버레이 미디어 기간만큼 오버레이가 지속됩니다. |
fadeInDuration |
string |
오버레이가 입력 비디오로 페이드 인되는 기간입니다. 값은 ISO 8601 기간 형식이어야 합니다. 지정하지 않으면 기본 동작은 페이드 인(PT0S와 동일)이 없는 것입니다. |
fadeOutDuration |
string |
오버레이가 입력 비디오에서 페이드 아웃되는 기간입니다. 값은 ISO 8601 기간 형식이어야 합니다. 지정하지 않으면 기본 동작은 페이드 아웃(PT0S와 동일)이 없는 것입니다. |
inputLabel |
string |
오버레이로 사용할 작업 입력의 레이블입니다. 입력은 정확히 하나의 파일을 지정해야 합니다. 이미지 파일은 JPG, PNG, GIF 또는 BMP 형식 또는 오디오 파일(예: WAV, MP3, WMA, M4A 파일) 또는 비디오 파일에 지정할 수 있습니다. 지원되는 오디오 및 비디오 파일 형식의 전체 목록은 를 참조 https://aka.ms/mesformats 하세요. |
opacity |
number |
오버레이의 불투명도입니다. 범위 [0 - 1.0]의 값입니다. 기본값은 1.0이며 이는 오버레이가 불투명하다는 것을 의미합니다. |
position |
오버레이가 적용되는 입력 비디오의 위치입니다. |
|
start |
string |
오버레이가 시작되는 입력 비디오를 참조하는 시작 위치입니다. 값은 ISO 8601 형식이어야 합니다. 예를 들어 PT05S는 입력 비디오에 5초 동안 오버레이를 시작합니다. 지정하지 않으면 오버레이가 입력 비디오의 시작 부분에서 시작됩니다. |
VideoSyncMode
비디오 동기화 모드
Name | 형식 | Description |
---|---|---|
Auto |
string |
기본 메서드입니다. muxer 기능에 따라 Cfr과 Vfr 중에서 선택합니다. 출력 형식 MP4의 경우 기본 모드는 Cfr입니다. |
Cfr |
string |
입력 프레임은 요청된 상수 프레임 속도를 정확하게 달성하기 위해 필요에 따라 반복 및/또는 삭제됩니다. 출력 프레임 속도가 지정된 값으로 명시적으로 설정된 경우 권장됩니다. |
Passthrough |
string |
프레임의 프레젠테이션 타임스탬프는 입력 파일에서 출력 파일 작성기로 전달됩니다. 입력 소스에 가변 프레임 속도가 있고 GOP 경계를 정렬한 출력에서 적응 스트리밍을 위한 여러 계층을 생성하려고 할 때 권장됩니다. 참고: 입력의 두 개 이상의 프레임에 중복 타임스탬프가 있는 경우 출력도 동일한 동작을 갖습니다. |
Vfr |
string |
통과 모드와 비슷하지만 입력에 중복 타임스탬프가 있는 프레임이 있는 경우 하나의 프레임만 출력으로 전달되고 다른 프레임은 삭제됩니다. 출력 프레임 수가 입력 프레임 수와 같을 것으로 예상되는 경우 권장됩니다. 예를 들어 출력은 입력에 대해 PSNR과 같은 품질 메트릭을 계산하는 데 사용됩니다. |
VideoTrackDescriptor
비디오 트랙을 선택하는 TrackSelection입니다.
Name | 형식 | Description |
---|---|---|
@odata.type |
string:
#Microsoft. |
파생 형식에 대한 판별자입니다. |