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
accountName
path True

string

Media Services 계정 이름입니다.

jobName
path True

string

작업 이름입니다.

resourceGroupName
path True

string

Azure 구독 내 리소스 그룹의 이름입니다.

subscriptionId
path True

string

Microsoft Azure 구독의 고유 식별자입니다.

transformName
path True

string

변환 이름입니다.

api-version
query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다.

응답

Name 형식 Description
200 OK

Job

정상

Other Status Codes

ErrorResponse

자세한 오류 정보입니다.

예제

Get a Job by name

Sample Request

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/contosoresources/providers/Microsoft.Media/mediaServices/contosomedia/transforms/exampleTransform/jobs/job1?api-version=2022-07-01

Sample Response

{
  "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
AacAudio

AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다.

AacAudioProfile

AAC를 사용하여 오디오를 인코딩할 때 사용할 인코딩 프로필입니다.

AbsoluteClipTime

클립 시간을 미디어 파일의 절대 시간 위치로 지정합니다. 절대 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다.

AnalysisResolution

비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "SourceResolution"입니다. "StandardDefinition"을 사용하면 적절한 가로 세로 비율을 유지하면서 입력 비디오의 크기를 표준 정의로 조정합니다. 비디오가 더 높은 해상도인 경우에만 크기가 조정됩니다. 예를 들어 1920x1080 입력은 처리하기 전에 640x360으로 크기가 조정됩니다. "StandardDefinition"으로 전환하면 고해상도 비디오를 처리하는 데 걸리는 시간이 줄어듭니다. 이 구성 요소 사용 비용을 줄일 수도 있습니다(자세한 내용은 참조 https://azure.microsoft.com/en-us/pricing/details/media-services/#analytics ). 그러나 크기가 조정된 비디오에서 너무 작아지는 얼굴은 감지되지 않을 수 있습니다.

AttributeFilter

트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다.

Audio

모든 오디오 코덱에 대한 공통 속성을 정의합니다.

AudioAnalysisMode

수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다.

AudioAnalyzerPreset

Audio Analyzer 사전 설정은 음성 전사를 포함하여 미리 정의된 AI 기반 분석 작업 집합을 적용합니다. 현재 미리 설정은 단일 오디오 트랙을 사용하여 콘텐츠를 처리하도록 지원합니다.

AudioOverlay

오디오 오버레이의 속성을 설명합니다.

AudioTrackDescriptor

오디오 트랙을 선택하는 TrackSelection입니다.

BlurType

흐림 유형

BuiltInStandardEncoderPreset

표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다.

ChannelMapping

단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다.

Complexity

속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 인코딩 속도가 빠르지만 압축 효율성이 낮을 경우 복잡성을 속도로 설정합니다.

CopyAudio

입력 오디오 비트 스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.

CopyVideo

다시 인코딩하지 않고 입력 비디오 비트스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.

createdByType

리소스를 만든 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

인터레이스 해제 설정에 대해 설명합니다.

DeinterlaceMode

디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다.

DeinterlaceParity

인터레이스 해제에 대한 필드 패리티이며 기본값은 Auto입니다.

EncoderNamedPreset

비디오 인코딩에 사용할 기본 제공 사전 설정입니다.

EntropyMode

이 계층에 사용할 엔트로피 모드입니다. 지정하지 않으면 인코더는 프로필 및 수준에 적합한 모드를 선택합니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

FaceDetectorPreset

존재하는 모든 얼굴을 감지(선택적으로 수정)하기 위해 비디오를 분석할 때 사용할 모든 설정을 설명합니다.

FaceRedactorMode

이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다.

Fade

입력 미디어에 적용되는 페이드 효과의 속성을 설명합니다.

Filters

인코딩하기 전에 입력 미디어에 적용할 인터레이싱 해제, 회전 등과 같은 모든 필터링 작업에 대해 설명합니다.

FromAllInputFile

IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 모든 파일을 검색하는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용되어 입력 파일 집합에서 단일 트랙을 선택할 수 있습니다.

FromEachInputFile

IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 각 입력 파일을 보는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용하여 지정된 각 파일에서 트랙을 선택합니다.

H264Complexity

인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다.

H264Layer

H.264 비디오 코덱을 사용하여 입력 비디오를 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정을 설명합니다.

H264RateControlMode

비디오 속도 제어 모드

H264Video

H.264 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.

H264VideoProfile

현재 기준, 기본, 높음, High422, High444를 지원합니다. 기본값은 Auto입니다.

H265Complexity

인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다.

H265Layer

입력 비디오를 H.265 비디오 코덱을 사용하여 원하는 출력 비트 전송률 계층으로 인코딩할 때 사용할 설정에 대해 설명합니다.

H265Video

H.265 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.

H265VideoProfile

현재 Main을 지원합니다. 기본값은 Auto입니다.

Image

입력 비디오에서 썸네일을 생성하기 위한 기본 속성에 대해 설명합니다.

ImageFormat

출력 이미지 파일의 속성을 설명합니다.

InputFile

단일 파일에 대한 InputDefinition입니다. TrackSelections의 범위는 지정된 파일로 지정됩니다.

InsightsType

서비스에서 생성하려는 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오로만 필요한 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용일 것으로 예상하는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건에서 작업이 오류 발생합니다.

InterleaveOutput

오디오 및 비디오가 컨테이너 형식으로 저장되는 방식을 제어하도록 출력의 인터리브 모드를 설정합니다. 예: InterleavedOutput을 NonInterleavedOutput으로 설정하여 별도의 MP4 파일에서 오디오 전용 및 비디오 전용 출력을 생성합니다.

Job

작업 리소스 유형입니다. 진행률 및 상태는 작업을 폴링하거나 EventGrid를 사용하여 이벤트를 구독하여 얻을 수 있습니다.

JobError

JobOutput 오류에 대한 세부 정보입니다.

JobErrorCategory

오류 분류에 도움이 됩니다.

JobErrorCode

오류를 설명하는 오류 코드입니다.

JobErrorDetail

JobOutput 오류에 대한 세부 정보입니다.

JobInputAsset

작업에 입력할 자산을 나타냅니다.

JobInputClip

작업의 입력 파일을 나타냅니다.

JobInputHttp

HTTPS 작업 입력을 나타냅니다.

JobInputs

작업에 대한 입력 목록을 설명합니다.

JobInputSequence

시퀀스에는 각 클립이 JobInput인 정렬된 클립 목록이 포함됩니다. 시퀀스는 단일 입력으로 처리됩니다.

JobOutputAsset

JobOutput으로 사용되는 자산을 나타냅니다.

JobRetry

작업을 다시 시도할 수 있음을 나타냅니다. 재시도에 실패하면 Azure Portal을 통해 Azure 지원 문의하세요.

JobState

JobOutput의 상태를 설명합니다.

JpgFormat

JPEG 썸네일을 생성하기 위한 설정에 대해 설명합니다.

JpgImage

입력 비디오에서 일련의 JPEG 이미지를 생성하기 위한 속성에 대해 설명합니다.

JpgLayer

입력 비디오에서 JPEG 이미지를 생성하는 설정을 설명합니다.

Mp4Format

출력 ISO MP4 파일의 속성을 설명합니다.

MultiBitrateFormat

GOP 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다.

OutputFile

생성된 출력 파일을 나타냅니다.

PngFormat

PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다.

PngImage

입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다.

PngLayer

입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다.

PresetConfigurations

인코더에 대한 선택적 구성 설정의 개체입니다.

Priority

Transform 내에서 TransformOutputs의 상대적 우선 순위를 설정합니다. 이렇게 하면 서비스에서 TransformOutputs를 처리하는 데 사용하는 우선 순위가 설정됩니다. 기본 우선 순위는 Normal입니다.

Rectangle

입력 미디어를 처리하기 전에 입력 미디어에 적용된 사각형 창의 속성을 설명합니다.

Rotation

인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다.

SelectAudioTrackByAttribute

특성 및 특성 필터를 지정하여 입력에서 오디오 트랙을 선택합니다.

SelectAudioTrackById

트랙 식별자를 지정하여 입력에서 오디오 트랙을 선택합니다.

SelectVideoTrackByAttribute

특성 및 특성 필터를 지정하여 입력에서 비디오 트랙을 선택합니다.

SelectVideoTrackById

트랙 식별자를 지정하여 입력에서 비디오 트랙을 선택합니다.

StandardEncoderPreset

표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다.

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

TrackAttribute

트랙을 필터링할 TrackAttribute입니다.

TransportStreamFormat

MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다.

UtcClipTime

클립 시간을 미디어 파일의 Utc 시간 위치로 지정합니다. Utc 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다.

Video

입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다.

VideoAnalyzerPreset

오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다.

VideoOverlay

비디오 오버레이의 속성을 설명합니다.

VideoSyncMode

비디오 동기화 모드

VideoTrackDescriptor

비디오 트랙을 선택하는 TrackSelection입니다.

AacAudio

AAC(고급 오디오 코덱) 오디오 인코딩 설정에 대해 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.AacAudio

파생 형식에 대한 판별자입니다.

bitrate

integer

출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다.

channels

integer

오디오의 채널 수입니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

profile

AacAudioProfile

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.Media.AbsoluteClipTime

파생 형식에 대한 판별자입니다.

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.Media.Audio

파생 형식에 대한 판별자입니다.

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.Media.AudioAnalyzerPreset

파생 형식에 대한 판별자입니다.

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

수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다.

AudioOverlay

오디오 오버레이의 속성을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.AudioOverlay

파생 형식에 대한 판별자입니다.

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.Media.AudioTrackDescriptor

파생 형식에 대한 판별자입니다.

channelMapping

ChannelMapping

단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다.

BlurType

흐림 유형

Name 형식 Description
Black

string

검은색: 차단 필터

Box

string

상자: 디버그 필터, 경계 상자만

High

string

높음: 흐림 효과 필터 혼동

Low

string

낮음: 박스카 흐림 필터

Med

string

메드: 가우스 흐림 필터

BuiltInStandardEncoderPreset

표준 인코더를 사용하여 입력 비디오를 인코딩하기 위한 기본 제공 사전 설정을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.BuiltInStandardEncoderPreset

파생 형식에 대한 판별자입니다.

configurations

PresetConfigurations

인코더에 대한 선택적 구성 설정입니다. 구성은 ContentAwareEncoding 및 H265ContentAwareEncoding BuiltInStandardEncoderPreset에 대해서만 지원됩니다.

presetName

EncoderNamedPreset

비디오 인코딩에 사용할 기본 제공 사전 설정입니다.

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.Media.CopyAudio

파생 형식에 대한 판별자입니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

CopyVideo

다시 인코딩하지 않고 입력 비디오 비트스트림을 복사하도록 인코더에 지시하는 코덱 플래그입니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.CopyVideo

파생 형식에 대한 판별자입니다.

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.Media.DDAudio

파생 형식에 대한 판별자입니다.

bitrate

integer

출력 인코딩된 오디오의 비트 전송률(초당 비트)입니다.

channels

integer

오디오의 채널 수입니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

samplingRate

integer

Hertz의 인코딩에 사용할 샘플링 속도입니다.

Deinterlace

인터레이스 해제 설정에 대해 설명합니다.

Name 형식 Description
mode

DeinterlaceMode

디인터레이싱 모드입니다. 기본값은 AutoPixelAdaptive입니다.

parity

DeinterlaceParity

인터레이스 해제에 대한 필드 패리티이며 기본값은 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

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

FaceDetectorPreset

존재하는 모든 얼굴을 감지(선택적으로 수정)하기 위해 비디오를 분석할 때 사용할 모든 설정을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.FaceDetectorPreset

파생 형식에 대한 판별자입니다.

blurType

BlurType

흐림 유형

experimentalOptions

object

사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전

mode

FaceRedactorMode

이 모드는 다음 설정 중에서 선택할 수 있는 기능을 제공합니다. 1) 분석 - 검색 전용입니다. 이 모드는 비디오 전체에서 얼굴의 모양을 표시하는 메타데이터 JSON 파일을 생성합니다. 가능한 경우 동일한 사람의 모양에 동일한 ID가 할당됩니다. 2) 결합 - 추가로 수정(흐리게) 감지된 얼굴. 3) 수정 - 감지된 얼굴의 하위 집합을 선택적으로 편집할 수 있도록 2패스 프로세스를 사용하도록 설정합니다. 원본 비디오 및 수정이 필요한 사용자가 선택한 ID 하위 집합과 함께 이전 분석 패스의 메타데이터 파일을 가져옵니다.

resolution

AnalysisResolution

비디오가 분석되는 최대 해상도를 지정합니다. 기본 동작은 분석 시 입력 비디오를 원래 해상도로 유지하는 "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

Rectangle

입력 비디오를 자르는 사각형 창의 매개 변수입니다.

deinterlace

Deinterlace

인터레이싱 해제 설정입니다.

fadeIn

Fade

입력 미디어에 적용된 페이드 효과의 속성을 설명합니다.

fadeOut

Fade

입력 미디어에 적용된 페이드 효과의 속성을 설명합니다.

overlays Overlay[]:

입력 비디오에 적용할 오버레이의 속성입니다. 오디오, 이미지 또는 비디오 오버레이일 수 있습니다.

rotation

Rotation

인코딩되기 전에 입력 비디오에 적용할 회전(있는 경우)입니다. 기본값은 Auto입니다.

FromAllInputFile

IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 모든 파일을 검색하는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용되어 입력 파일 집합에서 단일 트랙을 선택할 수 있습니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.FromAllInputFile

파생 형식에 대한 판별자입니다.

includedTracks TrackDescriptor[]:

입력에서 트랙의 메타데이터 및 선택을 정의하는 TrackDescriptors 목록입니다.

FromEachInputFile

IncludedTracks 속성에 지정된 트랙을 선택하기 위해 제공된 각 입력 파일을 보는 InputDefinition입니다. 일반적으로 AudioTrackByAttribute 및 VideoTrackByAttribute와 함께 사용하여 지정된 각 파일에서 트랙을 선택합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.FromEachInputFile

파생 형식에 대한 판별자입니다.

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

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

H264VideoProfile

현재 기준, 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.Media.H264Video

파생 형식에 대한 판별자입니다.

complexity

H264Complexity

인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 기본값은 Balanced입니다.

keyFrameInterval

string

두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

layers

H264Layer[]

인코더에서 생성할 출력 H.264 계층의 컬렉션입니다.

rateControlMode

H264RateControlMode

비디오 속도 제어 모드

sceneChangeDetection

boolean

인코더가 장면 변경 시 키 프레임을 삽입해야 하는지 여부입니다. 지정하지 않으면 기본값은 false입니다. 이 플래그는 인코더가 단일 출력 비디오를 생성하도록 구성된 경우에만 true로 설정해야 합니다.

stretchMode

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

syncMode

VideoSyncMode

비디오 동기화 모드

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

H265VideoProfile

현재 Main을 지원합니다. 기본값은 Auto입니다.

referenceFrames

integer

이 레이어를 인코딩할 때 사용할 참조 프레임의 수입니다. 지정하지 않으면 인코더는 인코더 복잡성 설정에 따라 적절한 숫자를 결정합니다.

slices

integer

이 레이어를 인코딩할 때 사용할 조각 수입니다. 지정하지 않으면 기본값은 0입니다. 즉, 인코더는 각 프레임에 단일 조각을 사용합니다.

width

string

이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다.

H265Video

H.265 코덱을 사용하여 비디오를 인코딩하기 위한 모든 속성을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.H265Video

파생 형식에 대한 판별자입니다.

complexity

H265Complexity

인코더에 인코딩 설정을 선택하는 방법을 알려줍니다. 품질은 더 높은 압축 비율을 제공하지만 더 높은 비용과 더 긴 컴퓨팅 시간을 제공합니다. 속도는 비교적 큰 파일을 생성하지만 더 빠르고 경제적입니다. 기본값은 Balanced입니다.

keyFrameInterval

string

두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

layers

H265Layer[]

인코더에서 생성할 출력 H.265 계층의 컬렉션입니다.

sceneChangeDetection

boolean

인코더가 장면 변경 시 키 프레임을 삽입해야 하는지 여부를 지정합니다. 지정하지 않으면 기본값은 false입니다. 이 플래그는 인코더가 단일 출력 비디오를 생성하도록 구성된 경우에만 true로 설정해야 합니다.

stretchMode

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

syncMode

VideoSyncMode

비디오 동기화 모드

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.Media.Image

파생 형식에 대한 판별자입니다.

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

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

syncMode

VideoSyncMode

비디오 동기화 모드

ImageFormat

출력 이미지 파일의 속성을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.ImageFormat

파생 형식에 대한 판별자입니다.

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.Media.InputFile

파생 형식에 대한 판별자입니다.

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[]:

JobOutputAsset[]

작업에 대한 출력입니다.

properties.priority

Priority

작업을 처리해야 하는 우선 순위입니다. 우선 순위가 높은 작업은 우선 순위가 낮은 작업보다 먼저 처리됩니다. 설정하지 않은 경우 기본값은 보통입니다.

properties.startTime

string

이 작업이 처리를 시작한 UTC 날짜 및 시간입니다.

properties.state

JobState

작업의 현재 상태입니다.

systemData

systemData

이 리소스와 관련된 시스템 메타데이터입니다.

type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

JobError

JobOutput 오류에 대한 세부 정보입니다.

Name 형식 Description
category

JobErrorCategory

오류 분류에 도움이 됩니다.

code

JobErrorCode

오류를 설명하는 오류 코드입니다.

details

JobErrorDetail[]

이 보고된 오류로 이어진 특정 오류에 대한 세부 정보 배열입니다.

message

string

사람이 읽을 수 있는 언어 종속적 오류 표현입니다.

retry

JobRetry

작업을 다시 시도할 수 있음을 나타냅니다. 재시도에 실패하면 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.Media.JobInputAsset

파생 형식에 대한 판별자입니다.

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.Media.JobInputClip

파생 형식에 대한 판별자입니다.

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.Media.JobInputHttp

파생 형식에 대한 판별자입니다.

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.Media.JobInputs

파생 형식에 대한 판별자입니다.

inputs JobInput[]:

작업에 대한 입력 목록입니다.

JobInputSequence

시퀀스에는 각 클립이 JobInput인 정렬된 클립 목록이 포함됩니다. 시퀀스는 단일 입력으로 처리됩니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.JobInputSequence

파생 형식에 대한 판별자입니다.

inputs JobInputClip[]:

타임라인 구성하는 JobInputs입니다.

JobOutputAsset

JobOutput으로 사용되는 자산을 나타냅니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.JobOutputAsset

파생 형식에 대한 판별자입니다.

assetName

string

출력 자산의 이름입니다.

endTime

string

이 작업 출력이 처리를 완료한 UTC 날짜 및 시간입니다.

error

JobError

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

JobState

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.Media.JpgFormat

파생 형식에 대한 판별자입니다.

filenamePattern

string

출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

JpgImage

입력 비디오에서 일련의 JPEG 이미지를 생성하기 위한 속성에 대해 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.JpgImage

파생 형식에 대한 판별자입니다.

keyFrameInterval

string

두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

layers

JpgLayer[]

인코더에서 생성할 출력 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

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

syncMode

VideoSyncMode

비디오 동기화 모드

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.Media.Mp4Format

파생 형식에 대한 판별자입니다.

filenamePattern

string

출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

outputFiles

OutputFile[]

생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다.

MultiBitrateFormat

GOP 정렬 다중 비트 전송률 파일의 컬렉션을 생성하기 위한 속성에 대해 설명합니다. 기본 동작은 모든 오디오와 함께 muxed되는 각 비디오 계층에 대해 하나의 출력 파일을 생성하는 것입니다. 생성된 정확한 출력 파일은 outputFiles 컬렉션을 지정하여 제어할 수 있습니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.MultiBitrateFormat

파생 형식에 대한 판별자입니다.

filenamePattern

string

출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

outputFiles

OutputFile[]

생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다.

OutputFile

생성된 출력 파일을 나타냅니다.

Name 형식 Description
labels

string[]

인코더가 비디오 및 오디오를 출력 파일에 멀티플렉싱하는 방법을 설명하는 레이블 목록입니다. 예를 들어 인코더가 v1과 v2 레이블이 있는 두 개의 비디오 레이어와 레이블 a1이 있는 오디오 계층을 생성하는 경우 '[v1, a1]'과 같은 배열은 인코더에게 v1이 나타내는 비디오 트랙과 a1이 나타내는 오디오 트랙이 있는 출력 파일을 생성하도록 지시합니다.

PngFormat

PNG 썸네일을 생성하기 위한 설정에 대해 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.PngFormat

파생 형식에 대한 판별자입니다.

filenamePattern

string

출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

PngImage

입력 비디오에서 일련의 PNG 이미지를 생성하기 위한 속성을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.PngImage

파생 형식에 대한 판별자입니다.

keyFrameInterval

string

두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 소스 설정을 따릅니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

layers

PngLayer[]

인코더에서 생성할 출력 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

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

syncMode

VideoSyncMode

비디오 동기화 모드

PngLayer

입력 비디오에서 PNG 이미지를 생성하는 설정을 설명합니다.

Name 형식 Description
height

string

이 계층에 대한 출력 비디오의 높이입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 높이가 입력의 절반 정도인 것을 의미합니다.

label

string

다른 비디오 및 오디오 계층을 멀티플렉싱하거나 출력 파일의 이름을 지정하는 데 사용할 수 있는 이 계층의 영숫자 레이블입니다.

width

string

이 계층에 대한 출력 비디오의 너비입니다. 값은 절대(픽셀) 또는 상대 값(백분율)일 수 있습니다. 예를 들어 50%는 출력 비디오의 너비가 입력의 절반에 해당한다는 것을 의미합니다.

PresetConfigurations

인코더에 대한 선택적 구성 설정의 개체입니다.

Name 형식 Description
complexity

Complexity

속도와 품질 간의 균형을 제어하도록 인코더 설정을 구성할 수 있습니다. 예: 더 빠른 인코딩을 위해 복잡성을 속도로 설정하지만 압축 효율성은 낮습니다.

interleaveOutput

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.Media.SelectAudioTrackByAttribute

파생 형식에 대한 판별자입니다.

attribute

TrackAttribute

트랙을 필터링할 TrackAttribute입니다.

channelMapping

ChannelMapping

단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다.

filter

AttributeFilter

트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다.

filterValue

string

트랙을 필터링할 값입니다. Filter 속성에 AttributeFilter.ValueEquals를 지정하는 경우에만 사용됩니다.

SelectAudioTrackById

트랙 식별자를 지정하여 입력에서 오디오 트랙을 선택합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.SelectAudioTrackById

파생 형식에 대한 판별자입니다.

channelMapping

ChannelMapping

단일 채널 오디오 트랙에 대한 선택적 지정입니다. 스테레오 또는 다중 채널 오디오 트랙에 트랙을 결합하는 데 사용할 수 있습니다.

trackId

integer

선택할 식별자 추적

SelectVideoTrackByAttribute

특성 및 특성 필터를 지정하여 입력에서 비디오 트랙을 선택합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.SelectVideoTrackByAttribute

파생 형식에 대한 판별자입니다.

attribute

TrackAttribute

트랙을 필터링할 TrackAttribute입니다.

filter

AttributeFilter

트랙을 선택하기 위해 TrackAttribute에 적용할 AttributeFilter의 형식입니다.

filterValue

string

트랙을 필터링할 값입니다. Filter 속성에 AttributeFilter.ValueEquals를 지정하는 경우에만 사용됩니다. TrackAttribute.Bitrate의 경우 초당 비트(예: '1500000')의 정수 값이어야 합니다. TrackAttribute.Language는 비디오 트랙에 대해 지원되지 않습니다.

SelectVideoTrackById

트랙 식별자를 지정하여 입력에서 비디오 트랙을 선택합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.SelectVideoTrackById

파생 형식에 대한 판별자입니다.

trackId

integer

선택할 식별자 추적

StandardEncoderPreset

표준 인코더를 사용하여 입력 비디오를 인코딩할 때 사용할 모든 설정을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.StandardEncoderPreset

파생 형식에 대한 판별자입니다.

codecs Codec[]:

입력 비디오를 인코딩할 때 사용할 코덱 목록입니다.

experimentalOptions

object

사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전

filters

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

createdByType

리소스를 만든 ID 유형입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

TrackAttribute

트랙을 필터링할 TrackAttribute입니다.

Name 형식 Description
Bitrate

string

트랙의 비트 전송률입니다.

Language

string

트랙의 언어입니다.

TransportStreamFormat

MPEG-2 전송 스트림(ISO/IEC 13818-1) 출력 비디오 파일을 생성하기 위한 속성에 대해 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.TransportStreamFormat

파생 형식에 대한 판별자입니다.

filenamePattern

string

출력 파일을 만드는 데 사용되는 파일 명명 패턴입니다. 파일 이름에서 지원되는 매크로는 {Basename} - 입력 비디오 파일의 이름을 사용하는 확장 매크로입니다. 입력 비디오 파일의 기본 이름(파일 접미사가 포함되지 않음)이 32자 미만인 경우 입력 비디오 파일의 기본 이름이 사용됩니다. 입력 비디오 파일의 기본 이름 길이가 32자를 초과하면 기본 이름은 총 길이가 처음 32자로 잘립니다. {Extension} - 이 형식에 적합한 확장입니다. {Label} - 코덱/계층에 할당된 레이블입니다. {Index} - 썸네일의 고유 인덱스입니다. 미리 보기에만 적용됩니다. {AudioStream} - 문자열 "Audio"와 오디오 스트림 번호(1부터 시작). {Bitrate} - kbps의 오디오/비디오 비트 전송률입니다. 썸네일에는 적용되지 않습니다. {Codec} - 오디오/비디오 코덱의 유형입니다. {Resolution} - 비디오 해상도입니다. 대체되지 않은 매크로는 파일 이름에서 축소되고 제거됩니다.

outputFiles

OutputFile[]

생성할 출력 파일 목록입니다. 목록의 각 항목은 함께 muxed할 오디오 및 비디오 계층 레이블 집합입니다.

UtcClipTime

클립 시간을 미디어 파일의 Utc 시간 위치로 지정합니다. Utc 시간은 미디어 파일이 타임스탬프 0에서 시작되는지 여부에 따라 다른 위치를 가리킬 수 있습니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.UtcClipTime

파생 형식에 대한 판별자입니다.

time

string

Utc 시간을 기준으로 입력 미디어의 타임라인 시간 위치입니다.

Video

입력 비디오를 인코딩하기 위한 기본 속성에 대해 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.Video

파생 형식에 대한 판별자입니다.

keyFrameInterval

string

두 키 프레임 사이의 거리입니다. 값은 ISO 8601 형식으로 지정된 [0.5, 20] 초 범위에서 0이 아니어야 합니다. 기본값은 2초(PT2S)입니다. VideoSyncMode.Passthrough가 설정된 경우 이 설정은 무시됩니다. 여기서 KeyFrameInterval 값은 입력 원본 설정을 따릅니다.

label

string

코덱에 대한 선택적 레이블입니다. 레이블을 사용하여 muxing 동작을 제어할 수 있습니다.

stretchMode

StretchMode

크기 조정 모드 - 입력 비디오의 크기를 원하는 출력 해상도에 맞게 조정하는 방법입니다. 기본값은 AutoSize입니다.

syncMode

VideoSyncMode

비디오 동기화 모드

VideoAnalyzerPreset

오디오 및 비디오 모두에서 인사이트(풍부한 메타데이터)를 추출하고 JSON 형식 파일을 출력하는 비디오 분석기 사전 설정입니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.VideoAnalyzerPreset

파생 형식에 대한 판별자입니다.

audioLanguage

string

BCP-47 형식의 'language tag-region'(예: 'en-US')을 사용하여 입력의 오디오 페이로드에 대한 언어입니다. 콘텐츠의 언어를 알고 있는 경우 해당 언어를 지정하는 것이 좋습니다. 자동 언어 검색은 기본 모드에 포함되지 않으므로 AudioAnalysisMode::Basic에 대해 언어를 명시적으로 지정해야 합니다. 언어가 지정되지 않았거나 Null로 설정된 경우 자동 언어 검색이 첫 번째 검색된 언어를 선택하고 파일의 지속시간 동안 선택된 언어로 처리합니다. 현재 첫 번째 언어가 검색된 후 언어 간에 동적으로 전환하는 기능은 지원되지 않습니다. 자동 검색은 명확하게 식별 가능한 음성을 사용하여 오디오 녹음에 가장 적합합니다. 자동 검색에서 언어를 찾지 못하면 전사가 'en-US'로 대체됩니다." 지원되는 언어 목록은 여기에서 확인할 수 있습니다. https://go.microsoft.com/fwlink/?linkid=2109463

experimentalOptions

object

사전 설정 자체에 노출되지 않은 매개 변수에 대한 키 값 쌍을 포함하는 사전

insightsToExtract

InsightsType

서비스에서 생성할 인사이트 유형을 정의합니다. 허용되는 값은 'AudioInsightsOnly', 'VideoInsightsOnly' 및 'AllInsights'입니다. 기본값은 AllInsights입니다. 이를 AllInsights로 설정하고 입력이 오디오 전용인 경우 오디오 인사이트만 생성됩니다. 마찬가지로 입력이 비디오 전용인 경우 비디오 인사이트만 생성됩니다. 일부 입력이 비디오 전용이 될 것으로 예상되는 경우 AudioInsightsOnly를 사용하지 않는 것이 좋습니다. 또는 일부 입력이 오디오 전용으로 예상되는 경우 VideoInsightsOnly를 사용합니다. 이러한 조건의 작업은 오류가 발생합니다.

mode

AudioAnalysisMode

수행할 오디오 분석 작업 집합을 결정합니다. 지정하지 않으면 표준 AudioAnalysisMode가 선택됩니다.

VideoOverlay

비디오 오버레이의 속성을 설명합니다.

Name 형식 Description
@odata.type string:

#Microsoft.Media.VideoOverlay

파생 형식에 대한 판별자입니다.

audioGainLevel

number

오버레이의 게인 오디오 수준입니다. 값은 [0, 1.0] 범위에 있어야 합니다. 기본값은 1.0입니다.

cropRectangle

Rectangle

오버레이 이미지 또는 비디오를 자르는 데 사용되는 선택적 사각형 창입니다.

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

Rectangle

오버레이가 적용되는 입력 비디오의 위치입니다.

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.Media.VideoTrackDescriptor

파생 형식에 대한 판별자입니다.