Live Events - Create
ライブ イベントの作成
新しいライブ イベントを作成します。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01&autoStart={autoStart}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
account
|
path | True |
string |
Media Services アカウント名。 |
live
|
path | True |
string |
ライブ イベントの名前。最大長は 32 です。 正規表現パターン: |
resource
|
path | True |
string |
Azure サブスクリプション内のリソース グループの名前。 |
subscription
|
path | True |
string |
Microsoft Azure サブスクリプションの一意識別子。 |
api-version
|
query | True |
string |
クライアント要求で使用される API のバージョン。 |
auto
|
query |
boolean |
フラグは、作成時にリソースを自動的に開始するかどうかを示します。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
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 |
リソース タグ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
OK です。 要求は成功しました。 |
|
201 Created |
作成されました。 要求は処理のために受け入れられ、操作は非同期的に完了します。 Azure-AsyncOperation 応答ヘッダーを使用した非同期 Azure 操作の監視の詳細については、「」を参照してください https://go.microsoft.com/fwlink/?linkid=2087017 。 |
|
Other Status Codes |
操作が失敗した理由を説明するストリーミング エラー応答。 |
例
Create a LiveEvent
要求のサンプル
PUT 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"
},
"properties": {
"description": "test event 1",
"input": {
"streamingProtocol": "RTMP",
"keyFrameIntervalDuration": "PT6S",
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
}
},
"preview": {
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 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"
},
"properties": {
"description": "test event 1",
"resourceState": "Creating",
"provisioningState": "InProgress",
"created": "2018-03-03T02:25:06.0982751Z",
"lastModified": "2018-03-03T02:25:06.0982751Z",
"useStaticHostname": false,
"streamOptions": [],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "FragmentedMP4",
"accessToken": "<accessToken>",
"endpoints": [],
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"timedMetadataEndpoints": []
},
"preview": {
"previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"endpoints": []
},
"encoding": {
"encodingType": "None",
"presetName": null
},
"crossSiteAccessPolicies": {
"clientAccessPolicy": null,
"crossDomainPolicy": 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"
},
"properties": {
"description": "test event 1",
"resourceState": "Stopped",
"provisioningState": "Succeeded",
"created": "2018-03-03T02:25:06.0982751Z",
"lastModified": "2018-03-03T02:25:06.0982751Z",
"useStaticHostname": false,
"streamOptions": [],
"input": {
"keyFrameIntervalDuration": "PT6S",
"streamingProtocol": "FragmentedMP4",
"accessToken": "<accessToken>",
"endpoints": [],
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"timedMetadataEndpoints": []
},
"preview": {
"previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
"streamingPolicyName": null,
"accessControl": {
"ip": {
"allow": [
{
"name": "AllowAll",
"address": "0.0.0.0",
"subnetPrefixLength": 0
}
]
}
},
"endpoints": []
},
"encoding": {
"encodingType": "None",
"presetName": null
},
"crossSiteAccessPolicies": {
"clientAccessPolicy": null,
"crossDomainPolicy": null
}
}
}
定義
名前 | 説明 |
---|---|
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 |
目的の出力解像度に合わせて入力ビデオのサイズを変更する方法を指定します。 既定値は None です |
system |
リソースの作成と最後の変更に関連するメタデータ。 |
createdByType
リソースを作成した ID の種類。
名前 | 型 | 説明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
CrossSiteAccessPolicies
クライアント アクセス ポリシー。
名前 | 型 | 説明 |
---|---|---|
clientAccessPolicy |
string |
Silverlight で使用 clientaccesspolicy.xml の内容。 |
crossDomainPolicy |
string |
Silverlight で使用 crossdomain.xml の内容。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
IPAccessControl
IP アクセス制御。
名前 | 型 | 説明 |
---|---|---|
allow |
IPRange[] |
IP 許可リスト。 |
IPRange
CIDR スキームの IP アドレス範囲。
名前 | 型 | 説明 |
---|---|---|
address |
string |
IP アドレスです。 |
name |
string |
IP アドレス範囲のフレンドリ名。 |
subnetPrefixLength |
integer |
サブネット マスク プレフィックスの長さ (CIDR 表記を参照)。 |
LiveEvent
ライブ イベント。
名前 | 型 | 説明 |
---|---|---|
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
ライブ イベントの種類と、ライブ イベントをエンコードするためのオプションのエンコード設定を指定します。
名前 | 型 | 説明 |
---|---|---|
encodingType |
ライブ イベントの種類。 encodingType が PassthroughBasic または PassthroughStandard に設定されている場合、サービスは単に受信ビデオとオーディオ レイヤーを経由して出力に渡します。 encodingType が Standard または Premium1080p に設定されている場合、ライブ エンコーダーは受信ストリームを複数のビットレートまたはレイヤーにトランスコードします。 詳細については、「 https://go.microsoft.com/fwlink/?linkid=2095101 」を参照してください。 ライブ イベントの作成後にこのプロパティを変更することはできません。 |
|
keyFrameInterval |
string |
エンコード ライブ イベントのビデオ トラックとオーディオ トラックの出力フラグメントの長さを指定するには、ISO 8601 の 0.5 秒から 20 秒の時間値を使用します。 たとえば、PT2S を使用して 2 秒を示します。 ビデオ トラックの場合は、キー フレームの間隔、または GoP (画像のグループ) の長さも定義します。 エンコード ライブ イベントに対してこの値が設定されていない場合、フラグメント期間の既定値は 2 秒です。 パススルー ライブ イベントの値を設定できません。 |
presetName |
string |
encodingType が None でない場合に使用される、省略可能なエンコード プリセット名。 この値は作成時に指定され、更新できません。 encodingType が Standard に設定されている場合、既定のプリセット名は 'Default720p' になります。 それ以外の場合、encodingType が Premium1080p に設定されている場合、既定のプリセットは "Default1080p" になります。 |
stretchMode |
目的の出力解像度に合わせて入力ビデオのサイズを変更する方法を指定します。 既定値は None です |
LiveEventEncodingType
ライブ イベントの種類。 encodingType が PassthroughBasic または PassthroughStandard に設定されている場合、サービスは受信したビデオレイヤーとオーディオレイヤーを単に出力に渡します。 encodingType が Standard または Premium1080p に設定されている場合、ライブ エンコーダーは受信ストリームを複数のビットレートまたはレイヤーにトランスコードします。 詳細については、「 https://go.microsoft.com/fwlink/?linkid=2095101 」を参照してください。 このプロパティは、ライブ イベントが作成された後は変更できません。
名前 | 型 | 説明 |
---|---|---|
None |
string |
これは PassthroughStandard と同じです。以下の説明を参照してください。 この列挙値は非推奨です。 |
PassthroughBasic |
string |
取り込まれたストリームは、それ以上の処理を行わずにコントリビューション エンコーダーからライブ イベントを通過します。 パススルー基本モードでは、インジェストは最大 5 Mbps に制限され、同時ライブ出力は 1 つだけ許可されます。 ライブ文字起こしは使用できません。 |
PassthroughStandard |
string |
取り込まれたストリームは、それ以上の処理を行わずにコントリビューション エンコーダーからライブ イベントを通過します。 ライブ文字起こしを使用できます。 インジェスト ビットレートの制限ははるかに高く、最大 3 つの同時ライブ出力が許可されます。 |
Premium1080p |
string |
コントリビューション ライブ エンコーダーは、1 つのビットレート ストリームをライブ イベントに送信し、Media Services は複数のビットレート ストリームを作成します。 出力の解像度は 1080p を超えることはできません。 |
Standard |
string |
コントリビューション ライブ エンコーダーは、1 つのビットレート ストリームをライブ イベントに送信し、Media Services は複数のビットレート ストリームを作成します。 出力の解像度は 720p を超えることはできません。 |
LiveEventEndpoint
ライブ イベント エンドポイント。
名前 | 型 | 説明 |
---|---|---|
protocol |
string |
エンドポイント プロトコル。 |
url |
string |
エンドポイント URL。 |
LiveEventInput
ライブ イベントの入力。
名前 | 型 | 説明 |
---|---|---|
accessControl |
ライブ イベント入力のアクセス制御。 |
|
accessToken |
string |
ストリームを一意に識別するための文字列形式の UUID。 これは作成時に指定できますが、更新することはできません。 省略すると、サービスによって一意の値が生成されます。 |
endpoints |
ライブ イベントの入力エンドポイント。 |
|
keyFrameIntervalDuration |
string |
入力のキー フレーム間隔期間の ISO 8601 時間。 この値は、HLS 出力の EXT-X-TARGETDURATION プロパティを設定します。 たとえば、PT2S を使用して 2 秒を示します。 ライブ イベントをエンコードする場合は、値を空のままにします。 |
streamingProtocol |
ライブ イベントの入力プロトコル。 これは作成時に指定され、更新できません。 |
|
timedMetadataEndpoints |
ライブ イベントのメタデータ エンドポイント。 |
LiveEventInputAccessControl
ライブ イベント入力の IP アクセス制御。
名前 | 型 | 説明 |
---|---|---|
ip |
IP アクセス制御のプロパティ。 |
LiveEventInputProtocol
ライブ イベントの入力プロトコル。 これは作成時に指定され、更新できません。
名前 | 型 | 説明 |
---|---|---|
FragmentedMP4 |
string |
スムーズ ストリーミング入力は、コントリビューション エンコーダーによってライブ イベントに送信されます。 |
RTMP |
string |
RTMP 入力は、コントリビューション エンコーダーによってライブ イベントに送信されます。 |
LiveEventInputTrackSelection
トラックの選択条件。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。
名前 | 型 | 説明 |
---|---|---|
operation |
string |
操作の比較。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。 |
property |
string |
選択するプロパティ名。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。 |
value |
string |
選択するプロパティ値。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。 |
LiveEventOutputTranscriptionTrack
音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。
名前 | 型 | 説明 |
---|---|---|
trackName |
string |
出力トラック名。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。 |
LiveEventPreview
ライブ イベントのプレビュー設定。
名前 | 型 | 説明 |
---|---|---|
accessControl |
ライブ イベント プレビューのアクセス制御。 |
|
alternativeMediaId |
string |
プレビュー用に作成されたストリーミング ロケーターに関連付けられている代替メディア識別子。 この値は作成時に指定され、更新できません。 識別子は、StreamingPolicyName フィールドで指定された StreamingPolicy の CustomLicenseAcquisitionUrlTemplate または CustomKeyAcquisitionUrlTemplate で使用できます。 |
endpoints |
プレビュー用のエンドポイント。 プレビュー URL をライブ イベントの対象ユーザーと共有しないでください。 |
|
previewLocator |
string |
Guid 形式のプレビュー ロケーターの識別子。 作成時にこれを指定すると、呼び出し元は、イベントが作成される前にプレビュー ロケーター URL を知ることができます。 省略すると、サービスによってランダムな識別子が生成されます。 ライブ イベントが作成されると、この値を更新できません。 |
streamingPolicyName |
string |
ライブ イベント プレビューに使用されるストリーミング ポリシーの名前。 この値は作成時に指定され、更新できません。 |
LiveEventPreviewAccessControl
ライブ イベント プレビュー エンドポイントの IP アクセス制御。
名前 | 型 | 説明 |
---|---|---|
ip |
IP アクセス制御のプロパティ。 |
LiveEventResourceState
ライブ イベントのリソースの状態。 詳細については、「 https://go.microsoft.com/fwlink/?linkid=2139012 」を参照してください。
名前 | 型 | 説明 |
---|---|---|
Allocating |
string |
ライブ イベントで割り当てアクションが呼び出され、このライブ イベントに対してリソースがプロビジョニングされています。 割り当てが正常に完了すると、ライブ イベントは StandBy 状態に遷移します。 |
Deleting |
string |
ライブ イベントを削除しています。 この遷移状態では、課金は行われません。 この状態の間は、更新もストリーミングもできません。 |
Running |
string |
ライブ イベントのリソースが割り当てられ、取り込み URL とプレビュー URL も生成済みで、ライブ ストリームを受信することができます。 この時点で、課金がアクティブになります。 それ以上の課金を停止するには、ライブ イベント リソースの Stop を明示的に呼び出す必要があります。 |
StandBy |
string |
ライブ イベント リソースがプロビジョニングされ、開始する準備が整いました。 この状態では、課金が行われます。 ほとんどのプロパティは引き続き更新できますが、この状態では取り込みまたはストリーミングは許可されません。 |
Starting |
string |
ライブ イベントが開始され、リソースが割り当てられています。 この状態では、課金は行われません。 この状態の間は、更新もストリーミングもできません。 エラーが発生した場合、ライブ イベントは停止状態に戻ります。 |
Stopped |
string |
これは、ライブ イベント作成後の初期状態です (自動開始が true に設定された場合を除く)。この状態では、課金は行われません。 この状態では、ライブ イベントのプロパティを更新できますが、ストリーミングは許可されません。 |
Stopping |
string |
ライブ イベントが停止され、リソースのプロビジョニングが解除されています。 この遷移状態では、課金は行われません。 この状態の間は、更新もストリーミングもできません。 |
LiveEventTimedMetadataEndpoint
ライブ イベント メタデータ挿入エンドポイント。
名前 | 型 | 説明 |
---|---|---|
url |
string |
メタデータ エンドポイントの URL。 |
LiveEventTranscription
音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは将来使用するために予約されています。このプロパティに設定された値は無視されます。
名前 | 型 | 説明 |
---|---|---|
inputTrackSelection |
音声テキスト変換の文字起こしが適用される入力ライブ フィードでオーディオ トラックを選択するメカニズムを提供します。 このプロパティは将来使用するために予約されています。このプロパティに設定された値は無視されます。 |
|
language |
string |
音声テキスト変換の文字起こしに使用する言語 (ロケール) を指定します。オーディオ トラックの音声言語と一致する必要があります。値は BCP-47 形式である必要があります (例: 'en-US')。 ライブ文字起こし機能の詳細と、サポートされている言語の一覧を参照してください https://go.microsoft.com/fwlink/?linkid=2133742 。 |
outputTranscriptionTrack |
音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは将来使用するために予約されています。このプロパティに設定された値は無視されます。 |
StreamOptionsFlag
LiveEvent に使用するオプション。 この値は作成時に指定され、更新できません。 配列エントリ値の有効な値は、'Default' と 'LowLatency' です。
名前 | 型 | 説明 |
---|---|---|
Default |
string |
特別な待機時間の最適化のないライブ ストリーミング。 |
LowLatency |
string |
ライブ イベントは、内部バッファーを減らすことで、エンドツーエンドの待機時間を短縮します。 |
LowLatencyV2 |
string |
ライブ イベントは、エンド ツー エンドの待機時間用に最適化されています。 このオプションは、RTMP 入力を使用してライブ イベントをエンコードする場合にのみ使用できます。 出力は、HLS 形式または DASH 形式を使用してストリーミングできます。 出力のアーカイブまたは DVR 巻き戻しの長さは 6 時間に制限されます。 他のすべてのシナリオでは、"LowLatency" ストリーム オプションを使用します。 |
StretchMode
目的の出力解像度に合わせて入力ビデオのサイズを変更する方法を指定します。 既定値は None です
名前 | 型 | 説明 |
---|---|---|
AutoFit |
string |
出力の解像度を優先するように出力を埋め込み (レターボックスまたは柱ボックス) し、出力内のアクティブなビデオ領域の縦横比が入力と同じであることを確認します。 たとえば、入力が 1920x1080 で、エンコード プリセットが 1280x1280 を要求する場合、出力は 1280x1280 になります。出力は 1280x1280 で、縦横比は 16:9 の 1280 x 720 の内側の四角形が含まれており、柱ボックス領域は左右に 280 ピクセル幅になります。 |
AutoSize |
string |
出力解像度をオーバーライドし、埋め込みなしで入力の表示縦横比に合わせて変更します。 たとえば入力が 1920 x 1080 であるとき、エンコード プリセットによって 1280 x 1280 が要求された場合、プリセットの値がオーバーライドされ、出力は 1280 x 720 となり、入力の縦横比 (16:9) が維持されます。 |
None |
string |
入力ビデオのピクセル縦横比や表示縦横比を考慮せずに、エンコード プリセットで指定された出力解像度を厳密に尊重します。 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC)。 |
createdBy |
string |
リソースを作成した ID。 |
createdByType |
リソースを作成した ID の種類。 |
|
lastModifiedAt |
string |
リソースの最終変更のタイムスタンプ (UTC) |
lastModifiedBy |
string |
リソースを最後に変更した ID。 |
lastModifiedByType |
リソースを最後に変更した ID の種類。 |