Live Events - Create

Referens

Tjänst:: Media Services

API-version:: 2022-11-01

Skapa livehändelse
Skapar en ny livehändelse.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
accountName	path	True	string	Namnet på Media Services-kontot.
liveEventName	path	True	string	Namnet på livehändelsen, maxlängden är 32. Reguljärt uttrycksmönster: `^[a-zA-Z0-9]+(-[a-zA-Z0-9])$`
resourceGroupName	path	True	string	Namnet på resursgruppen i Azure-prenumerationen.
subscriptionId	path	True	string	Den unika identifieraren för en Microsoft Azure-prenumeration.
api-version	query	True	string	Den version av API:et som ska användas med klientbegäran.
autoStart	query		boolean	Flaggan anger om resursen ska startas automatiskt när den skapas.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
properties.input	True	LiveEventInput	Inställningar för livehändelseindata. Den definierar hur livehändelsen tar emot indata från en bidragskodare.
properties.crossSiteAccessPolicies		CrossSiteAccessPolicies	Principer för åtkomst mellan webbplatser i livehändelser.
properties.description		string	En beskrivning av livehändelsen.
properties.encoding		LiveEventEncoding	Kodningsinställningar för livehändelsen. Den konfigurerar om en livekodare används för livehändelsen och inställningarna för livekodaren om den används.
properties.hostnamePrefix		string	När useStaticHostname är inställt på true anger hostnamePrefix den första delen av värdnamnet som tilldelats livehändelseförhandsgranskningen och matar in slutpunkter. Det slutliga värdnamnet är en kombination av det här prefixet, medietjänstkontots namn och en kort kod för Azure Media Services-datacentret.
properties.preview		LiveEventPreview	Inställningar för förhandsgranskning av livehändelser. Med förhandsversionen kan livehändelseproducenter förhandsgranska liveuppspelningsinnehållet utan att skapa några liveutdata.
properties.streamOptions		StreamOptionsFlag[]	De alternativ som ska användas för LiveEvent. Det här värdet anges när det skapas och kan inte uppdateras. Giltiga värden för matrisens postvärden är "Default" och "LowLatency".
properties.transcriptions		LiveEventTranscription[]	Inställningar för live-transkription för livehändelsen. Se https://go.microsoft.com/fwlink/?linkid=2133742 för mer information om funktionen för live-transkription.
properties.useStaticHostname		boolean	Anger om ett statiskt värdnamn ska tilldelas till livehändelseförhandsgranskningen och mata in slutpunkter. Det här värdet kan bara uppdateras om livehändelsen är i vänteläge
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	LiveEvent	OK. Begäran har slutförts.
201 Created	LiveEvent	Skapad. Begäran har accepterats för bearbetning och åtgärden slutförs asynkront. Mer https://go.microsoft.com/fwlink/?linkid=2087017 information om hur du övervakar asynkrona Azure-åtgärder med hjälp av Azure-AsyncOperation svarsrubrik.
Other Status Codes	ErrorResponse	Svaret på strömningsfelet som beskriver varför åtgärden misslyckades.

Exempel

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

Exempelsvar

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

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

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
CrossSiteAccessPolicies	Klientåtkomstprincipen.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
IPAccessControl	IP-åtkomstkontrollen.
IPRange	IP-adressintervallet i CIDR-schemat.
LiveEvent	Livehändelsen.
LiveEventEncoding	Anger livehändelsetyp och valfria kodningsinställningar för kodning av livehändelser.
LiveEventEncodingType	Livehändelsetyp. När encodingType är inställt på PassthroughBasic eller PassthroughStandard skickar tjänsten helt enkelt igenom de inkommande video- och ljudskikten till utdata. När encodingType är inställt på Standard eller Premium1080p, kodar en livekodare den inkommande strömmen till flera bithastigheter eller lager. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2095101. Det går inte att ändra den här egenskapen när livehändelsen har skapats.
LiveEventEndpoint	Slutpunkten för livehändelsen.
LiveEventInput	Livehändelsens indata.
LiveEventInputAccessControl	IP-åtkomstkontrollen för livehändelseindata.
LiveEventInputProtocol	Indataprotokollet för livehändelsen. Detta anges vid skapandet och kan inte uppdateras.
LiveEventInputTrackSelection	Ett villkor för att spåra markering. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.
LiveEventOutputTranscriptionTrack	Beskriver ett transkriptionsspår i utdata från en livehändelse som genereras med tal till text-transkription. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.
LiveEventPreview	Inställningar för förhandsversion av livehändelser.
LiveEventPreviewAccessControl	IP-åtkomstkontrollen för slutpunkten för förhandsversionen av livehändelsen.
LiveEventResourceState	Resurstillståndet för livehändelsen. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2139012.
LiveEventTimedMetadataEndpoint	Slutpunkten för metadatainfogning för livehändelse.
LiveEventTranscription	Beskriver transkriptionsspåren i utdata från en livehändelse som genereras med tal-till-text-transkription. Den här egenskapen är reserverad för framtida användning. Alla värden som anges i den här egenskapen ignoreras.
StreamOptionsFlag	De alternativ som ska användas för LiveEvent. Det här värdet anges vid skapandetillfället och kan inte uppdateras. Giltiga värden för matrisens postvärden är "Standard" och "LowLatency".
StretchMode	Anger hur indatavideon ska ändras så att den passar önskade utdataupplösningar. Standardvärdet är Ingen
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Den typ av identitet som skapade resursen.

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

CrossSiteAccessPolicies

Klientåtkomstprincipen.

Name	Typ	Description
clientAccessPolicy	string	Innehållet i clientaccesspolicy.xml som används av Silverlight.
crossDomainPolicy	string	Innehållet i crossdomain.xml som används av Silverlight.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Den ytterligare informationen.
type	string	Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

IPAccessControl

IP-åtkomstkontrollen.

Name	Typ	Description
allow	IPRange[]	Listan över tillåtna IP-adresser.

IPRange

IP-adressintervallet i CIDR-schemat.

Name	Typ	Description
address	string	IP-adressen.
name	string	Det egna namnet för IP-adressintervallet.
subnetPrefixLength	integer	Prefixlängden för nätmasken (se CIDR-notation).

LiveEvent

Livehändelsen.

Name	Typ	Description
id	string	Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.created	string	Skapandetiden för livehändelsen
properties.crossSiteAccessPolicies	CrossSiteAccessPolicies	Principer för direkthändelseåtkomst mellan webbplatser.
properties.description	string	En beskrivning av livehändelsen.
properties.encoding	LiveEventEncoding	Kodningsinställningar för livehändelsen. Den konfigurerar om en livekodare används för livehändelsen och inställningar för livekodaren om den används.
properties.hostnamePrefix	string	När useStaticHostname är inställt på true anger hostnamePrefix den första delen av värdnamnet som tilldelats livehändelseförhandsgranskningen och matar in slutpunkter. Det slutliga värdnamnet skulle vara en kombination av det här prefixet, medietjänstkontots namn och en kort kod för Azure Media Services-datacentret.
properties.input	LiveEventInput	Inställningar för livehändelseindata. Den definierar hur livehändelsen tar emot indata från en bidragskodare.
properties.lastModified	string	Den senaste ändrade tiden för livehändelsen.
properties.preview	LiveEventPreview	Inställningar för förhandsversion av livehändelser. Med förhandsversionen kan livehändelseproducenter förhandsgranska liveuppspelningsinnehållet utan att skapa några liveutdata.
properties.provisioningState	string	Etableringstillståndet för livehändelsen.
properties.resourceState	LiveEventResourceState	Resurstillståndet för livehändelsen. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2139012.
properties.streamOptions	StreamOptionsFlag[]	De alternativ som ska användas för LiveEvent. Det här värdet anges vid skapandetillfället och kan inte uppdateras. Giltiga värden för matrisens postvärden är "Standard" och "LowLatency".
properties.transcriptions	LiveEventTranscription[]	Inställningar för live-transkription för livehändelsen. Mer https://go.microsoft.com/fwlink/?linkid=2133742 information om live-transkriptionsfunktionen finns i .
properties.useStaticHostname	boolean	Anger om ett statiskt värdnamn skulle tilldelas till förhandsversionen av livehändelsen och mata in slutpunkter. Det här värdet kan bara uppdateras om livehändelsen är i vänteläge
systemData	systemData	Systemmetadata som är relaterade till den här resursen.
tags	object	Resurstaggar.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

LiveEventEncoding

Anger livehändelsetyp och valfria kodningsinställningar för kodning av livehändelser.

Name	Typ	Description
encodingType	LiveEventEncodingType	Livehändelsetyp. När encodingType är inställt på PassthroughBasic eller PassthroughStandard passerar tjänsten helt enkelt inkommande video- och ljudlager till utdata. När encodingType har angetts till Standard eller Premium1080p, kodar en livekodare den inkommande strömmen till flera bithastigheter eller lager. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2095101. Det går inte att ändra den här egenskapen när livehändelsen har skapats.
keyFrameInterval	string	Använd ett ISO 8601-tidsvärde mellan 0,5 och 20 sekunder för att ange utdatafragmentets längd för video- och ljudspåren för en kodnings livehändelse. Använd till exempel PT2S för att ange 2 sekunder. För videospåret definierar det också nyckelramsintervallet eller längden på en GoP (grupp med bilder). Om det här värdet inte har angetts för en kodnings-livehändelse är fragmentets varaktighet som standard 2 sekunder. Det går inte att ange värdet för direktsändningar via livehändelser.
presetName	string	Det valfria kodningsförinställningsnamnet som används när encodingType inte är Ingen. Det här värdet anges vid skapandetillfället och kan inte uppdateras. Om kodningstypen är inställd på Standard är standardförinställningsnamnet "Default720p". Annars om kodningstypen är inställd på Premium1080p är standardinställningen "Default1080p".
stretchMode	StretchMode	Anger hur indatavideon ska ändras så att den passar önskad utdataupplösning. Standardvärdet är Ingen

LiveEventEncodingType

Livehändelsetyp. När encodingType är inställt på PassthroughBasic eller PassthroughStandard skickar tjänsten helt enkelt igenom de inkommande video- och ljudskikten till utdata. När encodingType är inställt på Standard eller Premium1080p, kodar en livekodare den inkommande strömmen till flera bithastigheter eller lager. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2095101. Det går inte att ändra den här egenskapen när livehändelsen har skapats.

Name	Typ	Description
None	string	Detta är samma som PassthroughStandard. Se beskrivningen nedan. Det här uppräkningsvärdet är inaktuellt.
PassthroughBasic	string	Den inmatade strömmen passerar genom livehändelsen från bidragskodaren utan vidare bearbetning. I PassthroughBasic-läget är inmatningen begränsad till upp till 5 Mbit/s och endast 1 samtidiga liveutdata tillåts. Live-transkription är inte tillgängligt.
PassthroughStandard	string	Den inmatade strömmen passerar genom livehändelsen från bidragskodaren utan vidare bearbetning. Live-transkription är tillgängligt. Inmatningsbithastighetsgränserna är mycket högre och upp till 3 samtidiga liveutdata tillåts.
Premium1080p	string	En livekodare för bidrag skickar en dataström med enkel bithastighet till livehändelsen och Media Services skapar dataströmmar med flera bithastigheter. Utdata får inte överskrida 1080p i upplösning.
Standard	string	En livekodare för bidrag skickar en dataström med enkel bithastighet till livehändelsen och Media Services skapar dataströmmar med flera bithastigheter. Utdata får inte överskrida 720p i upplösning.

LiveEventEndpoint

Slutpunkten för livehändelsen.

Name	Typ	Description
protocol	string	Slutpunktsprotokollet.
url	string	Slutpunkts-URL:en.

LiveEventInput

Livehändelsens indata.

Name	Typ	Description
accessControl	LiveEventInputAccessControl	Åtkomstkontroll för livehändelseindata.
accessToken	string	Ett UUID i strängform för att unikt identifiera strömmen. Detta kan anges vid skapandetillfället men kan inte uppdateras. Om den utelämnas genererar tjänsten ett unikt värde.
endpoints	LiveEventEndpoint[]	Indataslutpunkterna för livehändelsen.
keyFrameIntervalDuration	string	ISO 8601 tidslängd för nyckelramens intervallvaraktighet för indata. Det här värdet anger egenskapen EXT-X-TARGETDURATION i HLS-utdata. Använd till exempel PT2S för att ange 2 sekunder. Lämna värdet tomt för att koda livehändelser.
streamingProtocol	LiveEventInputProtocol	Indataprotokollet för livehändelsen. Detta anges vid skapandetillfället och kan inte uppdateras.
timedMetadataEndpoints	LiveEventTimedMetadataEndpoint[]	Metadataslutpunkterna för livehändelsen.

LiveEventInputAccessControl

IP-åtkomstkontrollen för livehändelseindata.

Name	Typ	Description
ip	IPAccessControl	Egenskaper för IP-åtkomstkontroll.

LiveEventInputProtocol

Indataprotokollet för livehändelsen. Detta anges vid skapandet och kan inte uppdateras.

Name	Typ	Description
FragmentedMP4	string	Smooth Streaming-indata skickas av bidragskodaren till livehändelsen.
RTMP	string	RTMP-indata skickas av bidragskodaren till livehändelsen.

LiveEventInputTrackSelection

Ett villkor för att spåra markering. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.

Name	Typ	Description
operation	string	Jämför åtgärden. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.
property	string	Egenskapsnamn som ska väljas. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.
value	string	Egenskapsvärde som ska väljas. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.

LiveEventOutputTranscriptionTrack

Beskriver ett transkriptionsspår i utdata från en livehändelse som genereras med tal till text-transkription. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.

Name	Typ	Description
trackName	string	Namnet på utdataspåret. Den här egenskapen är reserverad för framtida användning. Alla värden som anges för den här egenskapen ignoreras.

LiveEventPreview

Inställningar för förhandsversion av livehändelser.

Name	Typ	Description
accessControl	LiveEventPreviewAccessControl	Åtkomstkontrollen för förhandsversionen av livehändelsen.
alternativeMediaId	string	En alternativ medieidentifierare som är associerad med strömningslokaliseraren som skapats för förhandsversionen. Det här värdet anges vid skapandetillfället och kan inte uppdateras. Identifieraren kan användas i CustomLicenseAcquisitionUrlTemplate eller CustomKeyAcquisitionUrlTemplate för StreamingPolicy som anges i fältet StreamingPolicyName.
endpoints	LiveEventEndpoint[]	Slutpunkterna för förhandsversion. Dela inte förhandsgransknings-URL:en med livehändelsens målgrupp.
previewLocator	string	Identifieraren för förhandsgranskningslokaliseraren i Guid-format. Om du anger detta vid skapandetillfället kan anroparen känna till url:en för förhandsgranskningslokaliseraren innan händelsen skapas. Om den utelämnas genererar tjänsten en slumpmässig identifierare. Det går inte att uppdatera det här värdet när livehändelsen har skapats.
streamingPolicyName	string	Namnet på den strömningsprincip som används för förhandsversionen av livehändelsen. Det här värdet anges vid skapandetillfället och kan inte uppdateras.

LiveEventPreviewAccessControl

IP-åtkomstkontrollen för slutpunkten för förhandsversionen av livehändelsen.

Name	Typ	Description
ip	IPAccessControl	Egenskaper för IP-åtkomstkontroll.

LiveEventResourceState

Resurstillståndet för livehändelsen. Mer information finns i https://go.microsoft.com/fwlink/?linkid=2139012.

Name	Typ	Description
Allocating	string	Allokeringsåtgärden anropades för livehändelsen och resurser etableras för den här livehändelsen. När allokeringen är klar övergår livehändelsen till StandBy-tillstånd.
Deleting	string	Livehändelsen tas bort. Ingen fakturering sker i det här tillfälliga tillståndet. Uppdateringar eller strömning tillåts inte under det här tillståndet.
Running	string	Livehändelseresurserna har allokerats, inmatnings- och förhandsversions-URL:er har genererats och kan ta emot liveströmmar. I det här läget är faktureringen aktiv. Du måste uttryckligen anropa Stoppa på livehändelseresursen för att stoppa ytterligare fakturering.
StandBy	string	Livehändelseresurser har etablerats och är redo att starta. Faktureringen sker i det här tillståndet. De flesta egenskaper kan fortfarande uppdateras, men inmatning eller direktuppspelning tillåts inte under det här tillståndet.
Starting	string	Livehändelsen startas och resurser allokeras. Ingen fakturering sker i det här tillståndet. Uppdateringar eller strömning tillåts inte under det här tillståndet. Om ett fel inträffar återgår livehändelsen till tillståndet Stoppad.
Stopped	string	Det här är det ursprungliga tillståndet för livehändelsen efter skapandet (såvida inte autostarten har angetts till true.) Ingen fakturering sker i det här tillståndet. I det här tillståndet kan livehändelseegenskaperna uppdateras, men strömning tillåts inte.
Stopping	string	Livehändelsen stoppas och resurser avetablerades. Ingen fakturering sker i det här tillfälliga tillståndet. Uppdateringar eller strömning tillåts inte under det här tillståndet.

LiveEventTimedMetadataEndpoint

Slutpunkten för metadatainfogning för livehändelse.

Name	Typ	Description
url	string	URL:en för metadataslutpunkten.

LiveEventTranscription

Beskriver transkriptionsspåren i utdata från en livehändelse som genereras med tal-till-text-transkription. Den här egenskapen är reserverad för framtida användning. Alla värden som anges i den här egenskapen ignoreras.

Name	Typ	Description
inputTrackSelection	LiveEventInputTrackSelection[]	Tillhandahåller en mekanism för att välja ljudspåret i livefeeden för indata, som tal-till-text-transkription tillämpas på. Den här egenskapen är reserverad för framtida användning. Alla värden som anges i den här egenskapen ignoreras.
language	string	Anger vilket språk (språk) som ska användas för tal-till-text-transkription – det ska matcha det talade språket i ljudspåret. Värdet ska vara i BCP-47-format (t.ex. "en-US"). Mer https://go.microsoft.com/fwlink/?linkid=2133742 information om live-transkriptionsfunktionen och listan över språk som stöds finns i mer information.
outputTranscriptionTrack	LiveEventOutputTranscriptionTrack	Beskriver ett transkriptionsspår i utdata från en livehändelse som genereras med tal-till-text-transkription. Den här egenskapen är reserverad för framtida användning. Alla värden som anges i den här egenskapen ignoreras.

StreamOptionsFlag

De alternativ som ska användas för LiveEvent. Det här värdet anges vid skapandetillfället och kan inte uppdateras. Giltiga värden för matrisens postvärden är "Standard" och "LowLatency".

Name	Typ	Description
Default	string	Liveuppspelning utan särskilda svarstidsoptimeringar.
LowLatency	string	Livehändelsen ger svarstid från slutpunkt till slutpunkt genom att minska dess interna buffertar.
LowLatencyV2	string	Livehändelsen är optimerad för svarstid från slutpunkt till slutpunkt. Det här alternativet är endast tillgängligt för kodning av livehändelser med RTMP-indata. Utdata kan strömmas med HLS- eller DASH-format. Utdataarkivets eller DVR-bakåtspolningslängden är begränsad till 6 timmar. Använd strömalternativet "LowLatency" för alla andra scenarier.

StretchMode

Anger hur indatavideon ska ändras så att den passar önskade utdataupplösningar. Standardvärdet är Ingen

Name	Typ	Description
AutoFit	string	Fyll utdata (med antingen letterbox eller pillar box) för att uppfylla utdataupplösningen, samtidigt som du ser till att det aktiva videoområdet i utdata har samma proportioner som indata. Om indata till exempel är 1920x1080 och kodningsförinställningen frågar efter 1280x1280, kommer utdata att vara på 1280x1280, som innehåller en inre rektangel på 1280x720 i proportion på 16:9 och pelarfältsregioner 280 pixlar brett till vänster och höger.
AutoSize	string	Åsidosätt utdataupplösningen och ändra den så att den matchar visningsproportionen för indata, utan utfyllnad. Om indata till exempel är 1920x1080 och kodningsförinställningen frågar efter 1280x1280 åsidosätts värdet i förinställningen, och utdata kommer att vara 1280x720, vilket bibehåller indataaspektförhållandet på 16:9.
None	string	Strikt respekterar den utdataupplösning som anges i kodningsförinställningen utan att ta hänsyn till pixelproportionen eller visningsproportionen för indatavideon.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

Dela via