Filtres

Lorsque vous transmettez du contenu à des clients (événements en streaming en direct ou vidéos à la demande), le fichier manifeste de l'élément multimédia par défaut ne permet pas toujours au client d'interagir avec le contenu comme il le voudrait. Azure Media Services propose des manifestes dynamiques basés sur des filtres prédéfinis.

Les filtres sont des règles côté serveur qui permettent à vos clients d’effectuer des opérations comme :

• Lire une seule section d'une vidéo (au lieu de la vidéo entière). Par exemple :
  • Réduisez le manifeste pour afficher un sous-clip d'un événement en direct (« filtrage de sous-clip »), ou
  • Découpez le début d'une vidéo (« découpage d'une vidéo »).
• Distribuer uniquement les rendus spécifiés et/ou les pistes de langue spécifiées qui sont prises en charge par l’appareil utilisé pour lire le contenu (« filtrage de rendu »).
• Ajustez la fenêtre de présentation (DVR) afin de fournir une longueur limitée de la fenêtre du DVR dans le lecteur (« ajustement de la fenêtre de présentation »).

Avec Media Services, vous pouvez créer des filtres de compte et des filtres d’élément multimédia à appliquer à votre contenu. En outre, vous pouvez associer vos filtres créés au préalable à un localisateur de streaming.

Types de filtres

Il existe deux types de filtres :

• Filtres de compte (globaux) : applicables à n'importe quel élément multimédia dans le compte Azure Media Services et dont la durée de vie correspond à celle du compte.
• Filtres d’élément multimédia (locaux) : applicables uniquement à un élément multimédia avec lequel le filtre a été associé au moment de la création et dont la durée de vie correspond à celle de l'élément multimédia.

Les types Filtres de compte et Filtres d’élément multimédia utilisent exactement les mêmes propriétés pour définir/décrire le filtre. Sauf lorsque vous créez le filtre d’élément multimédia, vous devez spécifier le nom de la ressource à laquelle vous souhaitez associer le filtre.

Selon votre scénario, vous choisissez le type de filtre le plus adapté (filtre d’élément multimédia ou de compte). Les filtres de compte conviennent aux profils d'appareil (filtrage de rendu) alors que les filtres d’élément multimédia peuvent être utilisés pour découper un élément multimédia spécifique.

Utilisez les propriétés suivantes pour décrire les filtres.

presentationTimeRange

Utilisez cette propriété avec les filtres d’élément multimédia. Il n’est pas recommandé de définir la propriété avec des filtres de compte.

Pistes

Vous spécifiez une liste de conditions de propriétés de suivi de filtre (FilterTrackPropertyConditions) selon laquelle les pistes de votre flux de données (streaming en direct ou vidéo à la demande) doivent être incluses dans le manifeste créé dynamiquement. Les filtres sont combinés à l’aide d’une opération logique AND et OR.

Les conditions de propriétés de suivi de filtre décrivent les types de suivi, les valeurs (spécifiées dans le tableau suivant) et les opérations (Equal, NotEqual).

 Exemple

L’exemple suivant définit un filtre de streaming en direct :

{
  "properties": {
    "presentationTimeRange": {
      "startTimestamp": 0,
      "endTimestamp": 170000000,
      "presentationWindowDuration": 9223372036854776000,
      "liveBackoffDuration": 0,
      "timescale": 10000000,
      "forceEndTimestamp": false
    },
    "firstQuality": {
      "bitrate": 128000
    },
    "tracks": [
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Audio"
          },
          {
            "property": "Language",
            "operation": "NotEqual",
            "value": "en"
          },
          {
            "property": "FourCC",
            "operation": "NotEqual",
            "value": "EC-3"
          }
        ]
      },
      {
        "trackSelections": [
          {
            "property": "Type",
            "operation": "Equal",
            "value": "Video"
          },
          {
            "property": "Bitrate",
            "operation": "Equal",
            "value": "3000000-5000000"
          }
        ]
      }
    ]
  }
}

Filtrer vos manifestes HLS ou DASH lors de la création d’un localisateur de streaming

Media Services vous permet de créer un localisateur de streaming préfiltré en transmettant une collection de filtres dans la propriété de filtre sur l’entité de localisateur de streaming. Cela vous permet de préfiltrer tous les manifestes sur le localisateur de streaming. Le manifeste d’origine n’est plus disponible via ce localisateur de diffusion en continu, et seule la réponse filtrée sera accessible aux clients qui demandent les URL pour DASH ou HLS à partir du localisateur de streaming filtré. Cela est utile dans les situations où vous souhaitez publier uniquement une partie d’une ressource et empêcher les utilisateurs d’accéder au manifeste d’origine complet de la ressource en manipulant la chaîne de requête de l’URL du manifeste HLS ou DASH.

Vous pouvez spécifier une liste de filtres de compte ou d'élément multimédia sur votre localisateur de streaming. Le packager dynamique applique cette liste de filtres avec ceux spécifiés par votre client dans l’URL. Cette combinaison génère un manifeste dynamique qui est basé sur les filtres spécifiés dans l’URL ainsi que sur ceux que vous spécifiez dans le localisateur de streaming.

Mise à jour de filtres

Les filtres et les localisateurs de streaming peuvent être mis à jour à la volée. Gardez toutefois à l’esprit que les mises à jour sur les serveurs web front-end peuvent prendre jusqu’à 10 secondes et que des problèmes liés à la mise en cache CDN en aval du contenu peuvent survenir si vous mettez à jour le même localisateur de streaming que celui qui a été publié et qui est déjà utilisé en production.

Il est déconseillé de mettre à jour la définition des filtres associés à un localisateur de streaming activement publié, notamment lorsque CDN est activé. Les serveurs et CDN de streaming peuvent disposer de caches internes susceptibles de renvoyer des données en cache obsolètes.

Si la définition du filtre doit être modifiée, envisagez de créer un nouveau filtre et de l'ajouter à l'URL du localisateur de streaming ou de publier un nouveau localisateur de streaming unique faisant directement référence au filtre mis à jour.

Obtenir de l’aide et du support

Vous pouvez contacter Media Services pour toute question ou suivre nos mises à jour selon l’une des méthodes suivantes :

• Q & R
• Stack Overflow. Étiquetez les questions avec azure-media-services.
• @MSFTAzureMedia ou utiliser @AzureSupport pour demander de l’aide.
• Ouvrez un ticket de support via le Portail Azure.