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 パラメーター

名前 / 必須 説明
accountName
path True

string

Media Services アカウント名。

liveEventName
path True

string

ライブ イベントの名前。最大長は 32 です。

Regex pattern: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

resourceGroupName
path True

string

Azure サブスクリプション内のリソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションの一意識別子。

api-version
query True

string

クライアント要求で使用される API のバージョン。

要求本文

名前 必須 説明
location True

string

リソースが保存されている地理的な場所

properties.input True

LiveEventInput

ライブ イベントの入力設定。 ライブ イベントがコントリビューション エンコーダーから入力を受け取る方法を定義します。

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

ライブ イベントのクロス サイト アクセス ポリシー。

properties.description

string

ライブ イベントの説明。

properties.encoding

LiveEventEncoding

ライブ イベントのエンコード設定。 ライブ エンコーダーをライブ イベントに使用するかどうかを構成し、ライブ エンコーダーを使用する場合は設定します。

properties.hostnamePrefix

string

useStaticHostname が true に設定されている場合、hostnamePrefix は、ライブ イベント プレビューと取り込みエンドポイントに割り当てられたホスト名の最初の部分を指定します。 最終的なホスト名は、このプレフィックス、メディア サービス アカウント名、および Azure Media Services データ センターの短いコードの組み合わせになります。

properties.preview

LiveEventPreview

ライブ イベント プレビューの設定。 プレビューを使用すると、ライブ イベント プロデューサーはライブ出力を作成せずにライブ ストリーミング コンテンツをプレビューできます。

properties.streamOptions

StreamOptionsFlag[]

LiveEvent に使用するオプション。 この値は作成時に指定され、更新できません。 配列エントリ値の有効な値は、'Default' と 'LowLatency' です。

properties.transcriptions

LiveEventTranscription[]

ライブ イベントのライブ文字起こし設定。 ライブ文字起こし機能の詳細については、以下を参照してください https://go.microsoft.com/fwlink/?linkid=2133742

properties.useStaticHostname

boolean

静的ホスト名をライブ イベント プレビューと取り込みエンドポイントに割り当てるかどうかを指定します。 この値は、ライブ イベントがスタンバイ状態の場合にのみ更新できます

tags

object

リソース タグ。

応答

名前 説明
200 OK

LiveEvent

OK です。 要求は成功しました。

202 Accepted

LiveEvent

受理されました。 要求は処理のために受け入れられ、操作は非同期的に完了します。 非同期 Azure 操作の監視の詳細については、「」を参照 https://go.microsoft.com/fwlink/?linkid=2087017 してください。

Other Status Codes

ErrorResponse

操作が失敗した理由を説明するストリーミング エラー応答。

Update a LiveEvent

Sample Request

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"
            }
          ]
        }
      }
    }
  }
}

Sample Response

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
    }
  }
}

定義

名前 説明
createdByType

リソースを作成した ID の種類。

CrossSiteAccessPolicies

クライアント アクセス ポリシー。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

IPAccessControl

IP アクセス制御。

IPRange

CIDR スキームの IP アドレス範囲。

LiveEvent

ライブ イベント。

LiveEventEncoding

ライブ イベントの種類と、ライブ イベントをエンコードするためのオプションのエンコード設定を指定します。

LiveEventEncodingType

ライブ イベントの種類。 encodingType が PassthroughBasic または PassthroughStandard に設定されている場合、サービスは受信したビデオレイヤーとオーディオレイヤーを単に出力に渡します。 encodingType が Standard または Premium1080p に設定されている場合、ライブ エンコーダーは受信ストリームを複数のビットレートまたはレイヤーにトランスコードします。 詳細については、「 https://go.microsoft.com/fwlink/?linkid=2095101 」を参照してください。 このプロパティは、ライブ イベントが作成された後は変更できません。

LiveEventEndpoint

ライブ イベント エンドポイント。

LiveEventInput

ライブ イベントの入力。

LiveEventInputAccessControl

ライブ イベント入力の IP アクセス制御。

LiveEventInputProtocol

ライブ イベントの入力プロトコル。 これは作成時に指定され、更新できません。

LiveEventInputTrackSelection

トラックの選択条件。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

LiveEventOutputTranscriptionTrack

音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

LiveEventPreview

ライブ イベントのプレビュー設定。

LiveEventPreviewAccessControl

ライブ イベント プレビュー エンドポイントの IP アクセス制御。

LiveEventResourceState

ライブ イベントのリソースの状態。 詳細については、「 https://go.microsoft.com/fwlink/?linkid=2139012 」を参照してください。

LiveEventTimedMetadataEndpoint

ライブ イベント メタデータ挿入エンドポイント。

LiveEventTranscription

音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは将来使用するために予約されています。このプロパティに設定された値は無視されます。

StreamOptionsFlag

LiveEvent に使用するオプション。 この値は作成時に指定され、更新できません。 配列エントリ値の有効な値は、'Default' と 'LowLatency' です。

StretchMode

目的の出力解像度に合わせて入力ビデオのサイズを変更する方法を指定します。 既定値は None です

systemData

リソースの作成と最後の変更に関連するメタデータ。

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

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

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

CrossSiteAccessPolicies

ライブ イベントのクロス サイト アクセス ポリシー。

properties.description

string

ライブ イベントの説明。

properties.encoding

LiveEventEncoding

ライブ イベントのエンコード設定。 ライブ エンコーダーをライブ イベントに使用するかどうかを構成し、ライブ エンコーダーを使用する場合は設定します。

properties.hostnamePrefix

string

useStaticHostname が true に設定されている場合、hostnamePrefix は、ライブ イベント プレビューと取り込みエンドポイントに割り当てられたホスト名の最初の部分を指定します。 最終的なホスト名は、このプレフィックス、メディア サービス アカウント名、および Azure Media Services データ センターの短いコードの組み合わせになります。

properties.input

LiveEventInput

ライブ イベントの入力設定。 ライブ イベントがコントリビューション エンコーダーから入力を受け取る方法を定義します。

properties.lastModified

string

ライブ イベントの最終変更時刻。

properties.preview

LiveEventPreview

ライブ イベントのプレビュー設定。 プレビューを使用すると、ライブ イベント プロデューサーはライブ出力を作成せずにライブ ストリーミング コンテンツをプレビューできます。

properties.provisioningState

string

ライブ イベントのプロビジョニング状態。

properties.resourceState

LiveEventResourceState

ライブ イベントのリソース状態。 詳細については、「 https://go.microsoft.com/fwlink/?linkid=2139012 」を参照してください。

properties.streamOptions

StreamOptionsFlag[]

LiveEvent に使用するオプション。 この値は作成時に指定され、更新できません。 配列エントリ値の有効な値は、'Default' と 'LowLatency' です。

properties.transcriptions

LiveEventTranscription[]

ライブ イベントのライブ文字起こし設定。 ライブ文字起こし機能の詳細については、「」を参照してください https://go.microsoft.com/fwlink/?linkid=2133742

properties.useStaticHostname

boolean

静的ホスト名をライブ イベント プレビューと取り込みエンドポイントに割り当てるかどうかを指定します。 この値は、ライブ イベントがスタンバイ状態の場合にのみ更新できます

systemData

systemData

このリソースに関連するシステム メタデータ。

tags

object

リソース タグ。

type

string

リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

LiveEventEncoding

ライブ イベントの種類と、ライブ イベントをエンコードするためのオプションのエンコード設定を指定します。

名前 説明
encodingType

LiveEventEncodingType

ライブ イベントの種類。 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

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

LiveEventInputAccessControl

ライブ イベント入力のアクセス制御。

accessToken

string

ストリームを一意に識別するための文字列形式の UUID。 これは作成時に指定できますが、更新することはできません。 省略すると、サービスによって一意の値が生成されます。

endpoints

LiveEventEndpoint[]

ライブ イベントの入力エンドポイント。

keyFrameIntervalDuration

string

入力のキー フレーム間隔期間の ISO 8601 時間。 この値は、HLS 出力の EXT-X-TARGETDURATION プロパティを設定します。 たとえば、PT2S を使用して 2 秒を示します。 ライブ イベントをエンコードする場合は、値を空のままにします。

streamingProtocol

LiveEventInputProtocol

ライブ イベントの入力プロトコル。 これは作成時に指定され、更新できません。

timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

ライブ イベントのメタデータ エンドポイント。

LiveEventInputAccessControl

ライブ イベント入力の IP アクセス制御。

名前 説明
ip

IPAccessControl

IP アクセス制御のプロパティ。

LiveEventInputProtocol

ライブ イベントの入力プロトコル。 これは作成時に指定され、更新できません。

名前 説明
FragmentedMP4

string

スムーズ ストリーミング入力は、コントリビューション エンコーダーによってライブ イベントに送信されます。

RTMP

string

RTMP 入力は、コントリビューション エンコーダーによってライブ イベントに送信されます。

LiveEventInputTrackSelection

トラックの選択条件。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

名前 説明
operation

string

操作の比較。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

property

string

選択するプロパティ名。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

value

string

選択するプロパティ値。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

LiveEventOutputTranscriptionTrack

音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

名前 説明
trackName

string

出力トラック名。 このプロパティは今後使用するために予約されています。このプロパティに設定された値はすべて無視されます。

LiveEventPreview

ライブ イベントのプレビュー設定。

名前 説明
accessControl

LiveEventPreviewAccessControl

ライブ イベント プレビューのアクセス制御。

alternativeMediaId

string

プレビュー用に作成されたストリーミング ロケーターに関連付けられている代替メディア識別子。 この値は作成時に指定され、更新できません。 識別子は、StreamingPolicyName フィールドで指定された StreamingPolicy の CustomLicenseAcquisitionUrlTemplate または CustomKeyAcquisitionUrlTemplate で使用できます。

endpoints

LiveEventEndpoint[]

プレビュー用のエンドポイント。 プレビュー URL をライブ イベントの対象ユーザーと共有しないでください。

previewLocator

string

Guid 形式のプレビュー ロケーターの識別子。 作成時にこれを指定すると、呼び出し元は、イベントが作成される前にプレビュー ロケーター URL を知ることができます。 省略すると、サービスによってランダムな識別子が生成されます。 ライブ イベントが作成されると、この値を更新できません。

streamingPolicyName

string

ライブ イベント プレビューに使用されるストリーミング ポリシーの名前。 この値は作成時に指定され、更新できません。

LiveEventPreviewAccessControl

ライブ イベント プレビュー エンドポイントの IP アクセス制御。

名前 説明
ip

IPAccessControl

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

LiveEventInputTrackSelection[]

音声テキスト変換の文字起こしが適用される入力ライブ フィードでオーディオ トラックを選択するメカニズムを提供します。 このプロパティは将来使用するために予約されています。このプロパティに設定された値は無視されます。

language

string

音声テキスト変換の文字起こしに使用する言語 (ロケール) を指定します。オーディオ トラックの音声言語と一致する必要があります。値は BCP-47 形式である必要があります (例: 'en-US')。 ライブ文字起こし機能の詳細と、サポートされている言語の一覧を参照してください https://go.microsoft.com/fwlink/?linkid=2133742

outputTranscriptionTrack

LiveEventOutputTranscriptionTrack

音声テキスト変換文字起こしを使用して生成されるライブ イベントの出力内の文字起こしトラックについて説明します。 このプロパティは将来使用するために予約されています。このプロパティに設定された値は無視されます。

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

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。