Program

Článek
08/05/2023

Program umožňuje řídit publikování a ukládání segmentů v živém datovém proudu. Programy mohou běžet souběžně. To vám umožní publikovat a archivovat různé části události podle potřeby.

Nastavením vlastnosti (až 25 hodin) můžete určit počet hodin uchovávání zaznamenaného obsahu pro program ArchiveWindowLength . Klienti můžou archivovaný obsah hledat po zadaný počet hodin. Pokud program běží déle než zadaný ArchiveWindowLength, starší obsah je odebrán. Další informace najdete v ArchiveWindowLength následující dokumentaci.

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

Vytváření programů
Spustit programy
Zastavit programy
Výpis programů
Aktualizace programů
Odstranit programy

Důležité

Při přístupu k entitám ve službě Media Services musíte v požadavcích HTTP nastavit specifická 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.

Vlastnosti entity programu

Entita Program obsahuje následující vlastnosti.

Vlastnost	Typ	Description
`Id` Jen pro čtení. Nastaveno službou Media Services.	Edm.String	ID programu přiřazené při vytvoření. Formát je: nb:pgid:UUID:<GUID>.
`Name`	Edm.String	Název programu. Maximální délka je 256 znaků a může se skládat z libovolných anglických znaků a číslic, včetně "-" a ", pokud začíná a končí alfanumerickými znaky.
`AssetId`	Edm.String	ID prostředku, které se má použít ke zpracování programu. Vlastnost lze aktualizovat, pouze pokud je program ve stavu Zastaveno . Prostředek nelze odstranit, pokud ho používá program. Asset můžete odstranit po odstranění programu, který ho používá.
`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ů.
`ArchiveWindowLength` Povinná hodnota.	Edm.Time	Počet hodin, po který chcete zachovat zaznamenaný obsah programu. Tuto hodnotu můžete nastavit v rozmezí od 5 minut po 25 hodin. To také určuje maximální dobu, po kterou můžou klienti hledat zpět v čase z aktuální živé pozice. Programy můžou běžet po určenou dobu a obsah, který se do délky okna nevejde, bude vždy zahozen. Hodnota této vlastnosti také určuje, jak dlouho můžou růst manifesty klientů. Pokud chcete archivovaný obsah odstranit, zastavte a odstraňte program a pak odstraňte asset přidružený k programu.
`LastModified` Jen pro čtení. Nastaveno službou Media Services.	Edm.DateTime	Datum a čas poslední změny.
`ManifestName`	Edm.String	Název souboru manifestu bez přípony. Tuto vlastnost lze aktualizovat pouze v případě, že je program ve stavu Zastaveno .
`State` Jen pro čtení. Nastaveno službou Media Services.	Edm.String	Získá aktuální stav. Mezi možné hodnoty patří: -Zastavil. Po vytvoření je program ve stavu Zastaveno . V tomto stavu je možné aktualizovat vlastnosti programu, ale streamování není povoleno. Program lze spustit, aktualizovat nebo odstranit z tohoto stavu. -Spuštění. Program se spouští. V tomto stavu nejsou povoleny žádné aktualizace ani streamování. -Spuštění. Program je schopen zpracovávat a archivovat živé streamy. -Zastavení. Program se zastavuje. V tomto stavu nejsou povoleny žádné aktualizace ani streamování.
`ChannelId` Jen pro čtení. Nastaveno službou Media Services.	Edm.String	ID nadřazeného kanálu programu.
`Channel`	Kanál	Nadřazený kanál programu určený identifikátorem ChannelId.

Vytváření programů

Vytvořte nový program.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// název_účtu.restv2>.<umístění.media.azure.net/api/Programs>	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/Programs 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:

{"Id":null,"Name":"testprogram001","Description":"","Created":"0001-01-01T00:00:00","LastModified":"0001-01-01T00:00:00","ChannelId":"nb:chid:UUID:83bb19de-7abf-4907-9578-abe90adfbabe","AssetId":"nb:cid:UUID:bc495364-5357-42a1-9a9d-be54689cfae2","ArchiveWindowLength":"PT1H","State":null,"ManifestName":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.

{"odata.metadata":"https://testrest.cloudapp.net/api/$metadata#Programs/@Element","Id":"nb:pgid:UUID:b870dd57-4b04-41b6-849d-b2470e50e7e6","Name":"testprogram001","Description":"","Created":"2014-08-11T18:12:27.8381256Z","LastModified":"2014-08-11T18:12:27.8381256Z","ChannelId":"nb:chid:UUID:83bb19de-7abf-4907-9578-abe90adfbabe","AssetId":"nb:cid:UUID:bc495364-5357-42a1-9a9d-be54689cfae2","ArchiveWindowLength":"PT1H","State":"Stopped","ManifestName":"f91329ec-26f5-4026-87f5-f5437d4da9e6"}

Poznámka

Tato operace se provádí synchronně, takže neexistuje id operace, které by bylo potřeba sledovat.

Spustit programy

Spusťte program. Program je možné spustit, pouze pokud je ve stavu Zastaveno a kanál je ve stavu Spuštěno .

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
Spustit	<https:// název_účtu.restv2>.<location.media.azure.net/api/Programs>('ProgramId')/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/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc')/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 Accepted 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í programu. 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 programy

Zastavte program. Program lze zastavit, pouze pokud je ve stavu Spuštěno . Toto je asynchronní operace.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
Zastavit	<https:// název_účtu.restv2>.<location.media.azure.net/api/Programs>('ProgramId')/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/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc')/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>

Výpis programů

Programy se načítají pomocí požadavku GET HTTP.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	Získejte všechny programy v účtu Media Services: <https:// název_účtu.restv2>.<umístění.media.azure.net/api/Programs> Získání zadaného programu v účtu Media Services: <https:// název_účtu.restv2>.<location.media.azure.net/api/Programs>('ProgramId') Získání všech programů přidružených k zadanému kanálu: <https:// název_účtu.restv2>.<location.media.azure.net/api/Channels>('channelid')/Programs	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/Programs 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 programů vytvořených ve vašem účtu Media Services.

Aktualizace programů

Aktualizace programu Program 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/Programs>('ProgramId')	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/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc') 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:

{"ArchiveWindowLength":"PT3H"}

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 Accepted 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í programu. 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.

Odstranit programy

Odstranění programu Program je možné odstranit, pouze pokud je ve stavu Zastaveno .

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
DELETE	<https:// název_účtu.restv2>.<location.media.azure.net/api/Programs>('ProgramId')	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:

DELETE https://testrest.cloudapp.net/api/Programs('nb:pgid:UUID:0f9ceb51-50fe-4769-aaed-f8c19d76b9bc') 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 204 Žádný obsah .

Poznámka

Tato operace se provádí synchronně, takže neexistuje id operace, které by bylo potřeba sledovat.

Viz také

Kanál

Sdílet prostřednictvím

Program

Vlastnosti entity programu

Vytváření programů

Ukázkový požadavek

Spustit programy

Ukázkový požadavek

Zastavit programy

Ukázkový požadavek

Výpis programů

Ukázkový požadavek

Aktualizace programů

Ukázkový požadavek

Odstranit programy

Ukázkový požadavek

Viz také

Další materiály