Freigeben über

Filtern

  • Artikel

Filterwerden verwendet, um Filter für Streamingmanifeste von Ressourcen zu definieren. Definierte Filter können auf jedes der folgenden Streamingprotokolle angewendet werden: HLS, MPEG-DASH, Smooth Streaming und HDS. Media Services generiert dynamisch Manifeste basierend auf angegebenen Filtern. Filter können auf globaler Ebene (Filter) oder auf Ressourcenebene (AssetFilter) definiert werden. Verwenden Sie Filter , um Filter auf ihre Ressourcen anzuwenden. Verwenden Sie AssetFilter , um Filter auf ein bestimmtes Medienobjekt anzuwenden.

Eine ausführliche Übersicht und Codebeispiele für dynamisch generierte Manifeste finden Sie unter Übersicht über dynamische Manifeste.

Dieses Thema bietet eine Übersicht über die Filter Entität (die zum Definieren globaler Filter verwendet wird) und veranschaulicht außerdem, wie verschiedene Vorgänge mit der Media Services-REST-API ausgeführt werden.

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

Filtereigenschaften

Eigenschaft type BESCHREIBUNG
Name Edm.String Anzeigename des Filters.
PresentationTimeRange PresentationTimeRange Die PresentationTimeRange Regelgruppe wird zum Filtern von Start-/Endpunkten des Manifests, der Länge des Präsentationsfensters und der Livestartposition verwendet. Media Services verwendet Schnittmengen mehrerer Bereiche, um das endgültige Präsentationsfenster zu definieren.
Tracks FilterTrackSelect Enthält eine Auflistung von FilterTrackPropertyConditions.
FirstQuality FirstQuality First Quality of Manifest Filter, gibt die erste Qualitätsbitrate für HLS an.

Erstellen eines Filters

Erstellen Sie einen Filter mithilfe der HTTP POST-Anforderung.

Methode Anforderungs-URI HTTP-Version
POST <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1

Beispiel für eine Anforderung

Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.

Anforderungsheader

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

Anforderungstext

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

Antwort

HTTP/1.1 201 Created  
. . .

Auflisten von Filtern

Filter können mithilfe einer HTTP GET-Anforderung abgerufen werden.

Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1
Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Beispiel für eine Anforderung

Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.

Informationen zum Aktuellen x-ms-version:finden Sie unter 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

Aktualisieren eines Filters

Verwenden Sie PATCH, PUT oder MERGE, um einen Filter mit neuen Eigenschaftswerten zu aktualisieren.

Hinweis

Wenn Sie einen Filter aktualisieren, kann es bis zu 2 Minuten dauern, bis die Regeln am Streamingendpunkt aktualisiert wurden. Wenn der Inhalt mit diesem Filter verarbeitet (und in Proxys und CDN-Caches zwischengespeichert) wurde, können durch Aktualisieren des Filters Player-Fehler auftreten. Es wird empfohlen, den Cache nach dem Aktualisieren des Filters zu leeren. Wenn dies nicht möglich ist, empfiehlt sich die Verwendung eines anderen Filters.

Methode Anforderungs-URI HTTP-Version
PATCH/PUT/MERGE

Weitere Informationen zu diesen Vorgängen finden Sie unter PATCH, PUT, MERGE.		 <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Beispiel für eine Anforderung

Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.

Anforderungsheader:

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

Anforderungstext:

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

Löschen eines Filters

Filter können mithilfe einer HTTP DELETE-Anforderung gelöscht werden.

Methode Anforderungs-URI HTTP-Version
Delete <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') HTTP/1.1

Beispiel für eine Anforderung

Sie können das folgende Beispiel auf der Registerkarte "Fiddler es Composer" ausprobieren.

Informationen zum Aktuellen x-ms-version:finden Sie unter 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