Delen via

Filter

  • Artikel

Filters worden gebruikt om filters te definiëren voor streamingmanifesten van assets. 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 Filter om filters toe te passen op al uw assets. Gebruik AssetFilter om filters toe te passen op een specifieke asset.

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

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

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 Connecting to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Filtereigenschappen

Eigenschap Type Description
Name Edm.String Beschrijvende naam van het filter.
PresentationTimeRange PresentationTimeRange De PresentationTimeRange regelgroep wordt gebruikt voor het filteren van de begin-/eindpunten van het manifest, de lengte van het presentatievenster en de positie van het live-begin. Media Services maakt gebruik van snijpunten van meerdere bereiken om het uiteindelijke presentatievenster te definiëren.
Tracks FilterTrackSelect Bevat een verzameling van FilterTrackPropertyConditions.
FirstQuality FirstQuality Eerste kwaliteit van manifestfilter, geeft de eerste kwaliteitsbitsnelheid voor HLS aan.

Een filter maken

Maak een filter met behulp van HTTP POST-aanvraag.

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

Voorbeeldaanvraag

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

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

Aanvraagheaders

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

Aanvraagbody

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

Antwoord

HTTP/1.1 201 Created  
. . .

Lijstfilters

Filters kunnen worden opgehaald met behulp van een HTTP GET-aanvraag.

Methode Aanvraag-URI HTTP-versie
GET <https:// accountnaam.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1
Methode Aanvraag-URI HTTP-versie
GET <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 meest recente x-ms-version:versie.

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

Een filter bijwerken

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

Notitie

Als u een filter bijwerkt, kan het tot 2 minuten duren voordat het streaming-eindpunt de regels vernieuwt. Als de inhoud is geleverd met behulp van dit filter (en in de cache is opgeslagen in proxy's en CDN-caches), kan het bijwerken van dit filter leiden tot spelerfouten. Het is raadzaam om de cache te wissen nadat u het filter hebt bijgewerkt. 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 meest recente x-ms-version:versie.

Aanvraagheaders:

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

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/Filters>('filterName') HTTP/1.1

Voorbeeldaanvraag

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

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

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