Kanál

Článek
07/19/2023

V Azure Media Services (AMS) představuje entita Channel kanál pro zpracování živého streamovaného obsahu. Kanál přijímá živé vstupní streamy jedním ze dvou způsobů:

Místní kodér pro kódování v reálném čase odesílá do kanálu více přenosovou rychlost RTMP nebo Smooth Streaming (fragmentovaný MP4). K získání výstupu technologie Smooth Streaming s více přenosovými rychlostmi můžete použít tyto kodéry pro kódování v reálném čase: MediaExcel, Imagine Communications, Ateme, Envivio, Cisco a Elemental. Následující kodéry pro kódování v reálném čase dodávají na výstupu RTMP: Adobe Flash Live Encoder, Haivision, Telestream Wirecast, Teradek a Tricaster. Ingestované datové proudy procházejí kanály bez dalšího zpracování. Služba Media Services doručí datový proud zákazníkům na vyžádání.
Datový proud s jednou přenosovou rychlostí (v jednom z následujících formátů: RTP (MPEG-TS), RTMPnebo Smooth Streaming (Fragmented MP4)) se odešle do datového proudu s povolenou Channel kódováním v reálném čase pomocí Media Services. Potom Channel provede živé kódování příchozího datového proudu s jednou přenosovou rychlostí do video streamu s více přenosovými rychlostmi (adaptivní). Služba Media Services doručí datový proud zákazníkům na vyžádání.

Počínaje verzí Media Services 2.10 můžete při vytváření kanálu určit, jakým způsobem má kanál přijímat vstupní datový proud a jestli má kanál provádět živé kódování datového proudu. Máte dvě možnosti:

None – Tuto hodnotu zadejte, pokud plánujete použít místní kodér pro kódování v reálném čase, který bude výstupem datového proudu s více přenosovými rychlostmi. V tomto případě příchozí datový proud předával výstupu bez kódování. Toto je chování kanálu před vydáním verze 2.10. Podrobnější informace o práci s kanály tohoto typu najdete v tématu Práce s kanály, které přijímají live stream s více přenosovými rychlostmi z místních kodérů.
Standard – Pokud plánujete použít Media Services ke kódování živého streamu s jednou přenosovou rychlostí do datového proudu s více přenosovými rychlostmi, zvolte tuto hodnotu.

Poznámka

Mějte na paměti, že kódování v reálném čase má dopad na fakturaci, a nezapomeňte, že když kanál kódování za provozu ponecháte ve stavu Spuštěno, budou se účtovat poplatky za fakturaci. Po dokončení události živého streamování doporučujeme okamžitě zastavit spuštěné kanály, abyste se vyhnuli dalším hodinám poplatků. Další informace najdete v článku o práci s kanály, které mají povolené kódování v reálném čase pomocí služby Azure Media Services.

Další informace o živém streamování a správě kanálů najdete v tématu Doručování živého streamování pomocí Azure Media Services.

Důležité

Při přístupu k entitě ve službě Media Services musíte v požadavcích HTTP nastavit konkrétní pole hlaviček a hodnoty.
Další informace najdete v tématu Nastavení pro vývoj rozhraní REST API služby Media Services a připojení ke službě Media Services pomocí rozhraní REST API služby Media Services.

Toto téma poskytuje přehled Channel entity a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

Vytvořit kanály
Spustit kanály
Zastavit kanály
Výpis kanálů
Resetovat kanály
Aktualizovat kanály
Zahájit inzerci
Ukončit reklamu
Zobrazit slate
Skrýt slate
Odstranit kanály

Entita kanálu

Entita Channel obsahuje následující vlastnosti.

Vlastnost	Typ	Description
`Id` Jen pro čtení. Nastaveno službou Media Services.	Edm.String	ID kanálu přiřazené při vytvoření. Formát je: nb:chid:UUID:<GUID>.
`Name`	Edm.String	Název kanálu. 1. Musí být jedinečný v rámci vašeho účtu Media Services. 2. Maximální délka = 32 znaků. 3. Nesmí obsahovat mezery. 4. Pouze pomlčky a alfanumerické znaky. 5. Nelze začínat nebo končit spojovníkem.
`Created` Jen pro čtení. Nastaveno službou Media Services.	Edm.DateTime	Hodnota data a času UTC, která označuje čas vytvoření.
`Description`	Edm.String	Uživatel zadal popis. Maximální délka je 256 znaků.
`LastModified` Jen pro čtení. Nastaveno službou Media Services.	Edm.DateTime	Datum a čas poslední aktualizace kanálu.
`State` Jen pro čtení. Nastaveno službou Media Services.	Edm.String	Aktuální stav kanálu. Mezi možné hodnoty patří: -Zastavil. Toto je počáteční stav kanálu po jeho vytvoření. V tomto stavu je možné aktualizovat vlastnosti kanálu, ale streamování není povolené. -Spuštění. Kanál se spouští. Během tohoto stavu nejsou povoleny žádné aktualizace ani streamování. Pokud dojde k chybě, kanál se vrátí do stavu Zastaveno . -Spuštění. Kanál dokáže zpracovávat živé streamy. -Zastavení. Kanál se zastavuje. Během tohoto stavu nejsou povoleny žádné aktualizace ani streamování. -Odstranění. Kanál se odstraňuje. Během tohoto stavu nejsou povoleny žádné aktualizace ani streamování.
`Input`	ChannelInput ComplexType	Nastavení vstupu kanálu (ingestování).
`Output`	ChannelOutput ComplexType	Nastavení výstupu kanálu.
`Preview`	ChannelPreview ComplexType	Nastavení náhledu kanálu.
`CrossSiteAccessPolicies`	Zásady CrossSiteAccessPolicies	Zásady přístupu mezi weby.
`Programs` Jen pro čtení. Nastaveno službou Media Services.	Kolekce programovýchs.	Odkaz na kolekci programů přidružených ke kanálu.
`EncodingType`	Edm.String	`Optional`. Popisuje konfiguraci kanálu. Povolené hodnoty jsou následující: - `None` – Toto je výchozí hodnota. Když vyberete tuto hodnotu, příchozí datový proud se předá výstupu bez jakéhokoli kódování (jedná se o chování kanálu před vydáním verze 2.10). - `Standard`– Příchozí datový proud s jednou přenosovou rychlostí se odešle do kanálu a překóduje na datový proud s více přenosovými rychlostmi pomocí předvoleb systému.
`Encoding`	Kódování ComplexType	Nastavení kodéru Azure Live.
`Slate`	Břidlice	Toto nastavení je podporováno pouze v `Encoding Type` případě, že je parametr kanálu nastavený na `Standard`hodnotu . Kodér pro kódování v reálném čase v kanálu může být signalizovat přepnutí na obrázek slate. Může být také signalizovat ukončení probíhajícího slate. Kodér pro kódování v reálném čase je možné nakonfigurovat tak, aby v určitých situacích – například během přerušení reklamy – přepnul na slate image a maskoval příchozí video signál. Pokud taková slate není nakonfigurovaná, vstupní video se během této reklamní přestávky maskuje.

ChannelInput ComplexType

Název	Typ	Description
`KeyFrameInterval`	Edm.Time	Tato hodnota se ignoruje, pokud `EncoderType` je nastavená na `Standard`hodnotu . Při použití místního kodéru pro kódování v reálném čase ke generování datového proudu s více přenosovými rychlostmi určuje interval klíčového rámce dobu trvání gop (jak ho externí kodér používá). Po přijetí tohoto příchozího datového proudu kanálem pak můžete živý stream doručit do klientských aplikací pro přehrávání v libovolném z následujících formátů: Smooth Streaming, DASH a HLS. Při živém streamování se HLS vždy dynamicky zabalí. Služba Media Services ve výchozím nastavení automaticky vypočítá poměr balení segmentů HLS (fragmenty na segment) na základě intervalu klíčového snímku, označovaného také jako Skupina obrázků – GOP, který je přijat z kodéru pro kódování v reálném čase.
`StreamingProtocol` Jen pro čtení.	Edm.String	Po nastavení typu kodéru můžete nastavit protokol ingestování. Pokud je hodnota nastavená `Encoder Type` na `None`, jsou platné možnosti: - Fragmentovaný MP4 s více přenosovými rychlostmi (smooth streaming) – RTMP s více přenosovými rychlostmi `Encoder Type` Pokud je nastavená hodnota `None`, je platná, ale nežádoucí, aby se odeslal živý stream RTMP s jednou přenosovou rychlostí nebo technologie Smooth Streaming. Kanál neprovádí žádné zpracování se streamem, takže projde, ale klientské aplikace získají datový proud s jednou přenosovou rychlostí. Pokud je hodnota nastavená `Encoder Type` na `Standard`, jsou platné možnosti: 1. Fragmentovaný MP4 s jednou přenosovou rychlostí (Smooth Streaming) 2. RTMP s jednou přenosovou rychlostí 3. RTP (MPEG-TS): MPEG-2 Transport Stream přes RTP.
`AccessControl`	ChannelInputAccessControl ComplexType	Nastavení řízení přístupu pro vstup kanálu.
`Endpoints` Jen pro čtení.	Typ komplexu ChannelEndpoint	Koncové body vstupu kanálu. Kanál poskytuje vstupní koncové body (adresy URL ingestu), které pak použijete k ingestování živého streamu. Kanál přijímá živé vstupní streamy a zpřístupňuje výstupní streamy pro streamování prostřednictvím jednoho nebo několika koncových bodů streamování.

ChannelPreview ComplexType

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
`AccessControl`	ChannelPreviewAccessControl ComplexType	Nastavení řízení přístupu k náhledu kanálu.
`Endpoints` Jen pro čtení.	Typ komplexu ChannelEndpoint	Koncové body náhledu kanálu.

ChannelInputAccessControl ComplexType

Název	Typ	Description
`IP`	IPAccessControl	IP adresy, které se mohou připojit ke vstupním koncovým bodům kanálu. IP adresy musí být v jednom z následujících formátů: IpV4 adresa se 4 čísly, rozsah adres CIDR.

ChannelPreviewAccessControl ComplexType

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
`IP`	IPAccessControl	IP adresy, které se mohou připojit ke vstupním koncovým bodům kanálu. IP adresy musí být v jednom z následujících formátů: IpV4 adresa se 4 čísly, rozsah adres CIDR

IPAccessControl

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
Povolit	IPRange ComplexType	IP adresy, které se mohou připojit ke vstupním koncovým bodům kanálu. Poznámka: Nastavení této hodnoty na hodnotu null umožní připojení všech zdrojových IP adres. Nastavení na prázdný řetězec ("") neumožňuje, aby se nikdo připojil.

IPRange ComplexType

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
`Name`	Edm.String	Popisný název pro tento rozsah IP adres.
`Address`	Edm.String	Základní IP adresa pro reprezentaci podsítě (například:192.168.0.1).
`SubnetPrefixLength`	Edm.Int32	Počet významných bitů pro masku podsítě (například v následující IP adrese 192.168.0.1/24 představuje 24 počet významných bitů).

Typ komplexu ChannelEndpoint

Název	Typ	Description
`Protocol`	Edm.String	Protokol koncového bodu streamování kanálu.
`Url`	Edm.String	Adresa URL koncového bodu streamování kanálu.

ChannelOutput ComplexType

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
`Hls`	ChannelOutputHls ComplexType	Nastavení specifická pro HLS.

ChannelOutputHls ComplexType

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
`FragmentsPerSegment`	Edm.Int16	Množství fragmentů na segment HTTP Live Streaming (HLS).

Kódování ComplexType

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

Název	Typ	Description
`AdMarkerSource`	Edm.String	Můžete zadat zdroj signálů reklamních značek. Výchozí hodnota je `Api`, což označuje, že kodér pro kódování v reálném čase v kanálu by měl naslouchat asynchronnímu `Ad Marker API`. Druhá platná možnost je `Scte35` (povolená pouze v případě, že je protokol streamování ingestování nastavený na `RTP (MPEG-TS).` hodnotu Když `Scte35` je zadáno), kodér bude analyzovat `SCTE-35` signály ze vstupního streamu RTP (MPEG-TS).
`IgnoreCea708ClosedCaptions`	Edm.bool	`Optional`. Volitelný příznak, který říká kodéru pro kódování v reálném čase, aby ignoroval všechna data titulků CEA 708 vložená do příchozího videa. Když je příznak nastavený na false (výchozí), kodér rozpozná a znovu vloží data CEA 708 do výstupních streamů videa.
`VideoStream`	VideoStream	`Optional`. Popisuje vstupní video stream. Pokud toto pole není zadané, použije se výchozí hodnota. Toto nastavení je povoleno pouze v případě, že je vstupní streamovací protokol nastavený na HODNOTU RTP (MPEG-TS).
`AudioStreams`	AudioStreams	`Optional`. Popisuje vstupní zvukové streamy. Pokud toto pole není zadané, použijí se zadané výchozí hodnoty. Toto nastavení je povoleno pouze v případě, že je vstupní streamovací protokol nastavený na HODNOTU RTP (MPEG-TS).
`SystemPreset`	Edm.String	Určuje předvolbu kodéru, která se má použít pro tento kanál. V současné době je `Default720p` jediná povolená hodnota (výchozí). Další podrobnosti najdete v tématu SystemPreset.

SystemPreset

Default720p určuje kódování videa do následujících 6 vrstev.

Datový tok	Width (Šířka)	Height (Výška)	MaxFPS	Profil	Název výstupního streamu
3500	1280	720	30	Vysoká	Video_1280x720_3500kbps
2200	960	540	30	Vysoká	Video_960x540_2200kbps
1350	704	396	30	Vysoká	Video_704x396_1350kbps
850	512	288	30	Vysoká	Video_512x288_850kbps
550	384	216	30	Vysoká	Video_384x216_550kbps
200	340	192	30	Vysoká	Video_340x192_200kbps

Zvuk je kódován do stereo AAC-LC rychlostí 64 kbps, vzorkovací frekvence 44,1 kHz.

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

VideoStream

Popisuje vstupní video stream. Pokud toto pole není zadané, použije se výchozí hodnota. Toto nastavení je povoleno pouze v případě, že je vstupní streamovací protokol nastavený na HODNOTU RTP (MPEG-TS).

Název	Typ	Description
`Index`	Edm.Int1	Index založený na nule, který určuje, který vstupní video stream má být zpracován kodérem pro kódování v reálném čase v rámci kanálu. Toto nastavení platí jenom v případě, že protokol streamování ingestování je RTP (MPEG-TS). Výchozí hodnota je nula. Doporučuje se odeslat jeden přenosový proud programu (SPTS). Pokud vstupní stream obsahuje více programů, kodér pro kódování v reálném čase parsuje tabulku mapování programů (PMT) ve vstupu, identifikuje vstupy, které mají název typu streamu MPEG-2 Video nebo H.264, a uspořádá je v pořadí zadaném v PMT. Index založený na nule se pak použije k převzetí n-té položky v daném uspořádání.
`Name`	Edm.String	`Optional`. Popisná značka pro tento vstupní video stream.

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním v reálném čase.

AudioStreams

Popisuje vstupní zvukové streamy. Pokud toto pole není zadané, použijí se výchozí hodnoty. Toto nastavení je povolené jenom v případě, že je vstupní streamovací protokol nastavený na RTP (MPEG-TS).

Název	Typ	Description
`Index`	Edm.Int16	Doporučuje se odeslat jeden datový proud přenosu programu (SPTS). Pokud vstupní stream obsahuje více programů, kodér pro kódování v reálném čase v rámci kanálu analyzuje tabulku mapy programu (PMT) ve vstupu, identifikuje vstupy, které mají název typu streamu MPEG-2 AAC ADTS nebo AC-3 System-A nebo AC-3 System-B nebo MPEG-2 Private PES nebo MPEG-1 Audio nebo MPEG-2 Audio, a uspořádá je v pořadí určeném v pmt. Index založený na nule se pak použije k výběru n-té položky v daném uspořádání.
`Name`	Edm.String	`Optional`. Popisná značka pro tento vstupní zvukový stream.
`Language`	Edm.String	`Optional`. Identifikátor jazyka zvukového streamu, který odpovídá standardu ISO 639-2, například ENG. Pokud není k dispozici, výchozí hodnota je UND (undefined). Může být zadáno až 8 sad zvukových datových proudů, pokud je vstup do kanálu MPEG-2 TS přes RTP. Nemohou však existovat žádné dvě položky se stejnou hodnotou indexu.

Může být zadáno až 8 sad {Index, Name, Language}, pokud je vstup do kodéru MPEG-2 TS přes RTP. Nemohou však existovat žádné dvě položky se stejnou hodnotou indexu. Pokud je vstup do kodéru RTMP nebo HTTP (Technologie Smooth Streaming), může být ve vstupu pouze jeden zvukový stream.

Břidlice

Toto nastavení je podporováno pouze v Encoding Type případě, že je vlastnost kanálu nastavená na Standardhodnotu .

Kodér pro kódování v reálném čase v rámci kanálu může být signalizovat přepnutí na snímek slate. Může být také signalizovat ukončení probíhajícího přechodu.

Kodér pro kódování v reálném čase lze nakonfigurovat tak, aby v určitých situacích – například během reklamní přestávky – přepnul na slate image a zamaskoval příchozí video signál. Pokud taková aplikace není nakonfigurovaná, vstupní video se během této reklamní přestávky maskuje.

Název	Typ	Description
`InsertSlateOnAdMarker`	Edm.Bool	Pokud je nastavená hodnota True, nakonfiguruje toto nastavení kodér pro kódování v reálném čase tak, aby během přerušení reklamy vložil slate image. Výchozí hodnotou je hodnota true.
`DefaultSlateAssetId`	Edm.String	`Optional`. Určuje ID prostředku služby Media Services, který obsahuje obrázek s tabulí. Výchozí hodnota je null. Před vytvořením kanálu by se měl jako vyhrazený prostředek nahrát snímek s tabulkou o maximálním rozlišení 1920 × 1080 ve formátu JPEG a velikosti maximálně 3 MB. Název souboru by měl mít příponu *.jpg a tento soubor AssetFile by měl být označen jako primární soubor pro daný prostředek. Tento prostředek nemůže být zašifrovaný v úložišti. Pokud není zadáno výchozí ID prostředku slate a vložení slate do značky reklamy je nastaveno na true, použije se výchozí obrázek Azure Media Services k maskování vstupního streamu.

Podrobnější informace o tomto typu a jeho vlastnostech najdete v tématu Přehled kanálů s povoleným kódováním Live.

Vytvořit kanály

Kanály je možné vytvořit pomocí požadavku POST HTTP a zadáním hodnot vlastností.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<umístění.media.azure.net/api/Channels>	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

POST https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Následující text požadavku ukazuje, jak vytvořit kanál s povoleným kódováním v reálném čase.

{  
   "Id":null,  
   "Name":"testchannel001",     
   "Description":"",  
   "EncoderType":"Standard",  
   "Created":"0001-01-01T00:00:00",  
   "LastModified":"0001-01-01T00:00:00",  
   "State":null,  
   "Input":  
   {  
      "StreamingProtocol":"RTPMPEG2TS",  
      "AccessControl":  
      {  
         "IP":  
         {  
         "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   },  
   "Encoding":  
   {  
      "SystemPreset":"Default720p",  
      "IgnoreCea708ClosedCaptions": false,  
      "AdMarkerSource": "Api",
      "VideoStream":  
      {  
         "Index":1,  
         "Name":"Video stream"  
      },  
      "AudioStreams":  
      [  
         {  
            "Index":0,  
            "Name":"English audio stream",  
            "Language":"ENG"  
         },  
         {  
            "Index":1,  
            "Name":"Spanish audio stream",  
            "Language":"SPA"  
         }  
      ]  
   },  
   "EncodingType": "Standard",  
   "Slate":  
   {  
      "InsertOnAdMarker":true,  
      "DefaultSlateAssetId": "nb:cid:UUID:01234567-0123-0123-0123-01234567"  
   },  
   "Preview":  
   {  
      "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":  
            [  
               {  
                  "Name":"testName1",  
                  "Address":"1.1.1.1",  
                  "SubnetPrefixLength":24  
               }  
            ]  
         }  
      },  
      "Endpoints":[]  
   }  
}

Následující text požadavku ukazuje, jak vytvořit kanál v účtu, který nemá povolené kódování v reálném čase.

{  
"Id":null,  
"Name":"testchannel001",  
"Description":"",  
"Created":"0001-01-01T00:00:00",  
"LastModified":"0001-01-01T00:00:00",  
"State":null,  
"Input":  
   {  
   "KeyFrameInterval":null,  
   "StreamingProtocol":"FragmentedMP4",  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
   "Endpoints":[]  
   },  
"Preview":  
   {  
   "AccessControl":  
      {  
         "IP":  
         {  
            "Allow":[{"Name":"testName1","Address":"1.1.1.1","SubnetPrefixLength":24}]  
         }  
      },  
      "Endpoints":[]  
   },  
"Output":  
   {  
   "Hls":  
      {  
         "FragmentsPerSegment":1  
      }  
   },  
"CrossSiteAccessPolicies":  
   {  
      "ClientAccessPolicy":null,  
      "CrossDomainPolicy":null  
   }  
}

V případě úspěchu se vrátí stavový kód 202 Accepted spolu s reprezentací vytvořené entity v těle odpovědi.

Stavový kód 202 Přijato označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení kanálu. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Úvodní kanály

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channelid')/Start	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Start HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

V případě úspěchu se vrátí stavový kód 202 Přijato . Stavový kód 202 Přijato označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení kanálu. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Zastavit kanály

Kanál lze zastavit pouze v případě, že je ve stavu Spuštěno a všechny programy v kanálu byly zastaveny.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channelid')/Stop	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Stop HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Vypsat kanály

Kanály je možné načíst pomocí požadavku GET HTTP.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	Získat všechny kanály: <https:// název_účtu.restv2>.<umístění.media.azure.net/api/Channels> Získání zadaného kanálu <https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

GET https://testrest.cloudapp.net/api/Channels HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

V případě úspěchu vrátí tato operace stavový kód 200 OK a seznam všech kanálů vytvořených ve vašem účtu Media Services.

Resetovat kanály

Resetuje běhový stav kanálu udržovaný po celou dobu streamování živé prezentace a umožňuje opakované použití kanálu v případě resetování prezentace nebo rekonfigurace kodéru. Před voláním funkce Reset zastavte všechny programy. Reset je možné volat v kanálu, který je ve spuštěném stavu.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channelid')/Reset	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/Reset HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Aktualizovat kanály

Aktualizace vlastnosti existujícího kanálu. Kanál musí být ve stavu Zastaveno .

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
PATCH/PUT/MERGE Další informace o těchto operacích najdete v tématu PATCH/PUT/MERGE.	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

PATCH https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Text požadavku:

"Encoding":{"IgnoreCea708ClosedCaptions": true}

Pokud se aktualizace dokončí synchronně, vrátí stavový kód 204 Žádný obsah ; v opačném případě vrátí stavový kód 202 Přijato . Stavový kód 202 Přijato označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení kanálu. Předáním hodnoty hlavičky operation-id do entity Operation (Operace) načtěte stav. Další informace najdete v tématu Operace ručního dotazování Long-Running.

Spustit inzerci

Kodér pro kódování v reálném čase může být signalizovat spuštění inzerce nebo komerčního přerušení pomocí požadavku POST HTTP a zadáním hodnot vlastností v entitě StartAdvertisement Entity v těle požadavku.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channeled')/StartAdvertisement	HTTP/1.1

Další informace najdete v tématu Přehled kanálů s povoleným kódováním Live.

Entita StartAdvertisement

Tato entita představuje rozhraní API pro spuštění inzerce – jedná se o asynchronní volání kodéru pro kódování v reálném čase za účelem vložení reklamy nebo komerčních přestávek do výstupního datového proudu.

Další informace najdete v tématu Přehled kanálů s povoleným kódováním Live.

Název	Typ	Description
`duration`	Edm.Duration	Doba trvání komerční přestávky v sekundách. To musí být nenulová kladná hodnota, aby mohla začít komerční přestávka. Když probíhá komerční přestávka a doba trvání je nastavená na nulu s CueId odpovídající probíhajícímu komerčnímu přerušení, pak se tento konec zruší.
`cueId`	Edm.Int	Jedinečné ID komerčního přerušení, které má podřízená aplikace použít k provedení příslušných akcí. Musí být kladné celé číslo.
`showSlate`	Edm.Bool	`Optional`. Určuje kodéru pro kódování v reálném čase v rámci kanálu, že musí během komerční přestávky přepnout na výchozí obrázek slate (a zamaskovat příchozí videokanál). Výchozí hodnota je false. Použitá image bude ta, která byla zadána prostřednictvím výchozí vlastnosti ID prostředku slate v době vytvoření kanálu.

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/StartAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Text

{  
   "duration":"PT45S",  
   "cueId":"67520935",  
   "showSlate":"true"  
}

V případě úspěchu se vrátí stavový kód 202 Přijato .

Ukončit reklamu

Kodér pro kódování v reálném čase může být signalizovat ukončení probíhající reklamy nebo komerční přestávky pomocí požadavku POST HTTP.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channeled')/EndAdvertisement	HTTP/1.1

Toto volání by mělo být vyvoláno pouze v případě, že probíhá inzerce.

Další informace najdete v tématu Přehled kanálů s povoleným kódováním Live.

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerova skladatele.

Nejnovější verzi najdete v x-ms-version:tématu Media Services REST.

Hlavičky požadavku:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/EndAdvertisement HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

V případě úspěchu se vrátí stavový kód 202 Přijato .

Zobrazit slate

Určuje kodéru pro kódování v reálném čase v rámci kanálu, že musí během komerční přestávky přepnout na výchozí obrázek slate (a zamaskovat příchozí videokanál). Výchozí hodnota je false. Použitá image bude ta, která byla zadána prostřednictvím výchozí vlastnosti ID prostředku slate v době vytvoření kanálu.

V těle požadavku HTTP použijte vlastnosti entity ShowSlate .

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channeled')/ShowSlate	HTTP/1.1

Další informace najdete v tématu Přehled kanálů s povoleným kódováním Live.

ShowSlate Entity

Další informace najdete v tématu Přehled kanálů s povoleným kódováním Live.

Název	Typ	Description
`duration`	Edm.Duration	Doba trvání v sekundách. Aby bylo možné spustit tabulku, musí to být nenulová kladná hodnota. Pokud existuje průběžná slate a je zadána doba trvání nula, bude tato průběžná slate ukončena.
`assetId`	Edm.String	Určuje ID prostředku služby Media Services, který obsahuje obrázek s tabulí. Před vytvořením kanálu by se měl jako vyhrazený prostředek nahrát snímek s tabulkou o rozlišení 1920x1080 ve formátu JPEG a velikosti maximálně 3 Mbytes (v tomto assetu by neměly být žádné další soubory). Kodér může být signalizovat přepnutí na libovolný obraz slate (a ne pouze na ten, který byl zadán prostřednictvím vlastnosti DefaultSlateAssetId při vytváření kanálu).

DefaultSlateAssetId Pokud je vlastnost zadána a AssetId není zadána, DefaultSlateAssetId bude obrázek použit k maskování vstupního datového proudu. Další informace najdete v tématu Slate.

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerův skladatel.

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

Hlavičky požadavků:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/ShowSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Text

{  
   "duration":"PT45S",  
   "assetId":"nb:cid:UUID:01234567-ABCD-ABCD-EFEF-01234567"  
}

V případě úspěchu se vrátí stavový kód 202 Accepted .

Skrýt slate

Kodér pro kódování v reálném čase může být signalizovat ukončení probíhajícího oznámení pomocí požadavku POST HTTP.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')/HideSlate	HTTP/1.1

Toto volání by mělo být vyvoláno pouze v případě, že existuje průběžná slate.

Další informace najdete v tématu Přehled kanálů s povoleným kódováním Live.

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerův skladatel.

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

Hlavičky požadavků:

POST https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393')/HideSlate HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

V případě úspěchu se vrátí stavový kód 202 Accepted . Stavový kód 202 Accept označuje asynchronní operaci. V takovém případě je hodnota hlavičky operation-id k dispozici také pro použití při dotazování a sledování stavu dlouhotrvajících operací, jako je spuštění nebo zastavení kanálu. Předejte hodnotu hlavičky operation-id do entity operation, aby se načetl stav. Další informace najdete v tématu Ruční dotazování Long-Running Operations.

Odstranit kanály

Odstranění kanálu

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/Channels>('channelid')	HTTP/1.1

Ukázkový požadavek

Následující příklad si můžete vyzkoušet na kartě Fiddlerův skladatel.

Nejnovější verzi najdete v x-ms-version:tématu Rest služby Media Services.

Hlavičky požadavků:

DELETE https://testrest.cloudapp.net/api/Channels('nb:chid:UUID:2c30f424-ab90-40c6-ba41-52a993e9d393') HTTP/1.1  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/json;odata=minimalmetadata  
Accept-Charset: UTF-8  
x-ms-version: 2.19  
Content-Type: application/json;odata=minimalmetadata  
Host: <host URI>  
User-Agent: Microsoft ADO.NET Data Services  
Authorization: Bearer <token value>

Viz také

Doručování živého streamování s využitím Služby Azure Media Services
Program

Sdílet prostřednictvím

Kanál

Entita kanálu

ChannelInput ComplexType

ChannelPreview ComplexType

ChannelInputAccessControl ComplexType

ChannelPreviewAccessControl ComplexType

IPAccessControl

IPRange ComplexType

Typ komplexu ChannelEndpoint

ChannelOutput ComplexType

ChannelOutputHls ComplexType

Kódování ComplexType

SystemPreset

VideoStream

AudioStreams

Břidlice

Vytvořit kanály

Ukázkový požadavek

Úvodní kanály

Ukázkový požadavek

Zastavit kanály

Ukázkový požadavek

Vypsat kanály

Ukázkový požadavek

Resetovat kanály

Ukázkový požadavek

Aktualizovat kanály

Ukázkový požadavek

Spustit inzerci

Entita StartAdvertisement

Ukázkový požadavek

Ukončit reklamu

Ukázkový požadavek

Zobrazit slate

ShowSlate Entity

Ukázkový požadavek

Skrýt slate

Ukázkový požadavek

Odstranit kanály

Ukázkový požadavek

Viz také

Další materiály