Live Events - Update

  • Referenz
Service:
Media Services
API Version:
2022-11-01

Updates Einstellungen für ein vorhandenes Liveereignis.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Media/mediaservices/{accountName}/liveEvents/{liveEventName}?api-version=2022-11-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
accountName
 path True

string

Der Name des Media Services-Kontos.
liveEventName
 path True

string

Der Name des Liveereignisses, die maximale Länge beträgt 32.

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

string

Der Name der Ressourcengruppe innerhalb des Azure-Abonnements.
subscriptionId
 path True

string

Der eindeutige Bezeichner für ein Microsoft Azure-Abonnement.
api-version
 query True

string

Die Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der geografische Standort, an dem sich die Ressource befindet
properties.input True

LiveEventInput

Eingabeeinstellungen für Liveereignisse. Es definiert, wie das Liveereignis eingaben von einem Beitragsencoder empfängt.
properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Websiteübergreifende Zugriffsrichtlinien für Liveereignisse.
properties.description

string

Eine Beschreibung für das Liveereignis.
properties.encoding

LiveEventEncoding

Codierungseinstellungen für das Liveereignis. Es konfiguriert, ob ein Liveencoder für das Liveereignis verwendet wird, und einstellungen für den Liveencoder, falls er verwendet wird.
properties.hostnamePrefix

string

Wenn useStaticHostname auf true festgelegt ist, gibt hostnamePrefix den ersten Teil des Hostnamens an, der der Liveereignisvorschau und den Erfassungsendpunkten zugewiesen ist. Der endgültige Hostname ist dann eine Kombination aus diesem Präfix, dem Media Services-Kontonamen und einem kurzen Code für das Azure Media Services-Rechenzentrum.
properties.preview

LiveEventPreview

Liveereignisvorschaueinstellungen. Mit der Vorschau können Liveereignisproduzenten eine Vorschau der Livestreaminginhalte anzeigen, ohne eine Liveausgabe zu erstellen.
properties.streamOptions

StreamOptionsFlag[]

Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".
properties.transcriptions

LiveEventTranscription[]

Livetranskriptionseinstellungen für das Liveereignis. Weitere Informationen zur Livetranskription finden Sie https://go.microsoft.com/fwlink/?linkid=2133742 unter.
properties.useStaticHostname

boolean

Gibt an, ob den Liveereignisvorschau- und Erfassungsendpunkten ein statischer Hostname zugewiesen wird. Dieser Wert kann nur aktualisiert werden, wenn sich das Liveereignis im Standbymodus befindet.
tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

LiveEvent

OK. Die Anforderung wurde erfolgreich durchgeführt.
202 Accepted

LiveEvent

Akzeptiert: Die Anforderung wurde für die Verarbeitung akzeptiert, und der Vorgang wird asynchron abgeschlossen. Weitere Informationen zur Überwachung asynchroner Azure-Vorgänge finden Sie https://go.microsoft.com/fwlink/?linkid=2087017 unter.
Other Status Codes

ErrorResponse

Die Streamingfehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Beispiele

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

Status code:
202 
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
Response Body
{
  "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
    }
  }
}
Status code:
200 
{
  "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
    }
  }
}

Definitionen

Name Beschreibung
createdByType

Der Identitätstyp, der die Ressource erstellt hat.
CrossSiteAccessPolicies

Die Clientzugriffsrichtlinie.
ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail

Die Fehlerdetails.
ErrorResponse

Fehlerantwort
IPAccessControl

Die IP-Zugriffssteuerung.
IPRange

Der IP-Adressbereich im CIDR-Schema.
LiveEvent

Das Liveereignis.
LiveEventEncoding

Gibt den Liveereignistyp und optionale Codierungseinstellungen für die Codierung von Liveereignissen an.
LiveEventEncodingType

Liveereignistyp. Wenn encodingType auf PassthroughBasic oder PassthroughStandard festgelegt ist, übergibt der Dienst einfach die eingehenden Video- und Audioebenen an die Ausgabe. Wenn encodingType auf Standard oder Premium1080p festgelegt ist, transcodiert ein Liveencoder den eingehenden Stream in mehrere Bitraten oder Ebenen. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095101. Diese Eigenschaft kann nicht geändert werden, nachdem das Liveereignis erstellt wurde.
LiveEventEndpoint

Der Endpunkt des Liveereignisses.
LiveEventInput

Die Liveereigniseingabe.
LiveEventInputAccessControl

Die IP-Zugriffssteuerung für die Liveereigniseingabe.
LiveEventInputProtocol

Das Eingabeprotokoll für das Liveereignis. Dies wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden.
LiveEventInputTrackSelection

Eine Trackauswahlbedingung. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
LiveEventOutputTranscriptionTrack

Beschreibt eine Transkriptionsspur in der Ausgabe eines Liveereignisses, die mithilfe der Sprach-zu-Text-Transkription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
LiveEventPreview

Liveereignisvorschaueinstellungen.
LiveEventPreviewAccessControl

Die IP-Zugriffssteuerung für den Liveereignisvorschauendpunkt.
LiveEventResourceState

Der Ressourcenstatus des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint

Der Liveereignismetadateneinfügungsendpunkt.
LiveEventTranscription

Beschreibt die Transkriptionsspuren in der Ausgabe eines Liveereignisses, das mithilfe der Spracherkennungstranskription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.
StreamOptionsFlag

Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".
StretchMode

Gibt an, wie die Größe des Eingabevideos an die gewünschte Ausgabeauflösung angepasst wird. Der Standardwert ist "None".
systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

Die Clientzugriffsrichtlinie.

Name Typ Beschreibung
clientAccessPolicy

string

Der Inhalt der von Silverlight verwendeten clientaccesspolicy.xml.
crossDomainPolicy

string

Der Inhalt der von Silverlight verwendeten crossdomain.xml.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.
type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

IPAccessControl

Die IP-Zugriffssteuerung.

Name Typ Beschreibung
allow

IPRange[]

Die IP-Zulassungsliste.

IPRange

Der IP-Adressbereich im CIDR-Schema.

Name Typ Beschreibung
address

string

Die IP-Adresse.
name

string

Der Anzeigename für den IP-Adressbereich.
subnetPrefixLength

integer

Die Präfixlänge der Subnetzmaske (siehe CIDR-Notation).

LiveEvent

Das Liveereignis.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Der geografische Standort, an dem sich die Ressource befindet
name

string

Der Name der Ressource
properties.created

string

Die Erstellungszeit für das Liveereignis
properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Websiteübergreifende Zugriffsrichtlinien für Liveereignisse.
properties.description

string

Eine Beschreibung für das Liveereignis.
properties.encoding

LiveEventEncoding

Codierungseinstellungen für das Liveereignis. Es konfiguriert, ob ein Liveencoder für das Liveereignis verwendet wird, und einstellungen für den Liveencoder, falls er verwendet wird.
properties.hostnamePrefix

string

Wenn useStaticHostname auf true festgelegt ist, gibt hostnamePrefix den ersten Teil des Hostnamens an, der der Liveereignisvorschau und den Erfassungsendpunkten zugewiesen ist. Der endgültige Hostname ist dann eine Kombination aus diesem Präfix, dem Media Services-Kontonamen und einem kurzen Code für das Azure Media Services-Rechenzentrum.
properties.input

LiveEventInput

Eingabeeinstellungen für Liveereignisse. Es definiert, wie das Liveereignis Eingaben von einem Beitragsencoder empfängt.
properties.lastModified

string

Der Zeitpunkt der letzten Änderung des Liveereignisses.
properties.preview

LiveEventPreview

Liveereignisvorschaueinstellungen. Mit der Vorschau können Liveereignisproduzenten eine Vorschau des Livestreaminginhalts anzeigen, ohne eine Liveausgabe zu erstellen.
properties.provisioningState

string

Der Bereitstellungsstatus des Liveereignisses.
properties.resourceState

LiveEventResourceState

Der Ressourcenstatus des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions

StreamOptionsFlag[]

Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".
properties.transcriptions

LiveEventTranscription[]

Livetranskriptionseinstellungen für das Liveereignis. Weitere Informationen zur Livetranskription finden Sie https://go.microsoft.com/fwlink/?linkid=2133742 unter.
properties.useStaticHostname

boolean

Gibt an, ob der Liveereignisvorschau und den Erfassungsendpunkten ein statischer Hostname zugewiesen wird. Dieser Wert kann nur aktualisiert werden, wenn sich das Liveereignis im Standbyzustand befindet.
systemData

systemData

Die Systemmetadaten, die sich auf diese Ressource beziehen.
tags

object

Ressourcentags.
type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Gibt den Liveereignistyp und optionale Codierungseinstellungen für die Codierung von Liveereignissen an.

Name Typ Beschreibung
encodingType

LiveEventEncodingType

Liveereignistyp. Wenn encodingType auf PassthroughBasic oder PassthroughStandard festgelegt ist, übergibt der Dienst einfach die eingehenden Video- und Audioebenen an die Ausgabe. Wenn encodingType auf Standard oder Premium1080p festgelegt ist, transkodiert ein Liveencoder den eingehenden Datenstrom in mehrere Bitraten oder Ebenen. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095101. Diese Eigenschaft kann nicht geändert werden, nachdem das Liveereignis erstellt wurde.
keyFrameInterval

string

Verwenden Sie einen ISO 8601-Zeitwert zwischen 0,5 und 20 Sekunden, um die Länge des Ausgabefragments für die Video- und Audiospuren eines Codierungs-Liveereignisses anzugeben. Verwenden Sie beispielsweise PT2S, um 2 Sekunden anzugeben. Für die Videospur wird auch das Keyframeintervall oder die Länge eines GoP (Gruppe von Bildern) definiert. Wenn dieser Wert nicht für ein Codierungs-Liveereignis festgelegt ist, beträgt die Fragmentdauer standardmäßig 2 Sekunden. Der Wert kann nicht für Passthrough-Liveereignisse festgelegt werden.
presetName

string

Der optionale Codierungsvoreinstellungsname, der verwendet wird, wenn encodingType nicht None ist. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Wenn encodingType auf Standard festgelegt ist, lautet der Standardvoreinstellungsname "Default720p". Andernfalls, wenn encodingType auf Premium1080p festgelegt ist, lautet die Standardvoreinstellung "Default1080p".
stretchMode

StretchMode

Gibt an, wie die Größe des Eingabevideos an die gewünschte Ausgabeauflösung angepasst wird. Der Standardwert ist "None".

LiveEventEncodingType

Liveereignistyp. Wenn encodingType auf PassthroughBasic oder PassthroughStandard festgelegt ist, übergibt der Dienst einfach die eingehenden Video- und Audioebenen an die Ausgabe. Wenn encodingType auf Standard oder Premium1080p festgelegt ist, transcodiert ein Liveencoder den eingehenden Stream in mehrere Bitraten oder Ebenen. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2095101. Diese Eigenschaft kann nicht geändert werden, nachdem das Liveereignis erstellt wurde.

Name Typ Beschreibung
None

string

Dies ist identisch mit PassthroughStandard. Weitere Informationen finden Sie in der folgenden Beschreibung. Dieser Enumerationswert ist veraltet.
PassthroughBasic

string

Der erfasste Stream durchläuft das Liveereignis vom Beitragsencoder ohne weitere Verarbeitung. Im PassthroughBasic-Modus ist die Erfassung auf bis zu 5 Mbit/s beschränkt, und nur eine gleichzeitige Liveausgabe ist zulässig. Die Livetranskription ist nicht verfügbar.
PassthroughStandard

string

Der erfasste Stream durchläuft das Liveereignis vom Beitragsencoder ohne weitere Verarbeitung. Die Livetranskription ist verfügbar. Die Grenzwerte für die Erfassungsbitrate sind viel höher, und es sind bis zu 3 gleichzeitige Liveausgaben zulässig.
Premium1080p

string

Ein Beitrags-Liveencoder sendet einen einzelnen Bitratestream an das Liveereignis, und Media Services erstellt mehrere Bitratedatenströme. Die Ausgabe darf die Auflösung von 1080p nicht überschreiten.
Standard

string

Ein Beitrags-Liveencoder sendet einen einzelnen Bitratestream an das Liveereignis, und Media Services erstellt mehrere Bitratedatenströme. Die Ausgabe darf die Auflösung von 720p nicht überschreiten.

LiveEventEndpoint

Der Endpunkt des Liveereignisses.

Name Typ Beschreibung
protocol

string

Das Endpunktprotokoll.
url

string

Die Endpunkt-URL.

LiveEventInput

Die Liveereigniseingabe.

Name Typ Beschreibung
accessControl

LiveEventInputAccessControl

Zugriffssteuerung für Die Eingabe von Liveereignissen.
accessToken

string

Eine UUID in Zeichenfolgenform, um den Stream eindeutig zu identifizieren. Dies kann bei der Erstellung angegeben, aber nicht aktualisiert werden. Wenn er nicht angegeben wird, generiert der Dienst einen eindeutigen Wert.
endpoints

LiveEventEndpoint[]

Die Eingabeendpunkte für das Liveereignis.
keyFrameIntervalDuration

string

ISO 8601 Zeitdauer der Keyframeintervalldauer der Eingabe. Dieser Wert legt die EXT-X-TARGETDURATION-Eigenschaft in der HLS-Ausgabe fest. Verwenden Sie beispielsweise PT2S, um 2 Sekunden anzugeben. Lassen Sie den Wert für die Codierung von Liveereignissen leer.
streamingProtocol

LiveEventInputProtocol

Das Eingabeprotokoll für das Liveereignis. Dies wird bei der Erstellung angegeben und kann nicht aktualisiert werden.
timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

Die Metadatenendpunkte für das Liveereignis.

LiveEventInputAccessControl

Die IP-Zugriffssteuerung für die Liveereigniseingabe.

Name Typ Beschreibung
ip

IPAccessControl

Die IP-Zugriffssteuerungseigenschaften.

LiveEventInputProtocol

Das Eingabeprotokoll für das Liveereignis. Dies wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden.

Name Typ Beschreibung
FragmentedMP4

string

Die Smooth Streaming-Eingabe wird vom Beitragsencoder an das Liveereignis gesendet.
RTMP

string

DIE RTMP-Eingabe wird vom Beitragsencoder an das Liveereignis gesendet.

LiveEventInputTrackSelection

Eine Trackauswahlbedingung. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

Name Typ Beschreibung
operation

string

Vergleichsvorgang. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
property

string

Eigenschaftenname, der ausgewählt werden soll. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
value

string

Eigenschaftenwert, der ausgewählt werden soll. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

LiveEventOutputTranscriptionTrack

Beschreibt eine Transkriptionsspur in der Ausgabe eines Liveereignisses, die mithilfe der Sprach-zu-Text-Transkription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

Name Typ Beschreibung
trackName

string

Der Name der Ausgabespur. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.

LiveEventPreview

Liveereignisvorschaueinstellungen.

Name Typ Beschreibung
accessControl

LiveEventPreviewAccessControl

Die Zugriffssteuerung für die Liveereignisvorschau.
alternativeMediaId

string

Ein alternativer Medienbezeichner, der dem streaminglocator zugeordnet ist, der für die Vorschau erstellt wurde. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Der Bezeichner kann in customLicenseAcquisitionUrlTemplate oder CustomKeyAcquisitionUrlTemplate der im Feld StreamingPolicyName angegebenen StreamingPolicy verwendet werden.
endpoints

LiveEventEndpoint[]

Die Endpunkte für die Vorschau. Geben Sie die Vorschau-URL nicht für die Liveereignis-Zielgruppe weiter.
previewLocator

string

Der Bezeichner des Vorschaulocators im GUID-Format. Wenn Sie dies bei der Erstellung angeben, kann der Aufrufer die Vorschaulocator-URL kennen, bevor das Ereignis erstellt wird. Wenn nicht angegeben, generiert der Dienst einen zufälligen Bezeichner. Dieser Wert kann nicht aktualisiert werden, nachdem das Liveereignis erstellt wurde.
streamingPolicyName

string

Der Name der Streamingrichtlinie, die für die Liveereignisvorschau verwendet wird. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden.

LiveEventPreviewAccessControl

Die IP-Zugriffssteuerung für den Liveereignisvorschauendpunkt.

Name Typ Beschreibung
ip

IPAccessControl

Die IP-Zugriffssteuerungseigenschaften.

LiveEventResourceState

Der Ressourcenstatus des Liveereignisses. Weitere Informationen finden Sie unter https://go.microsoft.com/fwlink/?linkid=2139012.

Name Typ Beschreibung
Allocating

string

Die Zuordnungsaktion wurde für das Liveereignis aufgerufen, und für dieses Liveereignis werden Ressourcen bereitgestellt. Sobald die Zuordnung erfolgreich abgeschlossen wurde, wechselt das Liveereignis in den Status "StandBy".
Deleting

string

Das Liveereignis wird gelöscht. In diesem Übergangszustand erfolgt keine Berechnung. In diesem Zustand sind weder Updates noch Streaming zulässig.
Running

string

Die Liveereignisressourcen wurden zugewiesen, Erfassungs- und Vorschau-URLs wurden generiert, und Livestreams können empfangen werden. Zu diesem Zeitpunkt ist die Abrechnung aktiv. Sie müssen für die Liveereignisressource explizit „Beenden“ auswählen, damit keine Gebühren mehr anfallen.
StandBy

string

Liveereignisressourcen wurden bereitgestellt und können gestartet werden. In diesem Status werden Gebühren berechnet. Die meisten Eigenschaften können weiterhin aktualisiert werden, allerdings ist die Erfassung oder das Streaming während dieses Zustands nicht zulässig.
Starting

string

Das Liveereignis wird gestartet und Ressourcen werden zugewiesen. In diesem Status werden keine Gebühren berechnet. In diesem Zustand sind weder Updates noch Streaming zulässig. Wenn ein Fehler auftritt, wird das Liveereignis in den Zustand „Angehalten“ zurückgesetzt.
Stopped

string

Dies ist der anfängliche Zustand des Liveereignisses nach der Erstellung (es sei denn, der automatische Start wurde auf „true“ festgelegt). In diesem Status werden keine Gebühren berechnet. In diesem Zustand können die Liveereigniseigenschaften aktualisiert werden, streaming ist jedoch nicht zulässig.
Stopping

string

Das Liveereignis wird beendet und die Bereitstellung der Ressourcen aufgehoben. In diesem Übergangszustand erfolgt keine Berechnung. In diesem Zustand sind weder Updates noch Streaming zulässig.

LiveEventTimedMetadataEndpoint

Der Liveereignismetadateneinfügungsendpunkt.

Name Typ Beschreibung
url

string

Die Metadatenendpunkt-URL.

LiveEventTranscription

Beschreibt die Transkriptionsspuren in der Ausgabe eines Liveereignisses, das mithilfe der Spracherkennungstranskription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.

Name Typ Beschreibung
inputTrackSelection

LiveEventInputTrackSelection[]

Stellt einen Mechanismus zum Auswählen der Audiospur im Eingabe-Livefeed bereit, auf den die Sprach-in-Text-Transkription angewendet wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.
language

string

Gibt die Sprache (Gebietsschema) an, die für die Spracherkennungstranskription verwendet werden soll. Sie sollte mit der gesprochenen Sprache in der Audiospur übereinstimmen. Der Wert sollte im BCP-47-Format vorliegen (z. B. "en-US"). Weitere Informationen zur Livetranskription und zur Liste der unterstützten Sprachen finden Sie https://go.microsoft.com/fwlink/?linkid=2133742 unter.
outputTranscriptionTrack

LiveEventOutputTranscriptionTrack

Beschreibt eine Transkriptionsspur in der Ausgabe eines Liveereignisses, die mithilfe der Spracherkennungstranskription generiert wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.

StreamOptionsFlag

Die Optionen, die für das LiveEvent verwendet werden sollen. Dieser Wert wird bei der Erstellung angegeben und kann nicht aktualisiert werden. Die gültigen Werte für die Arrayeintragswerte sind "Default" und "LowLatency".

Name Typ Beschreibung
Default

string

Livestreaming ohne spezielle Latenzoptimierungen.
LowLatency

string

Das Liveereignis bietet eine niedrigere End-to-End-Latenz, indem die internen Puffer reduziert werden.
LowLatencyV2

string

Das Liveereignis ist für end-to-End-Latenz optimiert. Diese Option ist nur für die Codierung von Liveereignissen mit RTMP-Eingabe verfügbar. Die Ausgaben können im HLS- oder DASH-Format gestreamt werden. Die Länge des Archiv- oder DVR-Rücklaufs der Ausgaben ist auf 6 Stunden beschränkt. Verwenden Sie die Streamoption "LowLatency" für alle anderen Szenarien.

StretchMode

Gibt an, wie die Größe des Eingabevideos an die gewünschte Ausgabeauflösung angepasst wird. Der Standardwert ist "None".

Name Typ Beschreibung
AutoFit

string

Binden Sie die Ausgabe (entweder mit Briefkasten oder Säulenfeld) ein, um die Ausgabeauflösung zu berücksichtigen, und stellen Sie sicher, dass der aktive Videobereich in der Ausgabe das gleiche Seitenverhältnis wie die Eingabe aufweist. Wenn die Eingabe beispielsweise 1920x1080 ist und die Codierungsvoreinstellung nach 1280 x 1280 fragt, liegt die Ausgabe bei 1280 x 1280, die ein inneres Rechteck von 1280x720 im Seitenverhältnis von 16:9 und Säulenfeldbereiche mit einer Breite von 280 Pixeln links und rechts enthält.
AutoSize

string

Überschreiben Sie die Ausgabeauflösung, und ändern Sie sie so, dass sie dem Anzeigeseitenverhältnis der Eingabe ohne Auffüllung entspricht. Wenn die Auflösung der Eingabe beispielsweise 1920 × 1080 ist und die Codierungsvoreinstellung 1280 × 1280 fordert, wird der Wert in der Voreinstellung außer Kraft gesetzt, und die Ausgabe erfolgt in 1280 × 720, sodass das Eingabeseitenverhältnis von 16 : 9 beibehalten wird.
None

string

Berücksichtigt streng die in der Codierungsvoreinstellung angegebene Ausgabeauflösung, ohne das Pixelseitenverhältnis oder das Anzeigeseitenverhältnis des Eingabevideos zu berücksichtigen.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy

string

Die Identität, die die Ressource erstellt hat.
createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.