Freigeben über

AssetFilter

  • Artikel

AssetFilterwerden verwendet, um Filter für die Streamingmanifeste Ihres Medienobjekts 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 AssetFilter , um Filter auf ein bestimmtes Medienobjekt anzuwenden. Verwenden Sie Filter , um Filter auf ihre Ressourcen 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 AssetFilter Entität (die zum Definieren lokaler 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.

AssetFilter-Eigenschaften

Eigenschaft type BESCHREIBUNG
Id

Schreibgeschützt. Wird bei der Erstellung von Media Services festgelegt.		 Edm.String Eindeutiger Bezeichner.
ParentAssetId Edm.String Die ID eines übergeordneten Medienobjekts, das eine Auflistung dieser Filter enthält.
Name Edm.String Anzeigename für assetFilter.
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/AssetFilters> 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/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

Anforderungstext

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

Antwort

HTTP/1.1 201 Created  
. . .

Auflisten von Filtern

Gibt alle AssetFilter zurück, die einem Medienobjekt zugeordnet sind.

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

Geben Sie einen bestimmten AssetFilter zurück, indem Sie die AssetFilter-ID angeben, die beim Erstellen der Entität zurückgegeben wurde.

Methode Anforderungs-URI HTTP-Version
GET <https:// accountname.restv2>.<location.media.azure.net/api/> AssetFilters('assetFilterID') 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.

Ruft alle AssetFilter ab, die einem Medienobjekt zugeordnet sind.

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

Ruft einen AssetFilter basierend auf seiner ID ab.

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

Aktualisieren eines Filters

Verwenden Sie PATCH, PUT oder MERGE, um einen AssetFilter 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:

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

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