Live Events - Create

Referenz

Dienst:: 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

Mit optionalen Parametern:

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-Muster: `^[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

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


import com.azure.resourcemanager.mediaservices.models.IpAccessControl;
import com.azure.resourcemanager.mediaservices.models.IpRange;
import com.azure.resourcemanager.mediaservices.models.LiveEventInput;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputAccessControl;
import com.azure.resourcemanager.mediaservices.models.LiveEventInputProtocol;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreview;
import com.azure.resourcemanager.mediaservices.models.LiveEventPreviewAccessControl;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for LiveEvents Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mediaservices/resource-manager/Microsoft.Media/Streaming/stable/2022-11-01/examples/liveevent-
     * create.json
     */
    /**
     * Sample code: Create a LiveEvent.
     * 
     * @param manager Entry point to MediaServicesManager.
     */
    public static void createALiveEvent(com.azure.resourcemanager.mediaservices.MediaServicesManager manager) {
        manager.liveEvents().define("myLiveEvent1").withRegion("West US")
            .withExistingMediaservice("mediaresources", "slitestmedia10")
            .withTags(mapOf("tag1", "value1", "tag2", "value2")).withDescription("test event 1")
            .withInput(new LiveEventInput().withStreamingProtocol(LiveEventInputProtocol.RTMP)
                .withAccessControl(new LiveEventInputAccessControl().withIp(new IpAccessControl().withAllow(Arrays
                    .asList(new IpRange().withName("AllowAll").withAddress("0.0.0.0").withSubnetPrefixLength(0)))))
                .withKeyFrameIntervalDuration("fakeTokenPlaceholder"))
            .withPreview(new LiveEventPreview()
                .withAccessControl(new LiveEventPreviewAccessControl().withIp(new IpAccessControl().withAllow(Arrays
                    .asList(new IpRange().withName("AllowAll").withAddress("0.0.0.0").withSubnetPrefixLength(0))))))
            .create();
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:: 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

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

Statuscode:: 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.

Freigeben über