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 |
---|---|---|---|---|
account
|
path | True |
string |
Název účtu služby Media Services. |
live
|
path | True |
string |
Název živé události, maximální délka je 32. Vzor regulárního výrazu: |
resource
|
path | True |
string |
Název skupiny prostředků v rámci předplatného Azure. |
subscription
|
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 |
OK. Žádost byla úspěšná. |
|
Other Status Codes |
Odpověď na chybu streamování popisující, proč operace selhala. |
Příklady
Get a LiveEvent by name
Ukázkový požadavek
Ukázková odpověď
{
"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 |
---|---|
created |
Typ identity, která vytvořila prostředek. |
Cross |
Zásady klientského přístupu. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Chybová odpověď |
IPAccess |
Řízení přístupu PROTOKOLU IP. |
IPRange |
Rozsah IP adres v schématu CIDR. |
Live |
Živá událost. |
Live |
Určuje typ živé události a volitelné nastavení kódování pro kódování živých událostí. |
Live |
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. |
Live |
Koncový bod živé události. |
Live |
Vstup živé události. |
Live |
Řízení přístupu IP pro vstup živých událostí. |
Live |
Vstupní protokol pro živou událost. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. |
Live |
Podmínka výběru stopy. Tato vlastnost je vyhrazena pro budoucí použití. Jakákoli hodnota nastavená pro tuto vlastnost bude ignorována. |
Live |
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. |
Live |
Nastavení náhledu živých událostí. |
Live |
Řízení přístupu IP pro koncový bod náhledu živé události. |
Live |
Stav prostředku živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012. |
Live |
Koncový bod vložení metadat živé události. |
Live |
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. |
Stream |
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. |
Stretch |
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á. |
system |
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 |
Další informace o chybě |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
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 |
Zásady přístupu mezi weby pro živé události. |
|
properties.description |
string |
Popis živé události. |
properties.encoding |
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 |
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 |
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 |
Stav prostředku živé události. Další informace naleznete v tématu https://go.microsoft.com/fwlink/?linkid=2139012. |
|
properties.streamOptions |
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 |
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 |
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 |
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 |
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 |
Ří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 |
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 |
Vstupní protokol pro živou událost. Tato hodnota je zadána při vytváření a nelze ji aktualizovat. |
|
timedMetadataEndpoints |
Koncové body metadat pro živou událost. |
LiveEventInputAccessControl
Řízení přístupu IP pro vstup živých událostí.
Name | Typ | Description |
---|---|---|
ip |
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 |
Ří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 |
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 |
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 |
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 |
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 |
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 |
Typ identity, která naposledy změnila prostředek. |