Transforms - Create Or Update
변환 만들기 또는 업데이트
새 변환을 만들거나 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaServices/{accountName}/transforms/{transformName}?api-version=2022-07-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
Media Services 계정 이름입니다. |
resource
|
path | True |
string |
Azure 구독 내 리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독의 고유 식별자입니다. |
transform
|
path | True |
string |
변환 이름입니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
properties.outputs | True |
변환이 생성해야 하는 하나 이상의 TransformOutputs의 배열입니다. |
|
properties.description |
string |
변환에 대한 자세한 정보 표시 설명입니다(선택 사항). |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
|
201 Created |
생성일 |
|
Other Status Codes |
자세한 오류 정보입니다. |
예제
Create or update a Transform
샘플 요청
PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/createdTransform?api-version=2022-07-01
{
"properties": {
"description": "Example Transform to illustrate create and update.",
"outputs": [
{
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
}
}
샘플 응답
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
{
"name": "createdTransform",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaservices/contosomedia/transforms/createdTransform",
"type": "Microsoft.Media/mediaservices/transforms",
"properties": {
"created": "2022-10-17T23:14:31.7664818Z",
"description": "Example Transform to illustrate create and update.",
"lastModified": "2022-10-17T23:14:31.7664818Z",
"outputs": [
{
"onError": "StopProcessingJob",
"relativePriority": "Normal",
"preset": {
"@odata.type": "#Microsoft.Media.BuiltInStandardEncoderPreset",
"presetName": "AdaptiveStreaming"
}
}
]
},
"systemData": {
"createdBy": "contoso@microsoft.com",
"createdByType": "User",
"createdAt": "2022-10-17T23:14:31.7664818Z",
"lastModifiedBy": "contoso@microsoft.com",
"lastModifiedByType": "User",
"lastModifiedAt": "2022-10-17T23:14:31.7664818Z"
}
}
정의
Name | Description |
---|---|
Aac |
AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다. |
Aac |
AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다. |
Analysis |
비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 또한 이 구성 요소를 사용하는 비용을 줄일 수 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다. |
Audio |
모든 오디오 코덱에 대한 공통 속성을 정의합니다. |
Audio |
수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다. |
Audio |
Audio Analyzer 사전 설정은 음성 전사를 포함하여 미리 정의된 AI 기반 분석 작업 집합을 적용합니다. 현재 미리 설정은 단일 오디오 트랙을 사용하여 콘텐츠를 처리하도록 지원합니다. |
Audio |
오디오 오버레이의 속성을 설명합니다. |
Blur |
흐림 효과 유형 |
Built |
표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다. |
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 |
인코딩하기 전에 입력 미디어에 적용할 인터레이싱 해제, 회전 등과 같은 모든 필터링 작업에 대해 설명합니다. |
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 |
출력 이미지 파일의 속성을 설명합니다. |
Insights |
서비스에서 생성하려는 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오로만 필요한 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용일 것으로 예상하는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건에서 작업이 오류 발생합니다. |
Interleave |
오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다. |
Jpg |
JPEG 썸네일을 생성하기 위한 설정에 대해 설명합니다. |
Jpg |
입력 비디오에서 일련의 JPEG 이미지를 생성하기 위한 속성을 설명합니다. |
Jpg |
입력 비디오에서 JPEG 이미지를 생성하는 설정을 설명합니다. |
Mp4Format |
출력 ISO MP4 파일의 속성을 설명합니다. |
Multi |
GOP 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다. |
On |
변환은 둘 이상의 출력을 정의할 수 있습니다. 이 속성은 한 출력이 실패할 때 서비스가 수행해야 하는 작업을 정의합니다. 다른 출력을 계속 생성하거나 다른 출력을 중지합니다. 전체 작업 상태는 'ContinueJob'으로 지정된 출력의 오류를 반영하지 않습니다. 기본값은 'StopProcessingJob'입니다. |
Output |
생성된 출력 파일을 나타냅니다. |
Png |
PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다. |
Png |
입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다. |
Png |
입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다. |
Preset |
인코더에 대한 선택적 구성 설정의 개체입니다. |
Priority |
Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다. |
Rectangle |
입력 미디어를 처리하기 전에 입력 미디어에 적용된 사각형 창의 속성을 설명합니다. |
Rotation |
인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다. |
Standard |
표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다. |
Stretch |
크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
Transform |
변환은 코드 변환 또는 인사이트 추출과 같은 입력 미디어에서 원하는 출력을 생성하기 위한 규칙 또는 지침을 캡슐화합니다. 변환을 만든 후에는 작업을 만들어 입력 미디어에 적용할 수 있습니다. |
Transform |
원하는 출력을 생성하는 동안 적용할 규칙인 TransformOutput의 속성을 설명합니다. |
Transport |
MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다. |
Video |
입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다. |
Video |
오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다. |
Video |
비디오 오버레이의 속성을 설명합니다. |
Video |
비디오 동기화 모드 |
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 프로필로 인코딩하도록 지정합니다. |
AnalysisResolution
비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 또한 이 구성 요소를 사용하는 비용을 줄일 수 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다.
Name | 형식 | Description |
---|---|---|
SourceResolution |
string |
|
StandardDefinition |
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초에 오버레이를 시작합니다. 지정하지 않으면 오버레이가 입력 비디오의 시작 부분에서 시작됩니다. |
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 |
비디오 인코딩에 사용할 기본 제공 사전 설정입니다. |
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입니다. |
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 프로필과 일치하는 숫자일 수 있습니다. 지정하지 않으면 기본값은 자동이며, 이를 통해 인코더는 이 계층에 적합한 수준을 선택할 수 있습니다. |
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} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다. |
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 |
출력은 비디오 전용 또는 오디오 전용입니다. |
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%이므로 스트림의 기간이 길면 처음 생성된 축소판 그림이 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 가깝게 예상되는 경우 Step에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 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할 오디오 및 비디오 계층 레이블 집합입니다. |
OnErrorType
변환은 둘 이상의 출력을 정의할 수 있습니다. 이 속성은 한 출력이 실패할 때 서비스가 수행해야 하는 작업을 정의합니다. 다른 출력을 계속 생성하거나 다른 출력을 중지합니다. 전체 작업 상태는 'ContinueJob'으로 지정된 출력의 오류를 반영하지 않습니다. 기본값은 'StopProcessingJob'입니다.
Name | 형식 | Description |
---|---|---|
ContinueJob |
string |
이 TransformOutput이 실패하면 다른 TransformOutput이 계속되도록 허용하도록 서비스에 알릴 수 있습니다. |
StopProcessingJob |
string |
이 TransformOutput이 실패하면 다른 불완전한 TransformOutput을 중지할 수 있음을 서비스에 알릴 수 있습니다. |
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%이므로 스트림의 기간이 길면 처음 생성된 축소판 그림이 시작 시간에 지정된 미리 보기와 멀리 떨어져 있을 수 있습니다. 첫 번째 축소판 그림이 시작 시간에 가깝게 예상되는 경우 Step에 적절한 값을 선택하거나 시작 시간에 썸네일이 하나만 필요한 경우 범위 값을 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 |
다른 항목보다 우선해야 하는 TransformOutputs에 사용됩니다. |
Low |
string |
기본 및 높은 우선 순위 TransformOutputs 후에 생성할 수 있는 TransformOutput에 사용됩니다. |
Normal |
string |
기본 우선 순위에서 생성할 수 있는 TransformOutputs에 사용됩니다. |
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도 회전합니다. |
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픽셀인 1280x1280이 출력됩니다. |
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 유형입니다. |
Transform
변환은 코드 변환 또는 인사이트 추출과 같은 입력 미디어에서 원하는 출력을 생성하기 위한 규칙 또는 지침을 캡슐화합니다. 변환을 만든 후에는 작업을 만들어 입력 미디어에 적용할 수 있습니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
리소스의 이름입니다. |
properties.created |
string |
변환이 생성될 때 UTC 날짜 및 시간은 'YYYY-MM-DDThh:mm:ssZ' 형식입니다. |
properties.description |
string |
변환에 대한 자세한 정보 표시 설명입니다(선택 사항). |
properties.lastModified |
string |
변환이 마지막으로 업데이트될 때 UTC 날짜 및 시간은 'YYYY-MM-DDThh:mm:ssZ' 형식입니다. |
properties.outputs |
변환이 생성해야 하는 하나 이상의 TransformOutputs의 배열입니다. |
|
systemData |
이 리소스와 관련된 시스템 메타데이터입니다. |
|
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
TransformOutput
원하는 출력을 생성하는 동안 적용할 규칙인 TransformOutput의 속성을 설명합니다.
Name | 형식 | Description |
---|---|---|
onError |
변환은 둘 이상의 출력을 정의할 수 있습니다. 이 속성은 한 출력이 실패할 때 서비스가 수행해야 하는 작업을 정의합니다. 다른 출력을 계속 생성하거나 다른 출력을 중지합니다. 전체 작업 상태는 'ContinueJob'으로 지정된 출력의 오류를 반영하지 않습니다. 기본값은 'StopProcessingJob'입니다. |
|
preset | Preset: |
원본 파일에서 인사이트를 수정, 변환 또는 추출하여 출력을 생성하는 데 사용할 작업을 설명하는 사전 설정입니다. |
relativePriority |
Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다. |
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할 오디오 및 비디오 계층 레이블 집합입니다. |
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과 같은 품질 메트릭을 계산하는 데 사용됩니다. |