Sdílet prostřednictvím


Live Events - Create

Vytvoření živé události
Vytvoří novou živou událost.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
accountName
path True

string

Název účtu Media Services.

liveEventName
path True

string

Název živé události, maximální délka je 32.

Vzor regulárního výrazu: ^[a-zA-Z0-9]+(-*[a-zA-Z0-9])*$

resourceGroupName
path True

string

Název skupiny prostředků v rámci předplatného Azure.

subscriptionId
path True

string

Jedinečný identifikátor předplatného Microsoft Azure.

api-version
query True

string

Verze rozhraní API, která se má použít s požadavkem klienta.

autoStart
query

boolean

Příznak označuje, jestli se má prostředek automaticky spustit při vytvoření.

Text požadavku

Name Vyžadováno Typ Description
location True

string

Geografické umístění, kde se prostředek nachází

properties.input True

LiveEventInput

Nastavení vstupu živé události. Definuje, jak živá událost přijímá vstup z kodéru příspěvků.

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Zásady přístupu mezi weby pro živé události.

properties.description

string

Popis živé události.

properties.encoding

LiveEventEncoding

Nastavení kódování pro živou událost. Konfiguruje, jestli se kodér pro kódování v reálném čase používá pro živou událost, a nastavení kodéru pro kódování v reálném čase, pokud se použije.

properties.hostnamePrefix

string

Pokud je parametr useStaticHostname nastavený na hodnotu true, parametr hostnamePrefix určuje první část názvu hostitele přiřazeného ke koncovým bodům náhledu živé události a ingestování. Konečný název hostitele by byl kombinací této předpony, názvu účtu služby Media Service a krátkého kódu pro datové centrum Azure Media Services.

properties.preview

LiveEventPreview

Nastavení náhledu živých událostí. Náhled umožňuje producentům živých událostí zobrazit náhled živého streamovaného obsahu bez vytváření živého výstupu.

properties.streamOptions

StreamOptionsFlag[]

Možnosti, které se mají použít pro událost LiveEvent. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Platné hodnoty pro položky pole jsou Default a LowLatency.

properties.transcriptions

LiveEventTranscription[]

Nastavení živého přepisu živé události Další informace o funkci živého přepisu najdete v tématu https://go.microsoft.com/fwlink/?linkid=2133742 .

properties.useStaticHostname

boolean

Určuje, jestli se má ke koncovým bodům náhledu a ingestování živých událostí přiřadit statický název hostitele. Tuto hodnotu lze aktualizovat pouze v případě, že je živá událost v pohotovostním stavu.

tags

object

Značky prostředků.

Odpovědi

Name Typ Description
200 OK

LiveEvent

OK. Žádost byla úspěšná.

201 Created

LiveEvent

Vytvořen. Požadavek byl přijat ke zpracování a operace se dokončí asynchronně. Podrobnosti https://go.microsoft.com/fwlink/?linkid=2087017 o monitorování asynchronních operací Azure s využitím hlavičky odpovědi Azure-AsyncOperation najdete v tématu .

Other Status Codes

ErrorResponse

Odpověď na chybu streamování popisující, proč operace selhala.

Příklady

Create a LiveEvent

Ukázkový požadavek

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

Ukázková odpověď

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

Definice

Name Description
createdByType

Typ identity, která prostředek vytvořila.

CrossSiteAccessPolicies

Zásady klientského přístupu.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

IPAccessControl

Řízení přístupu k IP adresě.

IPRange

Rozsah IP adres ve schématu CIDR.

LiveEvent

Živá událost.

LiveEventEncoding

Určuje typ živé události a volitelné nastavení kódování pro kódování živých událostí.

LiveEventEncodingType

Typ živé události. Když je encodingType nastavený na PassthroughBasic nebo PassthroughStandard, služba jednoduše předává příchozí vrstvu videa a zvuku do výstupu. Pokud je encodingType nastavená na Standard nebo Premium1080p, kodér v reálném čase překóduje příchozí datový proud na více přenosových rychlostí nebo vrstev. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2095101. Tuto vlastnost nelze po vytvoření živé události změnit.

LiveEventEndpoint

Koncový bod živé události.

LiveEventInput

Vstup živé události.

LiveEventInputAccessControl

Řízení přístupu IP pro vstup živých událostí.

LiveEventInputProtocol

Vstupní protokol pro živou událost. Tato hodnota je zadána při vytváření a nelze ji aktualizovat.

LiveEventInputTrackSelection

Podmínka výběru stopy. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

LiveEventOutputTranscriptionTrack

Popisuje stopu přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

LiveEventPreview

Nastavení náhledu živých událostí.

LiveEventPreviewAccessControl

Řízení přístupu IP pro koncový bod náhledu živé události.

LiveEventResourceState

Stav prostředku živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012.

LiveEventTimedMetadataEndpoint

Koncový bod vkládání metadat živé události.

LiveEventTranscription

Popisuje stopy přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

StreamOptionsFlag

Možnosti, které se mají použít pro událost LiveEvent. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Platné hodnoty pro položky pole jsou Default a LowLatency.

StretchMode

Určuje, jak se změní velikost vstupního videa tak, aby odpovídala požadovanému rozlišení výstupu. Výchozí hodnota je Žádná.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

CrossSiteAccessPolicies

Zásady klientského přístupu.

Name Typ Description
clientAccessPolicy

string

Obsah clientaccesspolicy.xml používán programem Silverlight.

crossDomainPolicy

string

Obsah crossdomain.xml používán programem Silverlight.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Typ další informace.

ErrorDetail

Podrobnosti o chybě

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

IPAccessControl

Řízení přístupu k IP adresě.

Name Typ Description
allow

IPRange[]

Seznam povolených IP adres.

IPRange

Rozsah IP adres ve schématu CIDR.

Name Typ Description
address

string

IP adresa.

name

string

Popisný název rozsahu IP adres.

subnetPrefixLength

integer

Délka předpony masky podsítě (viz zápis CIDR).

LiveEvent

Živá událost.

Name Typ Description
id

string

Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku}

location

string

Geografické umístění, kde se prostředek nachází

name

string

Název prostředku

properties.created

string

Čas vytvoření živé události

properties.crossSiteAccessPolicies

CrossSiteAccessPolicies

Zásady přístupu mezi weby pro živé události.

properties.description

string

Popis živé události.

properties.encoding

LiveEventEncoding

Nastavení kódování pro živou událost. Konfiguruje, jestli se kodér pro kódování v reálném čase používá pro živou událost, a nastavení kodéru pro kódování v reálném čase, pokud se použije.

properties.hostnamePrefix

string

Pokud je parametr useStaticHostname nastavený na hodnotu true, parametr hostnamePrefix určuje první část názvu hostitele přiřazeného ke koncovým bodům náhledu živé události a ingestování. Konečný název hostitele by byl kombinací této předpony, názvu účtu služby Media Service a krátkého kódu pro datové centrum Azure Media Services.

properties.input

LiveEventInput

Nastavení vstupu živé události. Definuje, jak živá událost přijímá vstup z kodéru příspěvků.

properties.lastModified

string

Čas poslední změny živé události.

properties.preview

LiveEventPreview

Nastavení náhledu živých událostí. Náhled umožňuje producentům živých událostí zobrazit náhled živého streamovaného obsahu bez vytváření živého výstupu.

properties.provisioningState

string

Stav zřizování živé události.

properties.resourceState

LiveEventResourceState

Stav prostředku živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012.

properties.streamOptions

StreamOptionsFlag[]

Možnosti, které se mají použít pro událost LiveEvent. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Platné hodnoty pro položky pole jsou Default a LowLatency.

properties.transcriptions

LiveEventTranscription[]

Nastavení živého přepisu živé události Další informace o funkci živého přepisu najdete v tématu https://go.microsoft.com/fwlink/?linkid=2133742 .

properties.useStaticHostname

boolean

Určuje, jestli se má ke koncovým bodům náhledu a ingestování živých událostí přiřadit statický název hostitele. Tuto hodnotu lze aktualizovat pouze v případě, že je živá událost v pohotovostním stavu.

systemData

systemData

Systémová metadata vztahující se k tomuto prostředku.

tags

object

Značky prostředků.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

LiveEventEncoding

Určuje typ živé události a volitelné nastavení kódování pro kódování živých událostí.

Name Typ Description
encodingType

LiveEventEncodingType

Typ živé události. Když je encodingType nastavený na PassthroughBasic nebo PassthroughStandard, služba jednoduše předává příchozí vrstvu videa a zvuku do výstupu. Pokud je encodingType nastavená na Standard nebo Premium1080p, kodér v reálném čase překóduje příchozí datový proud na více přenosových rychlostí nebo vrstev. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2095101. Tuto vlastnost nelze po vytvoření živé události změnit.

keyFrameInterval

string

Použijte hodnotu času ISO 8601 mezi 0,5 až 20 sekundami k určení délky výstupního fragmentu pro video a zvukové stopy kódování živé události. Použijte například PT2S k označení 2 sekund. Pro sledování videa definuje také interval klíčových snímků nebo délku gop (skupiny obrázků). Pokud tato hodnota není nastavena pro kódování živé události, doba trvání fragmentu je výchozí 2 sekundy. Hodnotu nelze nastavit pro předávací živé události.

presetName

string

Volitelný název předvolby kódování, který se používá, když encodingType není None. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Pokud je vlastnost encodingType nastavená na Standard, výchozí název přednastavení je Default720p. Pokud je vlastnost encodingType nastavená na Premium1080p, výchozí předvolba je Default1080p.

stretchMode

StretchMode

Určuje, jak se změní velikost vstupního videa tak, aby odpovídala požadovanému rozlišení výstupu. Výchozí hodnota je Žádná.

LiveEventEncodingType

Typ živé události. Když je encodingType nastavený na PassthroughBasic nebo PassthroughStandard, služba jednoduše předává příchozí vrstvu videa a zvuku do výstupu. Pokud je encodingType nastavená na Standard nebo Premium1080p, kodér v reálném čase překóduje příchozí datový proud na více přenosových rychlostí nebo vrstev. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2095101. Tuto vlastnost nelze po vytvoření živé události změnit.

Name Typ Description
None

string

Je to stejné jako PassthroughStandard. Projděte si prosím popis níže. Tato hodnota výčtu je zastaralá.

PassthroughBasic

string

Přijatý datový proud prochází živou událostí z kodéru pro příspěvky bez dalšího zpracování. V režimu PassthroughBasic je příjem dat omezený až na 5 Mb/s a je povolen pouze 1 souběžný živý výstup. Živý přepis není k dispozici.

PassthroughStandard

string

Přijatý datový proud prochází živou událostí z kodéru pro příspěvky bez dalšího zpracování. K dispozici je živý přepis. Limity přenosové rychlosti příjmu dat jsou mnohem vyšší a jsou povoleny až 3 souběžné živé výstupy.

Premium1080p

string

Kodér pro kódování příspěvku pro kódování v reálném čase odešle do živé události datový proud s jednou přenosovou rychlostí a služba Media Services vytvoří několik datových proudů přenosové rychlosti. Rozlišení výstupu nesmí překročit 1080p.

Standard

string

Kodér pro kódování příspěvku pro kódování v reálném čase odešle do živé události datový proud s jednou přenosovou rychlostí a služba Media Services vytvoří několik datových proudů přenosové rychlosti. Rozlišení výstupu nesmí překročit 720p.

LiveEventEndpoint

Koncový bod živé události.

Name Typ Description
protocol

string

Protokol koncového bodu.

url

string

Adresa URL koncového bodu.

LiveEventInput

Vstup živé události.

Name Typ Description
accessControl

LiveEventInputAccessControl

Řízení přístupu pro vstup živé události.

accessToken

string

Identifikátor UUID ve formě řetězce pro jedinečnou identifikaci datového proudu. Tuto možnost je možné zadat při vytváření, ale nelze ji aktualizovat. Pokud tento parametr vynecháte, služba vygeneruje jedinečnou hodnotu.

endpoints

LiveEventEndpoint[]

Vstupní koncové body živé události.

keyFrameIntervalDuration

string

Iso 8601 doba trvání intervalu klíčového snímku vstupu. Tato hodnota nastaví vlastnost EXT-X-TARGETDURATION ve výstupu HLS. Použijte například PT2S k označení 2 sekund. Pro kódování živých událostí ponechte hodnotu prázdnou.

streamingProtocol

LiveEventInputProtocol

Vstupní protokol pro živou událost. Tato hodnota je zadána při vytváření a nelze ji aktualizovat.

timedMetadataEndpoints

LiveEventTimedMetadataEndpoint[]

Koncové body metadat pro živou událost.

LiveEventInputAccessControl

Řízení přístupu IP pro vstup živých událostí.

Name Typ Description
ip

IPAccessControl

Vlastnosti řízení přístupu PROTOKOLU IP.

LiveEventInputProtocol

Vstupní protokol pro živou událost. Tato hodnota je zadána při vytváření a nelze ji aktualizovat.

Name Typ Description
FragmentedMP4

string

Vstup technologie Smooth Streaming bude odeslán kodérem příspěvku do živé události.

RTMP

string

Vstup RTMP odešle kodér příspěvku do živé události.

LiveEventInputTrackSelection

Podmínka výběru stopy. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

Name Typ Description
operation

string

Porovnávání operace. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

property

string

Název vlastnosti, která se má vybrat. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

value

string

Hodnota vlastnosti, kterou chcete vybrat. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

LiveEventOutputTranscriptionTrack

Popisuje stopu přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

Name Typ Description
trackName

string

Název výstupní stopy. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

LiveEventPreview

Nastavení náhledu živých událostí.

Name Typ Description
accessControl

LiveEventPreviewAccessControl

Řízení přístupu pro náhled živých událostí.

alternativeMediaId

string

Alternativní identifikátor média přidružený k lokátoru streamování vytvořenému pro náhled. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Identifikátor lze použít v CustomLicenseAcquisitionUrlTemplate nebo CustomKeyAcquisitionUrlTemplate StreamPolicy zadané v poli StreamingPolicyName.

endpoints

LiveEventEndpoint[]

Koncové body pro verzi Preview. Nesdílejte adresu URL náhledu s cílovou skupinou živé události.

previewLocator

string

Identifikátor lokátoru náhledu ve formátu GUID. Zadání této možnosti při vytváření umožní volajícímu znát adresu URL lokátoru náhledu před vytvořením události. Pokud tento parametr vynecháte, služba vygeneruje náhodný identifikátor. Tuto hodnotu nelze po vytvoření živé události aktualizovat.

streamingPolicyName

string

Název zásady streamování použité pro náhled živé události. Tato hodnota je zadána při vytváření a nelze ji aktualizovat.

LiveEventPreviewAccessControl

Řízení přístupu IP pro koncový bod náhledu živé události.

Name Typ Description
ip

IPAccessControl

Vlastnosti řízení přístupu PROTOKOLU IP.

LiveEventResourceState

Stav prostředku živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012.

Name Typ Description
Allocating

string

Pro živou událost byla volána akce přidělení a pro tuto živou událost se zřizují prostředky. Jakmile se přidělení úspěšně dokončí, živá událost přejde do stavu Pohotovostní.

Deleting

string

Živá událost se odstraňuje. V tomto přechodném stavu nedochází k žádné fakturaci. Aktualizace nebo streamování nejsou v tomto stavu povoleny.

Running

string

Byly přiděleny prostředky živých událostí, vygenerovány adresy URL ingestu a náhledu a jsou schopny přijímat živé streamy. V tomto okamžiku je fakturace aktivní. Pokud chcete zastavit další fakturaci, musíte u prostředku živé události explicitně volat příkaz Stop.

StandBy

string

Prostředky živých událostí byly zřízeny a jsou připravené ke spuštění. Fakturace probíhá v tomto stavu. Většinu vlastností je stále možné aktualizovat, ale v tomto stavu není povolené ingestování ani streamování.

Starting

string

Živá událost se spouští a přidělují se prostředky. V tomto stavu nedochází k žádné fakturaci. Aktualizace nebo streamování nejsou v tomto stavu povoleny. Pokud dojde k chybě, živá událost se vrátí do stavu Zastaveno.

Stopped

string

Toto je počáteční stav živé události po vytvoření (pokud nebylo automatické spuštění nastaveno na hodnotu true). V tomto stavu nedochází k žádné fakturaci. V tomto stavu je možné aktualizovat vlastnosti živých událostí, ale streamování není povolené.

Stopping

string

Živá událost se zastavuje a prostředky se ruší. V tomto přechodném stavu nedochází k žádné fakturaci. Aktualizace nebo streamování nejsou v tomto stavu povoleny.

LiveEventTimedMetadataEndpoint

Koncový bod vkládání metadat živé události.

Name Typ Description
url

string

Adresa URL koncového bodu metadat.

LiveEventTranscription

Popisuje stopy přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

Name Typ Description
inputTrackSelection

LiveEventInputTrackSelection[]

Poskytuje mechanismus pro výběr zvukové stopy ve vstupním živém kanálu, na který se použije přepis řeči na text. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

language

string

Určuje jazyk (národní prostředí), který se má použít pro přepis řeči na text – měl by odpovídat mluvenému jazyku ve zvukové stopě. Hodnota by měla být ve formátu BCP-47 (např. en-US). Další https://go.microsoft.com/fwlink/?linkid=2133742 informace o funkci živého přepisu a seznam podporovaných jazyků najdete v tématu .

outputTranscriptionTrack

LiveEventOutputTranscriptionTrack

Popisuje stopu přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití, všechny hodnoty nastavené pro tuto vlastnost budou ignorovány.

StreamOptionsFlag

Možnosti, které se mají použít pro událost LiveEvent. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Platné hodnoty pro položky pole jsou Default a LowLatency.

Name Typ Description
Default

string

Živé streamování bez speciální optimalizace latence.

LowLatency

string

Živá událost poskytuje latenci od konce do konce tím, že snižuje své interní vyrovnávací paměti.

LowLatencyV2

string

Živá událost je optimalizovaná pro koncovou latenci. Tato možnost je k dispozici pouze pro kódování živých událostí se vstupem RTMP. Výstupy lze streamovat pomocí formátů HLS nebo DASH. Délka převíjení archivu nebo DVR výstupu je omezená na 6 hodin. Pro všechny ostatní scénáře použijte možnost streamu LowLatency.

StretchMode

Určuje, jak se změní velikost vstupního videa tak, aby odpovídala požadovanému rozlišení výstupu. Výchozí hodnota je Žádná.

Name Typ Description
AutoFit

string

Vložte výstup (pomocí pole letterbox nebo pillar box) a respektujte rozlišení výstupu a zároveň se ujistěte, že aktivní oblast videa ve výstupu má stejný poměr stran jako vstup. Pokud je například vstup 1920 × 1080 a předvolba kódování požaduje 1280 × 1280 , výstup bude ve formátu 1280 × 1280, který obsahuje vnitřní obdélník 1280 × 720 v poměru stran 16:9 a oblasti polí sloupků o šířce 280 pixelů vlevo a vpravo.

AutoSize

string

Přepište rozlišení výstupu a změňte ho tak, aby odpovídalo poměru stran zobrazení vstupu bez odsazení. Pokud je například vstup 1920 × 1080 a předvolba kódování požaduje 1280 × 1280 , pak se hodnota v předvolbě přepíše a výstup bude na hodnotě 1280x720, což zachovává poměr stran vstupu 16:9.

None

string

Striktně respektuje rozlišení výstupu zadané v předvolbě kódování bez ohledu na poměr stran pixelů nebo poměr stran zobrazení vstupního videa.

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

Name Typ Description
createdAt

string

Časové razítko vytvoření prostředku (UTC)

createdBy

string

Identita, která vytvořila prostředek.

createdByType

createdByType

Typ identity, která prostředek vytvořila.

lastModifiedAt

string

Časové razítko poslední změny prostředku (UTC)

lastModifiedBy

string

Identita, která naposledy změnila prostředek.

lastModifiedByType

createdByType

Typ identity, která naposledy změnila prostředek.