AssetFilter

Artikel
07/19/2023

AssetFilters används för att definiera filter för din tillgångs 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 AssetFilter för att tillämpa filter på en viss tillgång. Använd Filter för att tillämpa filter på någon av dina tillgångar.

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

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

Egenskaper för AssetFilter
Skapa ett tillgångsfilter
Lista tillgångsfilter
Uppdatera ett filter
Ta bort ett filter

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).

Egenskaper för AssetFilter

Egenskap	Typ	Description
`Id` Skrivskyddad. Anges av Media Services vid skapandetillfället.	Edm.String	Unik identifierare.
`ParentAssetId`	Edm.String	ID:t för en överordnad tillgång som innehåller en samling av dessa filter.
`Name`	Edm.String	Eget namn för AssetFilter.
`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 `FilterTrackPropertyCondition`med 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/AssetFilters>	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/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

Begärandetext

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

Svarsåtgärder

HTTP/1.1 201 Created  
. . .

Listfilter

Returnera alla AssetFilters som är associerade med en tillgång.

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

Returnera ett specifikt AssetFilters genom att ange det AssetFilter-ID som returnerades när entiteten skapades.

Metod	URI för förfrågan	HTTP-version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/> AssetFilters('assetFilterID')	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.

Hämta alla tillgångsfilter som är associerade med en tillgång.

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

Hämta ett AssetFilter baserat på dess 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

Uppdatera ett filter

Använd PATCH, PUT eller MERGE för att uppdatera ett AssetFilter 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:

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

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/AssetFilters>('assetFilterId')	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/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

AssetFilter

Egenskaper för AssetFilter

Skapa ett filter

Exempelförfrågan

Svarsåtgärder

Listfilter

Exempelförfrågan

Uppdatera ett filter

Exempelförfrågan

Ta bort ett filter

Exempelförfrågan

Ytterligare resurser