Partager via

Filtrer

  • Article

Filtersont utilisés pour définir des filtres pour les manifestes de diffusion en continu des ressources. Les filtres définis peuvent être appliqués à l’un des protocoles de diffusion en continu 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 (Filter) ou au niveau de la ressource (AssetFilter). Utilisez Filter pour appliquer des filtres à l’une de vos ressources. Utilisez AssetFilter pour appliquer des filtres à une ressource spécifique.

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

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

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 d’API REST Media Services et Connexion à Media Services avec l’API REST Media Services.

Filtrer les propriétés

Propriété Type Description
Name Edm.String Nom convivial du filtre.
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 FilterTrackPropertyConditions.
FirstQuality FirstQuality La première qualité du filtre de manifeste indique le premier débit 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/Filters> 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.

En-têtes de requête

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

Corps de la demande

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

response

HTTP/1.1 201 Created  
. . .

Liste des filtres

Les filtres peuvent être récupérés à l’aide d’une requête HTTP GET.

Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters> HTTP/1.1
Méthode URI de demande Version HTTP
GET <https:// accountname.restv2>.<location.media.azure.net/api/Filters>('filterName') 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.

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

Mettre à jour un filtre

Utilisez PATCH, PUT ou MERGE pour mettre à jour un filtre 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 dans l’onglet Compositeur de Fiddler.

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

En-têtes de requête :

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

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