Live Events - Create

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

Erstellen eines Liveereignisses
Erstellt ein neues Liveereignis.

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

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.
autoStart
 query

boolean

Das Flag gibt an, ob die Ressource bei der Erstellung automatisch gestartet 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 des Livestreaminginhalts 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.
201 Created

LiveEvent

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

ErrorResponse

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

Beispiele

Create a LiveEvent

Sample Request

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

Sample Response

Status code:
201 
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"
  },
  "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
    }
  }
}
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"
  },
  "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
    }
  }
}

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, 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.
LiveEventEndpoint

Der Liveereignisendpunkt.
LiveEventInput

Die Liveereigniseingabe.
LiveEventInputAccessControl

Die IP-Zugriffssteuerung für die Liveereigniseingabe.
LiveEventInputProtocol

Das Eingabeprotokoll für das Liveereignis. Dies wird bei der Erstellung 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 wird, wird ignoriert.
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.
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 Liveereignis-Metadateneinfügungsendpunkt.
LiveEventTranscription

Beschreibt die Transkriptionsspuren in der Ausgabe eines Liveereignisses, die mithilfe der Sprach-zu-Text-Transkription generiert werden. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, wird ignoriert.
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".
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 von clientaccesspolicy.xml, die von Silverlight verwendet werden.
crossDomainPolicy

string

Der Inhalt von crossdomain.xml, die von Silverlight verwendet werden.

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

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 der Livestreaminginhalte 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 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.
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, 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.
keyFrameInterval

string

Verwenden Sie einen ISO 8601-Zeitwert zwischen 0,5 und 20 Sekunden, um die Ausgabefragmentlänge für die Video- und Audiospuren eines Codierungs-Liveereignisses anzugeben. Verwenden Sie z. B. PT2S, um 2 Sekunden anzugeben. Für die Videospur definiert er auch das Keyframeintervall oder die Länge eines GoP (Bildgruppe). 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 voreingestellte Codierungsname, der verwendet wird, wenn encodingType nicht None ist. Dieser Wert wird zur Erstellungszeit angegeben und kann nicht aktualisiert werden. Wenn der encodingType auf Standard festgelegt ist, lautet der standardvoreingestellte Name "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, 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.

Name Typ Beschreibung
None

string

Dies ist identisch mit PassthroughStandard. Weitere Informationen finden Sie unten in der 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. Livetranskription ist verfügbar. Die Grenzwerte für die Erfassungsbitrate sind viel höher, und bis zu 3 gleichzeitige Liveausgaben sind zulässig.
Premium1080p

string

Ein Beitrags-Liveencoder sendet einen Stream mit einer einzelnen Bitrate an das Liveereignis, und Media Services erstellt mehrere Bitratenstreams. Die Ausgabe darf 1080p in der Auflösung nicht überschreiten.
Standard

string

Ein Beitrags-Liveencoder sendet einen Stream mit einer einzelnen Bitrate an das Liveereignis, und Media Services erstellt mehrere Bitratenstreams. Die Ausgabe darf die Auflösung von 720p nicht überschreiten.

LiveEventEndpoint

Der Liveereignisendpunkt.

Name Typ Beschreibung
protocol

string

Das Endpunktprotokoll.
url

string

Die Endpunkt-URL.

LiveEventInput

Die Liveereigniseingabe.

Name Typ Beschreibung
accessControl

LiveEventInputAccessControl

Zugriffssteuerung für die Liveereigniseingabe.
accessToken

string

Eine UUID in Zeichenfolgenform, um den Stream eindeutig zu identifizieren. Dies kann bei der Erstellung angegeben, aber nicht aktualisiert werden. Wenn er ausgelassen 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 z. B. 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 zur Erstellungszeit 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 bei der Erstellung angegeben und kann nicht aktualisiert werden.

Name Typ Beschreibung
FragmentedMP4

string

Smooth Streaming-Eingaben werden 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 wird, 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 wird, 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 wird, wird ignoriert.
value

string

Auszuwählende Eigenschaftswert. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt wird, wird ignoriert.

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.

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 wird, 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 zur Erstellungszeit angegeben und kann nicht aktualisiert werden. Der Bezeichner kann in customLicenseAcquisitionUrlTemplate oder CustomKeyAcquisitionUrlTemplate der streamingPolicy im Feld StreamingPolicyName angegeben werden.
endpoints

LiveEventEndpoint[]

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

string

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

string

Der Name der Streamingrichtlinie, die für die Liveereignisvorschau verwendet wird. Dieser Wert wird zur Erstellungszeit 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 Ressourcen werden für dieses Liveereignis bereitgestellt. Nachdem 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 zugeordnet. 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, aber das Streaming ist 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 Liveereignis-Metadateneinfügungsendpunkt.

Name Typ Beschreibung
url

string

Die Metadatenendpunkt-URL.

LiveEventTranscription

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

Name Typ Beschreibung
inputTrackSelection

LiveEventInputTrackSelection[]

Stellt einen Mechanismus zum Auswählen der Audiospur im Eingabe-Livefeed bereit, auf den die Sprach-zu-Text-Transkription angewendet wird. Diese Eigenschaft ist für die zukünftige Verwendung reserviert. Jeder wert, der für diese Eigenschaft festgelegt ist, 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 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.

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".

Name Typ Beschreibung
Default

string

Livestreaming ohne spezielle Latenzoptimierungen.
LowLatency

string

Das Liveereignis bietet eine geringere End-to-End-Latenz, indem es seine internen Puffer reduziert.
LowLatencyV2

string

Das Liveereignis ist für die 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 Archiv- oder DVR-Rücklauflänge der Ausgaben ist auf 6 Stunden begrenzt. 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

Polstern Sie die Ausgabe (entweder mit Briefkasten oder Säulenfeld), 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 1920 x 1080 ist und die Codierungsvoreinstellung 1280 x 1280 fordert, liegt die Ausgabe bei 1280 x 1280, die ein inneres Rechteck von 1280 x 720 bei einem Seitenverhältnis von 16:9 und 280 Pixel breite Säulenfeldbereiche links und rechts enthält.
AutoSize

string

Überschreiben Sie die Ausgabeauflösung, und ändern Sie sie so, dass sie dem Anzeigeseitenverhältnis der Eingabe entspricht, ohne dass abstandslos ist. 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.