Live Events - Get

Získat živou událost
Získá vlastnosti živé události.

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

Parametry identifikátoru URI

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

string

Název účtu služby Media Services.

liveEventName
path True

string

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

Regex pattern: ^[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 žádostí klienta.

Odpovědi

Name Typ Description
200 OK

LiveEvent

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

Other Status Codes

ErrorResponse

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

Příklady

Get a LiveEvent by name

Sample Request

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

Sample Response

{
  "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": {},
  "properties": {
    "description": "",
    "resourceState": "Stopped",
    "provisioningState": "Succeeded",
    "created": "2018-03-03T02:25:08.3474032Z",
    "lastModified": "2018-03-03T02:25:08.3474032Z",
    "useStaticHostname": false,
    "streamOptions": [
      "Default"
    ],
    "input": {
      "keyFrameIntervalDuration": "PT6S",
      "streamingProtocol": "FragmentedMP4",
      "accessToken": null,
      "endpoints": [
        {
          "protocol": "FragmentedMP4",
          "url": "http://clouddeployment.media-test.net/ingest.isml"
        }
      ],
      "timedMetadataEndpoints": []
    },
    "preview": {
      "previewLocator": "763f3ea4-d94f-441c-a634-c833f61a4e04",
      "streamingPolicyName": null,
      "accessControl": {
        "ip": {
          "allow": [
            {
              "name": "AllowAll",
              "address": "0.0.0.0",
              "subnetPrefixLength": 0
            }
          ]
        }
      },
      "endpoints": [
        {
          "protocol": "FragmentedMP4",
          "url": "https://testeventopito4idh2r-weibzmedia05.preview-ts051.channel.media-test.windows-int.net/763f3ea4-d94f-441c-a634-c833f61a4e04/preview.ism/manifest"
        }
      ]
    },
    "encoding": {
      "encodingType": "None",
      "presetName": null
    },
    "crossSiteAccessPolicies": {
      "clientAccessPolicy": "<access-policy><cross-domain-access><policy><allow-from http-methods=\"*\"><domain uri=\"http://*\"/></allow-from><grant-to><resource path=\"/\" include-subpaths=\"true\"/></grant-to></policy></cross-domain-access></access-policy>",
      "crossDomainPolicy": "<cross-domain-policy><allow-access-from domain=\"*\" secure=\"false\" /></cross-domain-policy>"
    }
  }
}

Definice

Name Description
createdByType

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

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 PROTOKOLU IP.

IPRange

Rozsah IP adres v 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. Pokud je vlastnost encodingType nastavená na PassthroughBasic nebo PassthroughStandard, služba jednoduše prochází příchozí vrstvou videa a zvuku do výstupu. Pokud je kódování encodingType nastavené na Standard nebo Premium1080p, kodér v reálném čase překóduje příchozí datový proud do několika 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í. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

LiveEventOutputTranscriptionTrack

Popisuje záznam přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

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 vložení 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 LiveEvent. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Platné hodnoty pro vstupní hodnoty pole jsou Default a LowLatency.

StretchMode

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

systemData

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

createdByType

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

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á Silverlight.

crossDomainPolicy

string

Obsah crossdomain.xml používá Silverlight.

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

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 PROTOKOLU IP.

Name Typ Description
allow

IPRange[]

Seznam povolených IP adres.

IPRange

Rozsah IP adres v 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. Pokud je vlastnost encodingType nastavená na PassthroughBasic nebo PassthroughStandard, služba jednoduše prochází příchozí vrstvou videa a zvuku do výstupu. Pokud je kódování encodingType nastavené na Standard nebo Premium1080p, kodér v reálném čase překóduje příchozí datový proud do několika 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

To je stejné jako PassthroughStandard, viz popis níže. Tato hodnota výčtu je zastaralá.

PassthroughBasic

string

Ingestovaný datový proud prochází živou událostí z kodéru příspěvku 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

Ingestovaný datový proud prochází živou událostí z kodéru příspěvku 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 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ů s přenosovou rychlostí. Výstup nesmí překročit rozlišení 1080p.

Standard

string

Kodér 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ů s přenosovou rychlostí. Výstup nesmí překročit rozlišení 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 smooth streamingu odešle kodér 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í. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

Name Typ Description
operation

string

Porovnávání operace. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

property

string

Název vlastnosti, který chcete vybrat. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

value

string

Hodnota vlastnosti, kterou chcete vybrat. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

LiveEventOutputTranscriptionTrack

Popisuje záznam přepisu ve výstupu živé události vygenerované pomocí přepisu řeči na text. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

Name Typ Description
trackName

string

Název výstupní stopy. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována.

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

Prostředky živé události byly přiděleny, vygenerovaly se adresy URL pro ingestování a náhled a jsou schopné přijímat živé streamy. V tuto chvíli je fakturace aktivní. Pokud chcete zastavit další fakturaci, musíte u prostředku živé události explicitně volat 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 ingestování nebo streamování není v tomto stavu povoleno.

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 zrušují. V tomto přechodném stavu nedochází k žádné fakturaci. Aktualizace nebo streamování nejsou v tomto stavu povoleny.

LiveEventTimedMetadataEndpoint

Koncový bod vložení 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 LiveEvent. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. Platné hodnoty pro vstupní hodnoty pole jsou Default a LowLatency.

Name Typ Description
Default

string

Živé streamování bez zvláštních optimalizací 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 latenci od konce do konce. 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 archivu výstupu nebo převinutí DVR 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 výstupnímu rozlišení. Výchozí hodnota je Žádná.

Name Typ Description
AutoFit

string

Vložte výstup (pomocí poštovní schránky nebo polem sloupku), aby se respektovalo rozlišení výstupu a zároveň se zajistilo, že aktivní oblast videa ve výstupu má stejný poměr stran jako vstup. Pokud je například vstup 1920x1080 a předvolba kódování požaduje 1280x1280, bude výstup 1280x1280, který obsahuje vnitřní obdélník 1280x720 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ídal poměru stran zobrazení vstupu bez odsazení. Pokud je například vstup 1920x1080 a předvolba kódování požaduje hodnotu 1280x1280, hodnota v předvolbě se přepíše a výstup bude na hodnotě 1280x720, což zachová 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.