Live Events - Create

Referentie

Service:: Media Services

API Version:: 2022-11-01

Livegebeurtenis maken
Hiermee maakt u een nieuwe livegebeurtenis.

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

Name	In	Vereist	Type	Description
accountName	path	True	string	De naam van het Media Services-account.
liveEventName	path	True	string	De naam van de livegebeurtenis, de maximale lengte is 32. Regex pattern: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	De naam van de resourcegroep binnen het Azure-abonnement.
subscriptionId	path	True	string	De unieke id voor een Microsoft Azure-abonnement.
api-version	query	True	string	De versie van de API die moet worden gebruikt met de clientaanvraag.
autoStart	query		boolean	De vlag geeft aan of de resource automatisch moet worden gestart bij het maken.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
properties.input	True	LiveEventInput	Invoerinstellingen voor livegebeurtenissen. Hiermee wordt gedefinieerd hoe de livegebeurtenis invoer ontvangt van een bijdrage-encoder.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Toegangsbeleid voor livegebeurtenissen op meerdere sites.
properties.description		string	Een beschrijving voor de livegebeurtenis.
properties.encoding		LiveEventEncoding	Coderingsinstellingen voor de livegebeurtenis. Hiermee configureert u of een live-encoder wordt gebruikt voor de livegebeurtenis en instellingen voor de live-encoder als deze wordt gebruikt.
properties.hostnamePrefix		string	Wanneer useStaticHostname is ingesteld op true, geeft de hostnaamPrefix het eerste deel van de hostnaam die is toegewezen aan de voorbeeldweergave van de livegebeurtenis en opname-eindpunten. De uiteindelijke hostnaam is een combinatie van dit voorvoegsel, de naam van het mediaserviceaccount en een korte code voor het Azure Media Services-datacenter.
properties.preview		LiveEventPreview	Voorbeeldinstellingen voor livegebeurtenissen. Met Preview kunnen producenten van livegebeurtenissen een voorbeeld van de live streaming-inhoud bekijken zonder live-uitvoer te maken.
properties.streamOptions		StreamOptionsFlag[]	De opties die moeten worden gebruikt voor de LiveEvent. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt. De geldige waarden voor de matrixinvoerwaarden zijn Standaard en LaagLatency.
properties.transcriptions		LiveEventTranscription[]	Instellingen voor livetranscriptie voor de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2133742 voor meer informatie over de functie voor livetranscriptie.
properties.useStaticHostname		boolean	Hiermee geeft u op of een statische hostnaam moet worden toegewezen aan de voorbeeld- en opname-eindpunten van de livegebeurtenis. Deze waarde kan alleen worden bijgewerkt als de livegebeurtenis de status Stand-by heeft
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	LiveEvent	OK. De aanvraag is voltooid.
201 Created	LiveEvent	Gemaakt. De aanvraag is geaccepteerd voor verwerking en de bewerking wordt asynchroon voltooid. Zie https://go.microsoft.com/fwlink/?linkid=2087017 voor meer informatie over het bewaken van asynchrone Azure-bewerkingen met behulp van de Azure-AsyncOperation antwoordheader.
Other Status Codes	ErrorResponse	Het antwoord van de streamingfout beschrijft waarom de bewerking is mislukt.

Voorbeelden

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();
    }

    @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

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

Definities

Name	Description
createdByType	Het type identiteit waarmee de resource is gemaakt.
CrossSiteAccessPolicies	Het clienttoegangsbeleid.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
IPAccessControl	Het IP-toegangsbeheer.
IPRange	Het IP-adresbereik in het CIDR-schema.
LiveEvent	De livegebeurtenis.
LiveEventEncoding	Hiermee geeft u het type livegebeurtenis en optionele coderingsinstellingen voor het coderen van livegebeurtenissen op.
LiveEventEncodingType	Type livegebeurtenis. Wanneer encodingType is ingesteld op PassthroughBasic of PassthroughStandard, wordt de binnenkomende video- en audiolaag(en) doorgegeven aan de uitvoer. Wanneer encodingType is ingesteld op Standard of Premium1080p, wordt de binnenkomende stroom met een live coderingsprogramma omgezet in meerdere bitrates of lagen. Zie https://go.microsoft.com/fwlink/?linkid=2095101 voor meer informatie. Deze eigenschap kan niet worden gewijzigd nadat de livegebeurtenis is gemaakt.
LiveEventEndpoint	Het eindpunt van de livegebeurtenis.
LiveEventInput	De invoer van de livegebeurtenis.
LiveEventInputAccessControl	Het IP-toegangsbeheer voor invoer van livegebeurtenissen.
LiveEventInputProtocol	Het invoerprotocol voor de livegebeurtenis. Dit wordt opgegeven tijdens het maken en kan niet worden bijgewerkt.
LiveEventInputTrackSelection	Een voorwaarde voor het bijhouden van een selectie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.
LiveEventOutputTranscriptionTrack	Beschrijft een transcriptiespoor in de uitvoer van een livegebeurtenis, gegenereerd met spraak-naar-teksttranscriptie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.
LiveEventPreview	Instellingen voor livegebeurtenisvoorbeeld.
LiveEventPreviewAccessControl	Het IP-toegangsbeheer voor het eindpunt van de livegebeurtenisvoorbeeld.
LiveEventResourceState	De resourcestatus van de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2139012 voor meer informatie.
LiveEventTimedMetadataEndpoint	Het eindpunt voor het invoegen van metagegevens van livegebeurtenissen.
LiveEventTranscription	Beschrijft de transcriptiesporen in de uitvoer van een livegebeurtenis, gegenereerd met spraak-naar-teksttranscriptie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.
StreamOptionsFlag	De opties die moeten worden gebruikt voor de LiveEvent. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt. De geldige waarden voor de matrixinvoerwaarden zijn 'Default' en 'LowLatency'.
StretchMode	Hiermee geeft u op hoe het formaat van de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is Geen
systemData	Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Het clienttoegangsbeleid.

Name	Type	Description
clientAccessPolicy	string	De inhoud van clientaccesspolicy.xml gebruikt door Silverlight.
crossDomainPolicy	string	De inhoud van crossdomain.xml gebruikt door Silverlight.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

IPAccessControl

Het IP-toegangsbeheer.

Name	Type	Description
allow	IPRange[]	De lijst met toegestane IP-adressen.

IPRange

Het IP-adresbereik in het CIDR-schema.

Name	Type	Description
address	string	Het IP-adres.
name	string	De beschrijvende naam voor het IP-adresbereik.
subnetPrefixLength	integer	De lengte van het voorvoegsel van het subnetmasker (zie CIDR-notatie).

LiveEvent

De livegebeurtenis.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.created	string	De aanmaaktijd voor de livegebeurtenis
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Toegangsbeleid voor livegebeurtenissen op meerdere sites.
properties.description	string	Een beschrijving voor de livegebeurtenis.
properties.encoding	LiveEventEncoding	Coderingsinstellingen voor de livegebeurtenis. Hiermee configureert u of een live-encoder wordt gebruikt voor de livegebeurtenis en instellingen voor de live-encoder als deze wordt gebruikt.
properties.hostnamePrefix	string	Wanneer useStaticHostname is ingesteld op true, geeft hostnamePrefix het eerste deel van de hostnaam op die is toegewezen aan de voorbeeldweergave van de livegebeurtenis en opname-eindpunten. De uiteindelijke hostnaam is een combinatie van dit voorvoegsel, de accountnaam van de mediaservice en een korte code voor het Azure Media Services-datacenter.
properties.input	LiveEventInput	Invoerinstellingen voor livegebeurtenissen. Hiermee wordt gedefinieerd hoe de livegebeurtenis invoer ontvangt van een bijdrage-encoder.
properties.lastModified	string	De laatste wijzigingstijd van de livegebeurtenis.
properties.preview	LiveEventPreview	Instellingen voor livegebeurtenisvoorbeeld. Met Preview kunnen producenten van livegebeurtenissen een voorbeeld van de livestreaming-inhoud bekijken zonder live-uitvoer te maken.
properties.provisioningState	string	De inrichtingsstatus van de livegebeurtenis.
properties.resourceState	LiveEventResourceState	De resourcestatus van de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2139012 voor meer informatie.
properties.streamOptions	StreamOptionsFlag[]	De opties die moeten worden gebruikt voor de LiveEvent. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt. De geldige waarden voor de matrixinvoerwaarden zijn 'Default' en 'LowLatency'.
properties.transcriptions	LiveEventTranscription[]	Instellingen voor livetranscriptie voor de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2133742 voor meer informatie over de functie voor livetranscriptie.
properties.useStaticHostname	boolean	Hiermee geeft u op of een statische hostnaam moet worden toegewezen aan de livegebeurtenisvoorbeeld en opname-eindpunten. Deze waarde kan alleen worden bijgewerkt als de livegebeurtenis de stand-bystatus heeft
systemData	systemData	De systeemmetagegevens met betrekking tot deze resource.
tags	object	Resourcetags.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

LiveEventEncoding

Hiermee geeft u het type livegebeurtenis en optionele coderingsinstellingen voor het coderen van livegebeurtenissen op.

Name	Type	Description
encodingType	LiveEventEncodingType	Type livegebeurtenis. Wanneer encodingType is ingesteld op PassthroughBasic of PassthroughStandard, wordt de binnenkomende video- en audiolaag(en) doorgegeven aan de uitvoer. Wanneer encodingType is ingesteld op Standard of Premium1080p, wordt de binnenkomende stream met een live-encoder omgezet in meerdere bitrates of lagen. Zie https://go.microsoft.com/fwlink/?linkid=2095101 voor meer informatie. Deze eigenschap kan niet worden gewijzigd nadat de livegebeurtenis is gemaakt.
keyFrameInterval	string	Gebruik een ISO 8601-tijdswaarde tussen 0,5 en 20 seconden om de lengte van het uitvoerfragment op te geven voor de video- en audiosporen van een coderings livegebeurtenis. Gebruik bijvoorbeeld PT2S om 2 seconden aan te geven. Voor de videotrack definieert het ook het sleutelframeinterval of de lengte van een GoP (groep afbeeldingen). Als deze waarde niet is ingesteld voor een coderings livegebeurtenis, wordt de fragmentduur standaard ingesteld op 2 seconden. De waarde kan niet worden ingesteld voor passthrough-livegebeurtenissen.
presetName	string	De optionele naam van de vooraf ingestelde codering, die wordt gebruikt wanneer encodingType niet Geen is. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt. Als encodingType is ingesteld op Standard, is de standaardnaam van de vooraf ingestelde standaardinstelling 'Default720p'. Als het encodingType anders is ingesteld op Premium1080p, is de standaardinstelling 'Default1080p'.
stretchMode	StretchMode	Hiermee geeft u op hoe het formaat van de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is Geen

LiveEventEncodingType

Type livegebeurtenis. Wanneer encodingType is ingesteld op PassthroughBasic of PassthroughStandard, wordt de binnenkomende video- en audiolaag(en) doorgegeven aan de uitvoer. Wanneer encodingType is ingesteld op Standard of Premium1080p, wordt de binnenkomende stroom met een live coderingsprogramma omgezet in meerdere bitrates of lagen. Zie https://go.microsoft.com/fwlink/?linkid=2095101 voor meer informatie. Deze eigenschap kan niet worden gewijzigd nadat de livegebeurtenis is gemaakt.

Name	Type	Description
None	string	Dit is hetzelfde als PassthroughStandard. Zie de beschrijving hieronder. Deze opsommingswaarde wordt afgeschaft.
PassthroughBasic	string	De opgenomen stream passeert de livegebeurtenis van de bijdrage-encoder zonder verdere verwerking. In de passthroughBasic-modus is opname beperkt tot maximaal 5 Mbps en is slechts 1 gelijktijdige live-uitvoer toegestaan. Livetranscriptie is niet beschikbaar.
PassthroughStandard	string	De opgenomen stream passeert de livegebeurtenis van de bijdrage-encoder zonder verdere verwerking. Livetranscriptie is beschikbaar. Bitratelimieten voor opname zijn veel hoger en er zijn maximaal 3 gelijktijdige live-uitvoer toegestaan.
Premium1080p	string	Een bijdrage live encoder verzendt een single bitrate stream naar de livegebeurtenis en Media Services maakt meerdere bitrate streams. De uitvoer mag niet groter zijn dan 1080p in resolutie.
Standard	string	Een bijdrage live encoder verzendt een single bitrate stream naar de livegebeurtenis en Media Services maakt meerdere bitrate streams. De uitvoer mag niet groter zijn dan 720p in resolutie.

LiveEventEndpoint

Het eindpunt van de livegebeurtenis.

Name	Type	Description
protocol	string	Het eindpuntprotocol.
url	string	De eindpunt-URL.

LiveEventInput

De invoer van de livegebeurtenis.

Name	Type	Description
accessControl	LiveEventInputAccessControl	Toegangsbeheer voor invoer van livegebeurtenissen.
accessToken	string	Een UUID in tekenreeksvorm om de stroom uniek te identificeren. Dit kan worden opgegeven tijdens het maken, maar kan niet worden bijgewerkt. Als u dit weglaat, genereert de service een unieke waarde.
endpoints	LiveEventEndpoint[]	De invoereindpunten voor de livegebeurtenis.
keyFrameIntervalDuration	string	ISO 8601-tijdsduur van het sleutelframeinterval van de invoer. Met deze waarde wordt de eigenschap EXT-X-TARGETDURATION in de HLS-uitvoer ingesteld. Gebruik bijvoorbeeld PT2S om 2 seconden aan te geven. Laat de waarde leeg voor het coderen van livegebeurtenissen.
streamingProtocol	LiveEventInputProtocol	Het invoerprotocol voor de livegebeurtenis. Dit wordt opgegeven tijdens het maken en kan niet worden bijgewerkt.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	De metagegevenseindpunten voor de livegebeurtenis.

LiveEventInputAccessControl

Het IP-toegangsbeheer voor invoer van livegebeurtenissen.

Name	Type	Description
ip	IPAccessControl	De eigenschappen van IP-toegangsbeheer.

LiveEventInputProtocol

Het invoerprotocol voor de livegebeurtenis. Dit wordt opgegeven tijdens het maken en kan niet worden bijgewerkt.

Name	Type	Description
FragmentedMP4	string	Smooth Streaming-invoer wordt verzonden door de encoder voor bijdragen aan de livegebeurtenis.
RTMP	string	RTMP-invoer wordt verzonden door de encoder voor bijdragen aan de livegebeurtenis.

LiveEventInputTrackSelection

Een voorwaarde voor het bijhouden van een selectie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.

Name	Type	Description
operation	string	Bewerking vergelijken. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.
property	string	De naam van de eigenschap die u wilt selecteren. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.
value	string	Te selecteren eigenschapswaarde. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.

LiveEventOutputTranscriptionTrack

Beschrijft een transcriptiespoor in de uitvoer van een livegebeurtenis, gegenereerd met spraak-naar-teksttranscriptie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.

Name	Type	Description
trackName	string	De naam van het uitvoerspoor. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.

LiveEventPreview

Instellingen voor livegebeurtenisvoorbeeld.

Name	Type	Description
accessControl	LiveEventPreviewAccessControl	Het toegangsbeheer voor de preview van livegebeurtenissen.
alternativeMediaId	string	Een alternatieve media-id die is gekoppeld aan de streaming-locator die is gemaakt voor de preview. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt. De id kan worden gebruikt in de CustomLicenseAcquisitionUrlTemplate of de CustomKeyAcquisitionUrlTemplate van de StreamingPolicy die is opgegeven in het veld StreamingPolicyName.
endpoints	LiveEventEndpoint[]	De eindpunten voor preview. Deel de preview-URL niet met de doelgroep van de livegebeurtenis.
previewLocator	string	De id van de preview-locator in GUID-indeling. Als u dit opgeeft tijdens het maken, kan de aanroeper de preview-locator-URL kennen voordat de gebeurtenis wordt gemaakt. Als u dit weglaat, genereert de service een willekeurige id. Deze waarde kan niet worden bijgewerkt nadat de livegebeurtenis is gemaakt.
streamingPolicyName	string	De naam van het streamingbeleid dat wordt gebruikt voor de preview van de livegebeurtenis. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt.

LiveEventPreviewAccessControl

Het IP-toegangsbeheer voor het eindpunt van de livegebeurtenisvoorbeeld.

Name	Type	Description
ip	IPAccessControl	De eigenschappen van IP-toegangsbeheer.

LiveEventResourceState

De resourcestatus van de livegebeurtenis. Zie https://go.microsoft.com/fwlink/?linkid=2139012 voor meer informatie.

Name	Type	Description
Allocating	string	De actie Toewijzen is aangeroepen voor de livegebeurtenis en er worden resources ingericht voor deze livegebeurtenis. Zodra de toewijzing is voltooid, wordt de livegebeurtenis overgezet naar de status StandBy.
Deleting	string	De livegebeurtenis wordt verwijderd. Er vindt geen facturering plaats in deze tijdelijke status. Updates of streaming zijn niet toegestaan tijdens deze status.
Running	string	De resources voor livegebeurtenissen zijn toegewezen, er zijn opname- en preview-URL's gegenereerd en deze kunnen livestreams ontvangen. Op dit moment is facturering actief. U moet expliciet Stop aanroepen op de livegebeurtenisresource om verdere facturering te stoppen.
StandBy	string	Resources voor livegebeurtenissen zijn ingericht en zijn klaar om te beginnen. Facturering vindt plaats in deze status. De meeste eigenschappen kunnen nog steeds worden bijgewerkt, maar opnemen of streamen is niet toegestaan tijdens deze status.
Starting	string	De livegebeurtenis wordt gestart en er worden resources toegewezen. Er vindt geen facturering plaats in deze status. Updates of streaming zijn niet toegestaan tijdens deze status. Als er een fout optreedt, keert de livegebeurtenis terug naar de status Gestopt.
Stopped	string	Dit is de eerste status van de livegebeurtenis na het maken (tenzij AutoStart is ingesteld op true.) Er vindt geen facturering plaats in deze status. In deze status kunnen de eigenschappen van de livegebeurtenis worden bijgewerkt, maar is streamen niet toegestaan.
Stopping	string	De livegebeurtenis wordt gestopt en de inrichting van resources wordt ongedaan gemaakt. Er vindt geen facturering plaats in deze tijdelijke status. Updates of streaming zijn niet toegestaan tijdens deze status.

LiveEventTimedMetadataEndpoint

Het eindpunt voor het invoegen van metagegevens van livegebeurtenissen.

Name	Type	Description
url	string	De eindpunt-URL voor metagegevens.

LiveEventTranscription

Beschrijft de transcriptiesporen in de uitvoer van een livegebeurtenis, gegenereerd met spraak-naar-teksttranscriptie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.

Name	Type	Description
inputTrackSelection	LiveEventInputTrackSelection[]	Biedt een mechanisme voor het selecteren van het audiospoor in de invoer livefeed, waarop spraak-naar-teksttranscriptie wordt toegepast. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.
language	string	Hiermee geeft u de taal (landinstelling) op die moet worden gebruikt voor spraak-naar-teksttranscriptie. Deze taal moet overeenkomen met de gesproken taal in het audionummer. De waarde moet de indeling BCP-47 hebben (bijvoorbeeld 'en-US'). Zie https://go.microsoft.com/fwlink/?linkid=2133742 voor meer informatie over de functie voor livetranscriptie en de lijst met ondersteunde talen.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Beschrijft een transcriptiespoor in de uitvoer van een livegebeurtenis, gegenereerd met spraak-naar-teksttranscriptie. Deze eigenschap is gereserveerd voor toekomstig gebruik. Elke waarde die voor deze eigenschap is ingesteld, wordt genegeerd.

StreamOptionsFlag

De opties die moeten worden gebruikt voor de LiveEvent. Deze waarde wordt opgegeven tijdens het maken en kan niet worden bijgewerkt. De geldige waarden voor de matrixinvoerwaarden zijn 'Default' en 'LowLatency'.

Name	Type	Description
Default	string	Live streamen zonder speciale latentieoptimalisaties.
LowLatency	string	De livegebeurtenis biedt een lagere end-to-endlatentie door de interne buffers te verminderen.
LowLatencyV2	string	De livegebeurtenis is geoptimaliseerd voor end-to-end latentie. Deze optie is alleen beschikbaar voor het coderen van livegebeurtenissen met RTMP-invoer. De uitvoer kan worden gestreamd met de indeling HLS of DASH. De archief- of DVR-terugspoellengte van de uitvoer is beperkt tot 6 uur. Gebruik de streamoptie LowLatency voor alle andere scenario's.

StretchMode

Hiermee geeft u op hoe het formaat van de invoervideo wordt aangepast aan de gewenste uitvoerresolutie(s). De standaardwaarde is Geen

Name	Type	Description
AutoFit	string	Pad de uitvoer (met letterbox of pilaar) om de uitvoerresolutie te behouden, terwijl u ervoor zorgt dat het actieve videogebied in de uitvoer dezelfde hoogte-breedteverhouding heeft als de invoer. Als de invoer bijvoorbeeld 1920x1080 is en de vooraf ingestelde codering vraagt om 1280x1280, is de uitvoer 1280x1280, die een binnenste rechthoek van 1280x720 met een hoogte-breedteverhouding van 16:9 en kolomvakgebieden van 280 pixels breed aan de linkerkant en rechts.
AutoSize	string	Overschrijf de uitvoerresolutie en wijzig deze zodat deze overeenkomt met de hoogte-breedteverhouding van de invoer, zonder opvulling. Als de invoer bijvoorbeeld 1920x1080 is en de voorinstelling voor codering vraagt om 1280x1280, wordt de waarde in de voorinstelling overschreven en is de uitvoer 1280x720, waardoor de hoogte-breedteverhouding van de invoer 16:9 behouden blijft.
None	string	Houdt zich strikt aan de uitvoerresolutie die is opgegeven in de coderingsinstelling zonder rekening te houden met de pixel-hoogte-breedteverhouding of weergaveverhouding van de invoervideo.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name	Type	Description
createdAt	string	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit die de resource heeft gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string	Het tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource het laatst heeft gewijzigd.