Sdílet prostřednictvím

Filtrovat

  • Článek

Filters slouží k definování filtrů pro manifesty streamování prostředků. Definované filtry se dají použít na libovolný z následujících streamovacích protokolů: HLS, MPEG-DASH, Technologie 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 (Filter) nebo na úrovni prostředků (AssetFilter). Slouží Filter k použití filtrů na libovolný z vašich prostředků. Slouží AssetFilter k použití filtrů u konkrétního prostředku.

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 entity (sloužící k definování globálních Filter filtrů) a také ukazuje, jak provádět různé operace pomocí rozhraní REST API služby Media Services.

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 filtru

Vlastnost Typ Description
Name Edm.String Popisný název filtru
PresentationTimeRange PresentationTimeRange Skupina PresentationTimeRange pravidel se používá k filtrování počátečních/koncových bodů manifestu, délky okna prezentace a pozice živého zahájení. Služba Media Services používá k definování konečného okna prezentace průniky více oblastí.
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:// název_účtu.restv2>.<umístění.media.azure.net/api/Filters> 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://<accountname>.restv2.<location>.media.azure.net/api/Filters 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":"Mobile",  
   "PresentationTimeRange":{    
      "StartTimestamp":"0",  
      "EndTimestamp":"9223372036854775807",  
      "PresentationWindowDuration":"12000000000",  
      "LiveBackoffDuration":"0",  
      "Timescale":"10000000"  
   },  
   "Tracks":[    
      {    
         "PropertyConditions":[    
            {    
               "Property":"Type",  
               "Value":"video",  
               "Operator":"Equal"  
            },  
            {    
               "Property":"Bitrate",  
               "Value":"550000-1350000",  
               "Operator":"Equal"  
            }  
         ]  
      }  
   ]  
}

Odpověď

HTTP/1.1 201 Created  
. . .

Filtry seznamu

Filtry je možné načíst pomocí požadavku HTTP GET.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// název_účtu.restv2>.<umístění.media.azure.net/api/Filters> HTTP/1.1
Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
GET <https:// název_účtu.restv2>.<location.media.azure.net/api/Filters>('název_filtru') 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.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Filters 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

Aktualizace filtru

Pomocí funkcí PATCH, PUT nebo MERGE můžete aktualizovat filtr s novými hodnotami vlastností.

Poznámka

Pokud aktualizujete filtr, může aktualizace pravidel koncovým bodem streamování trvat až 2 minuty. Pokud byl obsah obsluhován pomocí tohoto filtru (a uložen v mezipaměti na proxy serverech a v mezipaměti 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:// název_účtu.restv2>.<location.media.azure.net/api/Filters>('název_filtru') 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://<accountname>.restv2.<location>.media.azure.net/api/Filters('filterName') 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:// název_účtu.restv2>.<location.media.azure.net/api/Filters>('název_filtru') 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.

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