Live Events - Create

  • Referens
Service:
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
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-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.

Regex pattern: ^[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

Sample Request

PUT https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveEvents/myLiveEvent1?api-version=2022-11-01

{
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "input": {
      "streamingProtocol": "RTMP",
      "keyFrameIntervalDuration": "PT6S",
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    },
    "preview": {
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      }
    }
  }
}

Sample Response

Status code:
201 
azure-asyncoperation: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveeventoperations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
location: https://management.azure.com/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1/operationlocations/62e4d893-d233-4005-988e-a428d9f77076?api-version=2022-11-01
Response Body
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "resourceState": "Creating",
    "provisioningState": "InProgress",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}
Status code:
200 
{
  "name": "myLiveEvent1",
  "id": "/subscriptions/0a6ec948-5a62-437d-b9df-934dc7c1b722/resourceGroups/mediaresources/providers/Microsoft.Media/mediaservices/slitestmedia10/liveevents/myLiveEvent1",
  "type": "Microsoft.Media/mediaservices/liveevents",
  "location": "West US",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "description": "test event 1",
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:06.0982751Z",
    "lastModified": "2018-03-03T02:25:06.0982751Z",
    "useStaticHostname": false,
    "streamOptions": [],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": "<accessToken>",
      "endpoints": [],
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "c91726b4-880c-4090-94aa-e6ddb1384b37",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": []
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": null,
      "crossDomainPolicy": null
    }
  }
}

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.