Live Events - Update
기존 라이브 이벤트에 대한 설정을 업데이트.
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string |
Media Services 계정 이름입니다. |
live
|
path | True |
string |
라이브 이벤트의 이름, 최대 길이는 32입니다. regex 패턴: |
resource
|
path | True |
string |
Azure 구독 내 리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독의 고유 식별자입니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스가 있는 지리적 위치 |
properties.input | True |
라이브 이벤트 입력 설정입니다. 라이브 이벤트가 기여 인코더에서 입력을 받는 방법을 정의합니다. |
|
properties.crossSiteAccessPolicies |
라이브 이벤트 사이트 간 액세스 정책. |
||
properties.description |
string |
라이브 이벤트에 대한 설명입니다. |
|
properties.encoding |
라이브 이벤트에 대한 인코딩 설정입니다. 라이브 인코더가 라이브 이벤트에 사용되는지 여부와 라이브 인코더가 사용되는 경우 라이브 인코더의 설정이 사용되는지 여부를 구성합니다. |
||
properties.hostnamePrefix |
string |
useStaticHostname이 true로 설정된 경우 hostnamePrefix는 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당된 호스트 이름의 첫 번째 부분을 지정합니다. 최종 호스트 이름은 이 접두사, 미디어 서비스 계정 이름 및 Azure Media Services 데이터 센터에 대한 간단한 코드의 조합입니다. |
|
properties.preview |
라이브 이벤트 미리 보기 설정. 미리 보기를 사용하면 라이브 이벤트 생산자가 라이브 출력을 만들지 않고도 라이브 스트리밍 콘텐츠를 미리 볼 수 있습니다. |
||
properties.streamOptions |
LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값의 유효한 값은 'Default' 및 'LowLatency'입니다. |
||
properties.transcriptions |
라이브 이벤트에 대한 라이브 전사 설정입니다. 라이브 전사 기능에 대한 자세한 내용은 를 참조하세요 https://go.microsoft.com/fwlink/?linkid=2133742 . |
||
properties.useStaticHostname |
boolean |
정적 호스트 이름을 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당할지 여부를 지정합니다. 라이브 이벤트가 대기 상태인 경우에만 이 값을 업데이트할 수 있습니다. |
|
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
OK. 요청이 성공했습니다. |
|
202 Accepted |
수락됨 처리를 위해 요청이 수락되었으며 작업이 비동기적으로 완료됩니다. 비동기 Azure 운영 모니터링에 대한 자세한 내용은 를 참조 https://go.microsoft.com/fwlink/?linkid=2087017 하세요. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 스트리밍 오류 응답입니다. |
예제
Update a LiveEvent
샘플 요청
PATCH https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01
{
"location": "West US",
"tags": {
"tag1": "value1",
"tag2": "value2",
"tag3": "value3"
},
"properties": {
"description": "test event updated",
"input": {
"streamingProtocol": "FragmentedMP4",
"keyFrameIntervalDuration": "PT6S",
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowOne",
"address": "192.1.1.0"
}
]
}
}
},
"preview": {
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowOne",
"address": "192.1.1.0"
}
]
}
}
}
}
}
샘플 응답
azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
{
"name": "myLiveEvent1",
"id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
"type": "Microsoft.Media/mediaservices/liveevents",
"location": "West US",
"tags": {
"tag1": "value1",
"tag2": "value2",
"tag3": "value3"
},
"properties": {
"description": "test event updated",
"resourceState": "Running",
"provisioningState": "InProgress",
"created": "0001-01-01T00:00:00Z",
"lastModified": "0001-01-01T00:00:00Z",
"useStaticHostname": false,
"streamOptions": [],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "FragmentedMP4",
"accessToken": "<accessToken>",
"endpoints": [],
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowOne",
"address": "192.1.1.0",
"subnetPrefixLength": null
}
]
}
},
"timedMetadataEndpoints": []
},
"preview": {
"previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowOne",
"address": "192.1.1.0",
"subnetPrefixLength": null
}
]
}
},
"endpoints": []
},
"encoding": {
"encodingType": "None",
"presetName": null
}
}
}
{
"name": "myLiveEvent1",
"id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
"type": "Microsoft.Media/mediaservices/liveevents",
"location": "West US",
"tags": {
"tag1": "value1",
"tag2": "value2",
"tag3": "value3"
},
"properties": {
"description": "test event updated",
"resourceState": "Running",
"provisioningState": "Succeeded",
"created": "0001-01-01T00:00:00Z",
"lastModified": "0001-01-01T00:00:00Z",
"useStaticHostname": false,
"streamOptions": [],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "FragmentedMP4",
"accessToken": "<accessToken>",
"endpoints": [],
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowOne",
"address": "192.1.1.0",
"subnetPrefixLength": null
}
]
}
}
},
"preview": {
"previewLocator": "c10ea3fc-587f-4daf-b2b2-fa8f647a9ed2",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowOne",
"address": "192.1.1.0",
"subnetPrefixLength": null
}
]
}
},
"endpoints": []
},
"encoding": {
"encodingType": "None",
"presetName": null
}
}
}
정의
Name | Description |
---|---|
created |
리소스를 만든 ID의 형식입니다. |
Cross |
클라이언트 액세스 정책입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
IPAccess |
IP 액세스 제어입니다. |
IPRange |
CIDR 스키마의 IP 주소 범위입니다. |
Live |
라이브 이벤트입니다. |
Live |
라이브 이벤트를 인코딩하기 위한 라이브 이벤트 유형 및 선택적 인코딩 설정을 지정합니다. |
Live |
라이브 이벤트 유형입니다. encodingType이 PassthroughBasic 또는 PassthroughStandard로 설정된 경우 서비스는 들어오는 비디오 및 오디오 계층을 통해 출력으로 전달됩니다. encodingType이 Standard 또는 Premium1080p로 설정된 경우 라이브 인코더는 들어오는 스트림을 여러 비트 전송률 또는 계층으로 트랜스코딩합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2095101 을 참조하세요. 라이브 이벤트를 만든 후에는 이 속성을 수정할 수 없습니다. |
Live |
라이브 이벤트 엔드포인트입니다. |
Live |
라이브 이벤트 입력입니다. |
Live |
라이브 이벤트 입력에 대한 IP 액세스 제어입니다. |
Live |
라이브 이벤트에 대한 입력 프로토콜입니다. 생성 시 지정되며 업데이트할 수 없습니다. |
Live |
트랙 선택 조건입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
Live |
음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에서 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
Live |
라이브 이벤트 미리 보기 설정. |
Live |
라이브 이벤트 미리 보기 엔드포인트에 대한 IP 액세스 제어입니다. |
Live |
라이브 이벤트의 리소스 상태입니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2139012 을 참조하세요. |
Live |
라이브 이벤트 메타데이터 삽입 엔드포인트입니다. |
Live |
음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에 있는 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
Stream |
LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값의 유효한 값은 'Default' 및 'LowLatency'입니다. |
Stretch |
원하는 출력 해상도에 맞게 입력 비디오의 크기를 조정하는 방법을 지정합니다. 기본값은 없음입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
createdByType
리소스를 만든 ID의 형식입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CrossSiteAccessPolicies
클라이언트 액세스 정책입니다.
Name | 형식 | Description |
---|---|---|
clientAccessPolicy |
string |
Silverlight에서 사용하는 clientaccesspolicy.xml 콘텐츠입니다. |
crossDomainPolicy |
string |
Silverlight에서 사용하는 crossdomain.xml 콘텐츠입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
IPAccessControl
IP 액세스 제어입니다.
Name | 형식 | Description |
---|---|---|
allow |
IPRange[] |
IP 허용 목록입니다. |
IPRange
CIDR 스키마의 IP 주소 범위입니다.
Name | 형식 | Description |
---|---|---|
address |
string |
IP 주소입니다. |
name |
string |
IP 주소 범위의 이름입니다. |
subnetPrefixLength |
integer |
서브넷 마스크 접두사 길이입니다(CIDR 표기법 참조). |
LiveEvent
라이브 이벤트입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
리소스가 있는 지리적 위치 |
name |
string |
리소스의 이름입니다. |
properties.created |
string |
라이브 이벤트의 생성 시간 |
properties.crossSiteAccessPolicies |
라이브 이벤트 사이트 간 액세스 정책. |
|
properties.description |
string |
라이브 이벤트에 대한 설명입니다. |
properties.encoding |
라이브 이벤트에 대한 인코딩 설정입니다. 라이브 인코더가 라이브 이벤트에 사용되는지 여부와 라이브 인코더가 사용되는 경우 라이브 인코더에 대한 설정을 구성합니다. |
|
properties.hostnamePrefix |
string |
useStaticHostname이 true로 설정된 경우 hostnamePrefix는 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당된 호스트 이름의 첫 번째 부분을 지정합니다. 최종 호스트 이름은 이 접두사, 미디어 서비스 계정 이름 및 Azure Media Services 데이터 센터에 대한 간단한 코드의 조합입니다. |
properties.input |
라이브 이벤트 입력 설정입니다. 라이브 이벤트가 기여 인코더에서 입력을 받는 방법을 정의합니다. |
|
properties.lastModified |
string |
라이브 이벤트의 마지막으로 수정된 시간입니다. |
properties.preview |
라이브 이벤트 미리 보기 설정. 미리 보기를 사용하면 라이브 이벤트 생산자가 라이브 출력을 만들지 않고 라이브 스트리밍 콘텐츠를 미리 볼 수 있습니다. |
|
properties.provisioningState |
string |
라이브 이벤트의 프로비전 상태입니다. |
properties.resourceState |
라이브 이벤트의 리소스 상태입니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2139012 을 참조하세요. |
|
properties.streamOptions |
LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값의 유효한 값은 'Default' 및 'LowLatency'입니다. |
|
properties.transcriptions |
라이브 이벤트에 대한 라이브 전사 설정입니다. 라이브 전사 기능에 대한 자세한 내용은 를 참조하세요 https://go.microsoft.com/fwlink/?linkid=2133742 . |
|
properties.useStaticHostname |
boolean |
정적 호스트 이름을 라이브 이벤트 미리 보기 및 수집 엔드포인트에 할당할지 여부를 지정합니다. 라이브 이벤트가 대기 상태인 경우에만 이 값을 업데이트할 수 있습니다. |
systemData |
이 리소스와 관련된 시스템 메타데이터입니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
LiveEventEncoding
라이브 이벤트를 인코딩하기 위한 라이브 이벤트 유형 및 선택적 인코딩 설정을 지정합니다.
Name | 형식 | Description |
---|---|---|
encodingType |
라이브 이벤트 유형입니다. encodingType이 PassthroughBasic 또는 PassthroughStandard로 설정된 경우 서비스는 단순히 들어오는 비디오 및 오디오 계층을 통해 출력으로 전달됩니다. encodingType이 표준 또는 Premium1080p로 설정된 경우 라이브 인코더는 들어오는 스트림을 여러 비트 전송률 또는 계층으로 트랜스코딩합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2095101 을 참조하세요. 라이브 이벤트를 만든 후에는 이 속성을 수정할 수 없습니다. |
|
keyFrameInterval |
string |
0.5~20초 사이의 ISO 8601 시간 값을 사용하여 인코딩 라이브 이벤트의 비디오 및 오디오 트랙에 대한 출력 조각 길이를 지정합니다. 예를 들어 PT2S를 사용하여 2초를 나타냅니다. 비디오 트랙의 경우 키 프레임 간격 또는 GoP의 길이(그림 그룹)도 정의합니다. 인코딩 라이브 이벤트에 대해 이 값이 설정되지 않은 경우 조각 기간은 기본적으로 2초입니다. 통과 라이브 이벤트에 대해 값을 설정할 수 없습니다. |
presetName |
string |
encodingType이 None이 아닐 때 사용되는 선택적 인코딩 사전 설정 이름입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. encodingType이 표준으로 설정된 경우 기본 사전 설정 이름은 'Default720p'입니다. 그렇지 않으면 encodingType이 Premium1080p로 설정된 경우 기본 사전 설정은 'Default1080p'입니다. |
stretchMode |
원하는 출력 해상도에 맞게 입력 비디오의 크기를 조정하는 방법을 지정합니다. 기본값은 없음입니다. |
LiveEventEncodingType
라이브 이벤트 유형입니다. encodingType이 PassthroughBasic 또는 PassthroughStandard로 설정된 경우 서비스는 들어오는 비디오 및 오디오 계층을 통해 출력으로 전달됩니다. encodingType이 Standard 또는 Premium1080p로 설정된 경우 라이브 인코더는 들어오는 스트림을 여러 비트 전송률 또는 계층으로 트랜스코딩합니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2095101 을 참조하세요. 라이브 이벤트를 만든 후에는 이 속성을 수정할 수 없습니다.
Name | 형식 | Description |
---|---|---|
None |
string |
PassthroughStandard와 동일합니다. 아래 설명을 참조하세요. 이 열거형 값은 더 이상 사용되지 않습니다. |
PassthroughBasic |
string |
수집된 스트림은 추가 처리 없이 기여 인코더에서 라이브 이벤트를 통과합니다. PassthroughBasic 모드에서 수집은 최대 5Mbps로 제한되며 동시 라이브 출력은 1개만 허용됩니다. 라이브 전사를 사용할 수 없습니다. |
PassthroughStandard |
string |
수집된 스트림은 추가 처리 없이 기여 인코더에서 라이브 이벤트를 통과합니다. 라이브 전사를 사용할 수 있습니다. 수집 비트 전송률 제한은 훨씬 높으며 최대 3개의 동시 라이브 출력이 허용됩니다. |
Premium1080p |
string |
기여 라이브 인코더는 단일 비트 전송률 스트림을 라이브 이벤트로 보내고 Media Services는 여러 비트 전송률 스트림을 만듭니다. 출력은 해상도에서 1080p를 초과할 수 없습니다. |
Standard |
string |
기여 라이브 인코더는 단일 비트 전송률 스트림을 라이브 이벤트로 보내고 Media Services는 여러 비트 전송률 스트림을 만듭니다. 출력은 해상도가 720p를 초과할 수 없습니다. |
LiveEventEndpoint
라이브 이벤트 엔드포인트입니다.
Name | 형식 | Description |
---|---|---|
protocol |
string |
엔드포인트 프로토콜입니다. |
url |
string |
엔드포인트 URL입니다. |
LiveEventInput
라이브 이벤트 입력입니다.
Name | 형식 | Description |
---|---|---|
accessControl |
라이브 이벤트 입력에 대한 액세스 제어입니다. |
|
accessToken |
string |
스트림을 고유하게 식별하는 문자열 형식의 UUID입니다. 생성 시 지정할 수 있지만 업데이트할 수는 없습니다. 생략하면 서비스는 고유한 값을 생성합니다. |
endpoints |
라이브 이벤트에 대한 입력 엔드포인트입니다. |
|
keyFrameIntervalDuration |
string |
입력의 키 프레임 간격 기간의 ISO 8601 시간입니다. 이 값은 HLS 출력에서 EXT-X-TARGETDURATION 속성을 설정합니다. 예를 들어 PT2S를 사용하여 2초를 나타냅니다. 라이브 이벤트를 인코딩하기 위해 값을 비워 둡니다. |
streamingProtocol |
라이브 이벤트에 대한 입력 프로토콜입니다. 생성 시 지정되며 업데이트할 수 없습니다. |
|
timedMetadataEndpoints |
라이브 이벤트에 대한 메타데이터 엔드포인트입니다. |
LiveEventInputAccessControl
라이브 이벤트 입력에 대한 IP 액세스 제어입니다.
Name | 형식 | Description |
---|---|---|
ip |
IP 액세스 제어 속성입니다. |
LiveEventInputProtocol
라이브 이벤트에 대한 입력 프로토콜입니다. 생성 시 지정되며 업데이트할 수 없습니다.
Name | 형식 | Description |
---|---|---|
FragmentedMP4 |
string |
부드러운 스트리밍 입력은 기여 인코더가 라이브 이벤트에 전송합니다. |
RTMP |
string |
RTMP 입력은 기여 인코더에서 라이브 이벤트로 전송됩니다. |
LiveEventInputTrackSelection
트랙 선택 조건입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
Name | 형식 | Description |
---|---|---|
operation |
string |
작업 비교. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
property |
string |
선택할 속성 이름입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
value |
string |
선택할 속성 값입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
LiveEventOutputTranscriptionTrack
음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에서 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
Name | 형식 | Description |
---|---|---|
trackName |
string |
출력 트랙 이름입니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
LiveEventPreview
라이브 이벤트 미리 보기 설정.
Name | 형식 | Description |
---|---|---|
accessControl |
라이브 이벤트 미리 보기에 대한 액세스 제어입니다. |
|
alternativeMediaId |
string |
미리 보기용으로 만든 스트리밍 로케이터와 연결된 대체 미디어 식별자입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 식별자는 StreamingPolicyName 필드에 지정된 StreamingPolicy의 CustomLicenseAcquisitionUrlTemplate 또는 CustomKeyAcquisitionUrlTemplate에서 사용할 수 있습니다. |
endpoints |
미리 보기용 엔드포인트입니다. 미리 보기 URL을 라이브 이벤트 대상 그룹과 공유하지 마세요. |
|
previewLocator |
string |
Guid 형식의 미리 보기 로케이터 식별자입니다. 생성 시 이를 지정하면 호출자가 이벤트가 생성되기 전에 미리 보기 로케이터 URL을 알 수 있습니다. 생략하면 서비스는 임의 식별자를 생성합니다. 라이브 이벤트를 만든 후에는 이 값을 업데이트할 수 없습니다. |
streamingPolicyName |
string |
라이브 이벤트 미리 보기에 사용되는 스트리밍 정책의 이름입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. |
LiveEventPreviewAccessControl
라이브 이벤트 미리 보기 엔드포인트에 대한 IP 액세스 제어입니다.
Name | 형식 | Description |
---|---|---|
ip |
IP 액세스 제어 속성입니다. |
LiveEventResourceState
라이브 이벤트의 리소스 상태입니다. 자세한 내용은 https://go.microsoft.com/fwlink/?linkid=2139012 을 참조하세요.
Name | 형식 | Description |
---|---|---|
Allocating |
string |
라이브 이벤트에서 할당 작업이 호출되었으며 이 라이브 이벤트에 대한 리소스가 프로비전되고 있습니다. 할당이 성공적으로 완료되면 라이브 이벤트가 대기 상태로 전환됩니다. |
Deleting |
string |
라이브 이벤트가 삭제됩니다. 이 일시적인 상태에서는 요금이 청구되지 않습니다. 이 상태 중에는 업데이트나 스트리밍이 허용되지 않습니다. |
Running |
string |
라이브 이벤트 리소스가 할당되고, 수집 및 미리 보기 URL이 생성되었으며, 라이브 스트림을 수신할 수 있습니다. 이 시점에는 청구가 활성 상태입니다. 추가 청구를 중지하려면 라이브 이벤트 리소스에 대해 명시적으로 Stop을 호출해야 합니다. |
StandBy |
string |
라이브 이벤트 리소스가 프로비전되었으며 시작할 준비가 되었습니다. 이 상태에서는 요금이 청구됩니다. 이 상태에서도 대부분의 속성을 업데이트할 수 있지만 수집이나 스트리밍은 허용되지 않습니다. |
Starting |
string |
라이브 이벤트가 시작되고 리소스가 할당되고 있습니다. 이 상태에서는 요금이 청구되지 않습니다. 이 상태 중에는 업데이트나 스트리밍이 허용되지 않습니다. 오류가 발생하면 라이브 이벤트가 중지 상태로 돌아갑니다. |
Stopped |
string |
자동 시작이 true로 설정되지 않은 경우 라이브 이벤트를 생성한 후의 초기 상태입니다. 이 상태에서는 요금이 청구되지 않습니다. 이 상태에서는 라이브 이벤트 속성을 업데이트할 수 있지만 스트리밍은 허용되지 않습니다. |
Stopping |
string |
라이브 이벤트가 중지되고, 리소스가 프로비저닝 해제되고 있습니다. 이 일시적인 상태에서는 요금이 청구되지 않습니다. 이 상태 중에는 업데이트나 스트리밍이 허용되지 않습니다. |
LiveEventTimedMetadataEndpoint
라이브 이벤트 메타데이터 삽입 엔드포인트입니다.
Name | 형식 | Description |
---|---|---|
url |
string |
메타데이터 엔드포인트 URL입니다. |
LiveEventTranscription
음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에 있는 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다.
Name | 형식 | Description |
---|---|---|
inputTrackSelection |
음성 텍스트 변환 전사가 적용되는 입력 라이브 피드에서 오디오 트랙을 선택하는 메커니즘을 제공합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
|
language |
string |
음성 텍스트 변환 전사에 사용할 언어(로캘)를 지정합니다. 오디오 트랙의 음성 언어와 일치해야 합니다. 값은 BCP-47 형식이어야 합니다(예: 'en-US'). 라이브 전사 기능 및 지원되는 언어 목록에 대한 자세한 내용은 를 참조 https://go.microsoft.com/fwlink/?linkid=2133742 하세요. |
outputTranscriptionTrack |
음성 텍스트 변환 전사를 사용하여 생성된 라이브 이벤트의 출력에 있는 전사 트랙에 대해 설명합니다. 이 속성은 나중에 사용하기 위해 예약되어 있으며 이 속성에 설정된 모든 값은 무시됩니다. |
StreamOptionsFlag
LiveEvent에 사용할 옵션입니다. 이 값은 생성 시 지정되며 업데이트할 수 없습니다. 배열 항목 값의 유효한 값은 'Default' 및 'LowLatency'입니다.
Name | 형식 | Description |
---|---|---|
Default |
string |
특별한 대기 시간 최적화 없이 라이브 스트리밍. |
LowLatency |
string |
라이브 이벤트는 내부 버퍼를 줄여 종단 간 대기 시간을 줄입니다. |
LowLatencyV2 |
string |
라이브 이벤트는 종단 간 대기 시간에 최적화되어 있습니다. 이 옵션은 RTMP 입력을 사용하여 라이브 이벤트를 인코딩하는 데만 사용할 수 있습니다. 출력은 HLS 또는 DASH 형식을 사용하여 스트리밍할 수 있습니다. 출력의 보관 또는 DVR 되윈드 길이는 6시간으로 제한됩니다. 다른 모든 시나리오에 대해 "LowLatency" 스트림 옵션을 사용합니다. |
StretchMode
원하는 출력 해상도에 맞게 입력 비디오의 크기를 조정하는 방법을 지정합니다. 기본값은 없음입니다.
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 유형입니다. |