AssetFilter

Artikel
08/05/2023

AssetFilters worden gebruikt om filters te definiëren voor de streamingmanifesten van uw asset. Gedefinieerde filters kunnen worden toegepast op een van de volgende streamingprotocollen: HLS, MPEG-DASH, Smooth Streaming en HDS. Media Services genereert dynamisch manifesten op basis van opgegeven filters. Filters kunnen worden gedefinieerd op globaal niveau (Filter) of assetniveau (AssetFilter). Gebruik AssetFilter om filters toe te passen op een specifieke asset. Gebruik Filter om filters toe te passen op al uw assets.

Zie Overzicht van dynamische manifesten voor een gedetailleerd overzicht en codevoorbeelden van dynamisch gegenereerde manifesten.

Dit onderwerp geeft een overzicht van de entiteit (gebruikt voor het AssetFilter definiëren van lokale filters) en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.

Eigenschappen van AssetFilter
Een AssetFilter maken
AssetFilters weergeven
Een filter bijwerken
Een filter verwijderen

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connect to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

AssetFilter-eigenschappen

Eigenschap	Type	Beschrijving
`Id` Alleen-lezen. Ingesteld door Media Services tijdens het maken.	Edm.String	Unieke id.
`ParentAssetId`	Edm.String	De id van een bovenliggend activum dat een verzameling van deze filters bevat.
`Name`	Edm.String	Beschrijvende naam voor het AssetFilter.
`PresentationTimeRange`	PresentationTimeRange	De `PresentationTimeRange` regelgroep wordt gebruikt voor het filteren van begin-/eindpunten van manifesten, de lengte van het presentatievenster en de livestartpositie. Media Services gebruikt snijpunten van meerdere bereiken om het uiteindelijke presentatievenster te definiëren.
`Tracks`	FilterTrackSelect	Bevat een verzameling van `FilterTrackPropertyCondition`s.
`FirstQuality`	FirstQuality	Eerste kwaliteit van manifestfilter, geeft de eerste kwaliteit bitrate voor HLS aan.

Een filter maken

Maak een filter met behulp van EEN HTTP POST-aanvraag.

Methode	Aanvraag-URI	HTTP-versie
POST	<https:// accountnaam.restv2>.<location.media.azure.net/api/AssetFilters>	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders

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

Aanvraagbody

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

Antwoord

HTTP/1.1 201 Created  
. . .

Lijstfilters

Retourneer alle AssetFilters die aan een asset zijn gekoppeld.

Methode	Aanvraag-URI	HTTP-versie
GET	<https:// accountnaam.restv2>.<location.media.azure.net/api/Assets>('assetId')/AssetFilters()	HTTP/1.1

Retourneer een specifieke AssetFilters door de AssetFilter-id op te geven die is geretourneerd toen de entiteit werd gemaakt.

Methode	Aanvraag-URI	HTTP-versie
GET	<https:// accountnaam.restv2>.<location.media.azure.net/api/> AssetFilters('assetFilterID')	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Alle AssetFilters ophalen die zijn gekoppeld aan een asset.

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

Haal een AssetFilter op op basis van de 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

Een filter bijwerken

Gebruik PATCH, PUT of MERGE om een AssetFilter bij te werken met nieuwe eigenschapswaarden.

Notitie

Als u een filter bijwerkt, kan het tot 2 minuten duren voordat het streaming-eindpunt de regels heeft vernieuwd. Als de inhoud is geleverd met dit filter (en in de cache is opgeslagen in proxy's en CDN-caches), kan het bijwerken van dit filter leiden tot spelerfouten. Het wordt aanbevolen om de cache te wissen na het bijwerken van het filter. Als deze optie niet mogelijk is, kunt u overwegen een ander filter te gebruiken.

Methode	Aanvraag-URI	HTTP-versie
PATCH/PUT/MERGE Zie PATCH/PUT/MERGE voor meer informatie over deze bewerkingen.	<https:// accountnaam.restv2>.<location.media.azure.net/api/Filters>('filterName')	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

Aanvraagheaders:

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

Aanvraagtekst:

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

Een filter verwijderen

Filters kunnen worden verwijderd met behulp van een HTTP DELETE-aanvraag.

Methode	Aanvraag-URI	HTTP-versie
DELETE	<https:// accountnaam.restv2>.<location.media.azure.net/api/AssetFilters>('assetFilterId')	HTTP/1.1

Voorbeeldaanvraag

U kunt het volgende voorbeeld uitproberen op het tabblad Componist van Fiddler.

Zie Media Services REST voor de nieuwste x-ms-version:versie.

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

Delen via

AssetFilter

AssetFilter-eigenschappen

Een filter maken

Voorbeeldaanvraag

Antwoord

Lijstfilters

Voorbeeldaanvraag

Een filter bijwerken

Voorbeeldaanvraag

Een filter verwijderen

Voorbeeldaanvraag

Aanvullende resources