Filtrera

  • Artikel

Filters används för att definiera filter för tillgångars direktuppspelningsmanifest. Definierade filter kan tillämpas på något av följande direktuppspelningsprotokoll: HLS, MPEG-DASH, Smooth Streaming och HDS. Media Services genererar dynamiskt manifest baserat på angivna filter. Filter kan definieras på global nivå (Filter) eller tillgångsnivå (AssetFilter). Använd Filter för att tillämpa filter på någon av dina tillgångar. Använd AssetFilter för att tillämpa filter på en viss tillgång.

En detaljerad översikt och kodexempel på dynamiskt genererade manifest finns i Översikt över dynamiska manifest.

Det här avsnittet ger en översikt över entiteten Filter (används för att definiera globala filter) och visar även hur du kör olika åtgärder med Media Services REST API.

Viktigt

När du kommer åt entiteter i Media Services måste du ange specifika rubrikfält och värden i dina HTTP-begäranden.
Mer information finns i Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Installation för Media Services REST API Development and Connecting to Media Services with the Media Services REST API).

Filteregenskaper

Egenskap Typ Description
Name Edm.String Eget namn på filtret.
PresentationTimeRange PresentationTimeRange Regelgruppen PresentationTimeRange används för att filtrera manifestets start-/slutpunkter, längden på presentationsfönstret och livestartpositionen. Media Services använder skärningspunkter mellan flera intervall för att definiera det slutliga presentationsfönstret.
Tracks FilterTrackSelect Innehåller en samling FilterTrackPropertyConditionmed s.
FirstQuality FirstQuality First Quality of Manifest Filter anger den första kvalitetsbithastigheten för HLS.

Skapa ett filter

Skapa ett filter med HTTP POST-begäran.

Metod URI för förfrågan HTTP-version
POST <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1

Exempelförfrågan

Du kan prova följande exempel på fliken Fiddler's Composer.

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

Begärandehuvuden

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

Begärandetext

{  
   "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"  
            }  
         ]  
      }  
   ]  
}

Svarsåtgärder

HTTP/1.1 201 Created  
. . .

Listfilter

Filter kan hämtas med hjälp av en HTTP GET-begäran.

Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1
Metod URI för förfrågan HTTP-version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Exempelförfrågan

Du kan prova följande exempel på fliken Fiddler's Composer.

Information om hur du får det senaste x-ms-version:finns i 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

Uppdatera ett filter

Använd PATCH, PUT eller MERGE för att uppdatera ett filter med nya egenskapsvärden.

Anteckning

Om du uppdaterar ett filter kan det ta upp till 2 minuter för slutpunkten för direktuppspelning att uppdatera reglerna. Om innehållet hanteras med det här filtret (och cachelagras i proxyservrar och CDN-cacheminnen) kan uppdatering av det här filtret resultera i spelarfel. Vi rekommenderar att du rensar cacheminnet när du har uppdaterat filtret. Om det här alternativet inte är möjligt bör du överväga att använda ett annat filter.

Metod URI för förfrågan HTTP-version
PATCH/PUT/MERGE

Mer information om dessa åtgärder finns i PATCH/PUT/MERGE.		 <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Exempelförfrågan

Du kan prova följande exempel på fliken Fiddler's Composer.

Information om hur du får det senaste x-ms-version:finns i Media Services REST.

Begärandehuvuden:

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

Begärandetext:

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

Ta bort ett filter

Filter kan tas bort med hjälp av en HTTP DELETE-begäran.

Metod URI för förfrågan HTTP-version
DELETE <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Exempelförfrågan

Du kan prova följande exempel på fliken Fiddler's Composer.

Information om hur du får det senaste x-ms-version:finns i 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