AssetFilter

AssetFilters slouží k definování filtrů pro manifesty streamování vašeho prostředku. Definované filtry je možné použít na kterýkoli z následujících protokolů streamování: HLS, MPEG-DASH, Smooth Streaming a HDS. Služba Media Services dynamicky generuje manifesty na základě zadaných filtrů. Filtry je možné definovat na globální úrovni (Filtr) nebo na úrovni prostředku (AssetFilter). Slouží AssetFilter k použití filtrů na konkrétní prostředek. Použijte Filter k použití filtrů na kterýkoli z vašich prostředků.

Podrobný přehled a ukázky kódu dynamicky generovaných manifestů najdete v tématu Přehled dynamických manifestů.

Toto téma poskytuje přehled AssetFilter entity (sloužící k definování místních filtrů) a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

• AssetFilter – vlastnosti

• Vytvoření filtru AssetFilter

• Výpis filtrů assetů

• Aktualizace filtru

• Odstranění filtru

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.

AssetFilter – vlastnosti

Vlastnost	Typ	Description
Id Jen pro čtení. Nastavení službou Media Services při vytváření.	Edm.String	Jedinečný identifikátor.
ParentAssetId	Edm.String	ID nadřazeného prostředku, který obsahuje kolekci těchto filtrů.
Name	Edm.String	Popisný název filtru AssetFilter.
PresentationTimeRange	PresentationTimeRange	Skupina PresentationTimeRange pravidel se používá k filtrování počátečních a koncových bodů manifestu, délky okna prezentace a pozice živého zahájení. Služba Media Services používá průsečíky více oblastí k definování konečného okna prezentace.
Tracks	FilterTrackSelect	Obsahuje kolekci FilterTrackPropertyConditions.
FirstQuality	FirstQuality	První kvalita filtru manifestu označuje první přenosovou rychlost kvality pro HLS.

Vytvoření filtru

Vytvořte filtr pomocí požadavku HTTP POST.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/AssetFilters>	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žadavku

POST https://<accountname>.restv2.<location>.media.azure.net/api/AssetFilters HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Content-Type: application/json  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net  
  

Text požadavku

  
{    
   "Name":"TestFilter",  
   "ParentAssetId":"nb:cid:UUID:536e555d-1500-80c3-92dc-f1e4fdc6c592",  
   "PresentationTimeRange":{    
      "StartTimestamp":"0",  
      "EndTimestamp":"9223372036854775807",  
      "PresentationWindowDuration":"12000000000",  
      "LiveBackoffDuration":"0",  
      "Timescale":"10000000"  
   },  
   "Tracks":[    
      {    
         "PropertyConditions":  
              [    
            {    
               "Property":"Type",  
               "Value":"audio",  
               "Operator":"Equal"  
            },  
            {    
               "Property":"Bitrate",  
               "Value":"0-2147483647",  
               "Operator":"Equal"  
            }  
         ]  
      }  
   ]  
}  
  

Odpověď

HTTP/1.1 201 Created  
. . .  
  

Filtry seznamů

Vrátí všechny filtry assetu přidružené k assetu.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetId')/AssetFilters()	HTTP/1.1

Vrátí konkrétní filtry AssetFilters zadáním ID AssetFilteru, které bylo vráceno při vytvoření entity.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/> AssetFilters('assetFilterID')	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.

Získejte všechny filtry AssetFilter přidružené k assetu.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Assets('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592')/AssetFilters HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net  
  

Získejte filtr AssetFilter na základě jeho ID.

GET https://<accountname>.restv2.<location>.media.azure.net/api/AssetFilters('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592__%23%23%23__TestFilter') HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net  
  

Aktualizace filtru

Pomocí funkce PATCH, PUT nebo MERGE aktualizujte AssetFilter s novými hodnotami vlastností.

Poznámka

Pokud aktualizujete filtr, může aktualizace pravidel koncovému bodu streamování trvat až 2 minuty. Pokud byl obsah obsluhován pomocí tohoto filtru (a uložený v mezipaměti proxy serverů a mezipamětí CDN), může aktualizace tohoto filtru způsobit selhání přehrávače. Po aktualizaci filtru doporučujeme mezipaměť vymazat. Pokud tato možnost není možná, zvažte použití jiného filtru.

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:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName')	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ů:

MERGE https://<accountname>.restv2.<location>.media.azure.net/api/AssetFilters('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592__%23%23%23__TestFilter')  HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Content-Type: application/json  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000  
Host: media.windows.net  
  

Text požadavku:

{  
   "Tracks":[    
      {    
         "PropertyConditions":  
         [    
            {    
               "Property":"Type",  
               "Value":"audio",  
               "Operator":"Equal"  
            },  
            {    
               "Property":"Bitrate",  
               "Value":"0-2147483647",  
               "Operator":"Equal"  
            }  
         ]  
      }  
   ]  
}  
  

Odstranění filtru

Filtry je možné odstranit pomocí požadavku HTTP DELETE.

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
DELETE	<https:// accountname.restv2>.<location.media.azure.net/api/AssetFilters>('assetFilterId')	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.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/AssetFilters('nb%3Acid%3AUUID%3A536e555d-1500-80c3-92dc-f1e4fdc6c592__%23%23%23__TestFilter') HTTP/1.1  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/json  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: media.windows.net