AssetFilter

Article
08/05/2023

AssetFiltersont utilisés pour définir des filtres pour les manifestes de diffusion en continu de votre ressource. Les filtres définis peuvent être appliqués à l’un des protocoles de streaming suivants : HLS, MPEG-DASH, Smooth Streaming et HDS. Media Services génère dynamiquement des manifestes en fonction des filtres spécifiés. Les filtres peuvent être définis au niveau global (Filtre) ou au niveau de la ressource (AssetFilter). Utilisez AssetFilter pour appliquer des filtres à une ressource spécifique. Utilisez Filter pour appliquer des filtres à l’une de vos ressources.

Pour obtenir une vue d’ensemble détaillée et des exemples de code des manifestes générés dynamiquement, consultez Vue d’ensemble des manifestes dynamiques.

Cette rubrique fournit une vue d’ensemble de l’entité AssetFilter (utilisée pour définir des filtres locaux) et montre également comment exécuter diverses opérations avec l’API REST Media Services.

Propriétés AssetFilter
Créer un AssetFilter
Répertorier les AssetFilters
Mettre à jour un filtre
Supprimer un filtre

Important

Lors de l’accès aux entités dans Media Services, vous devez définir les valeurs et les champs d’en-tête spécifiques dans vos requêtes HTTP.
Pour plus d’informations, consultez Configuration du développement de l’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Propriétés AssetFilter

Propriété	Type	Description
`Id` Lecture seule. Défini par Media Services au moment de la création.	Edm.String	Identificateur unique.
`ParentAssetId`	Edm.String	ID d’une ressource parente qui contient une collection de ces filtres.
`Name`	Edm.String	Nom convivial pour AssetFilter.
`PresentationTimeRange`	PresentationTimeRange	Le `PresentationTimeRange` groupe de règles est utilisé pour filtrer les points de début/fin du manifeste, la longueur de la fenêtre de présentation et la position de début dynamique. Media Services utilise des intersections de plusieurs plages pour définir la fenêtre de présentation finale.
`Tracks`	FilterTrackSelect	Contient une collection de `FilterTrackPropertyCondition`s.
`FirstQuality`	FirstQuality	First Quality of Manifest Filter, indique la première vitesse de transmission de qualité pour HLS.

Créer un filtre

Créez un filtre à l’aide d’une requête HTTP POST.

Méthode	URI de demande	Version HTTP
POST	<https:// accountname.restv2>.<location.media.azure.net/api/AssetFilters>	HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête

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

Corps de la demande

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

response

HTTP/1.1 201 Created  
. . .

Liste des filtres

Retourne tous les AssetFilters associés à une ressource.

Méthode	URI de demande	Version HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Assets>('assetId')/AssetFilters()	HTTP/1.1

Retourne un AssetFilters spécifique en spécifiant l’ID AssetFilter qui a été retourné lors de la création de l’entité.

Méthode	URI de demande	Version HTTP
GET	<https:// accountname.restv2>.<location.media.azure.net/api/> AssetFilters('assetFilterID')	HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

Obtenez tous les AssetFilters associés à une ressource.

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

Obtenez un AssetFilter en fonction de son 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

Mettre à jour un filtre

Utilisez PATCH, PUT ou MERGE pour mettre à jour un AssetFilter avec de nouvelles valeurs de propriété.

Remarque

Si vous mettez à jour un filtre, il peut falloir jusqu'à 2 minutes pour que le point de terminaison de diffusion en continu actualise les règles. Si le contenu a été servi à l'aide de ce filtre (puis mis en cache dans des proxys et des caches CDN), la mise à jour de ce filtre peut entraîner des défaillances du lecteur. Il est recommandé d'effacer le cache après la mise à jour du filtre. Si cette option n'est pas possible, envisagez d'utiliser un filtre différent.

Méthode	URI de demande	Version HTTP
PATCH/PUT/MERGE Pour plus d’informations sur ces opérations, consultez PATCH/PUT/MERGE.	<https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName')	HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant sous l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

En-têtes de requête :

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

Corps de la requête :

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

Supprimer un filtre

Les filtres peuvent être supprimés à l’aide d’une requête HTTP DELETE.

Méthode	URI de demande	Version HTTP
Suppression	<https:// accountname.restv2>.<location.media.azure.net/api/AssetFilters>('assetFilterId')	HTTP/1.1

Exemple de demande

Vous pouvez essayer l’exemple suivant dans l’onglet Compositeur de Fiddler.

Pour obtenir la dernière version x-ms-version:, consultez REST Media Services.

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

Partager via

AssetFilter

Propriétés AssetFilter

Créer un filtre

Exemple de demande

response

Liste des filtres

Exemple de demande

Mettre à jour un filtre

Exemple de demande

Supprimer un filtre

Exemple de demande

Ressources supplémentaires