Utilisation de variables de domaine - AWS Elemental MediaTailor
Création d'alias de configuration à utiliser comme variables dynamiquesUtilisation d'alias de configuration pour configurer dynamiquement les domaines d'une session

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Utilisation de variables de domaine

Avec les variables de domaine dynamiques, vous pouvez utiliser plusieurs domaines, tels que la partie my-ads-server.com du URL http ://my-ads-server.com, avec les paramètres du lecteur dans votre configuration. Cela vous permet d'utiliser plusieurs sources de contenu ou plusieurs serveurs de décision publicitaire (ADS) dans une seule configuration.

Vous pouvez utiliser des variables de domaine avec n'importe quel paramètre contenant URI :

  • AdDecisionServerUrl

  • AdSegmentUrlPrefix

  • ContentSegmentUrlPrefix

  • LivePreroll.AdDecisionServerUrl

  • VideoContentSourceUrl

Les variables de domaine sont utilisées conjointement avec les alias de configuration pour effectuer le remplacement dynamique des variables. Les alias de configuration associent un ensemble d'alias et de valeurs aux paramètres du joueur utilisés pour la configuration dynamique du domaine.

Création d'alias de configuration à utiliser comme variables dynamiques

Avant de commencer à utiliser des variables de domaine, vous devez créer des alias de configuration pour votre configuration. Vous utilisez les alias de configuration comme variables de remplacement de domaine au moment de l'initialisation de la session. Par exemple, vous pouvez utiliser des alias de configuration pour configurer dynamiquement une origine URL lors de l'initialisation de session.

Création d'alias de configuration

Pour créer des alias de configuration à utiliser pour le remplacement de domaines à l'aide de la MediaTailor console, effectuez la procédure suivante.

Pour créer des alias de configuration à l'aide de la console

  1. Ouvrez la MediaTailor console à l'adresse https://console.aws.amazon.com/mediatailor/.

  2. Dans la section Alias de configuration de la page Configurations, choisissez Ajouter un paramètre de joueur.

  3. Entrez le nom du paramètre du lecteur que vous souhaitez utiliser comme variable dynamique pour le remplacement du domaine. Vous devez préfixer le nom avecplayer_params..

  4. Choisissez OK.

    AWS Elemental MediaTailor affiche le nouveau paramètre dans le tableau de la section Alias de configuration.

  5. Vous allez maintenant ajouter un alias et une valeur. Sélectionnez le paramètre du joueur que vous venez de nommer. Cela développe la section située sous le nom du paramètre.

    Sélectionnez Ajouter un nouvel alias.

  6. Entrez une clé d'alias et une valeur. MediaTailor utilise Value comme valeur de remplacement pour la variable de domaine.

Utilisation d'alias de configuration pour configurer dynamiquement les domaines d'une session

Après avoir configuré les alias de configuration, vous pouvez les utiliser comme variables de remplacement pour les domaines dans votre demande d'initialisation de session. Cela vous permet de configurer dynamiquement les domaines de votre session.

Restrictions

Notez les restrictions suivantes lorsque vous utilisez des alias de configuration :

  • Toutes les variables dynamiques utilisées dans le domaine doivent être définies en tant que variables ConfigurationAliases dynamiques.

  • Les variables des paramètres du joueur doivent être préfixées parplayer_params.. Par exemple, player_params.origin_domain.

  • La liste des valeurs aliasées doit être exhaustive pour chaque paramètre du joueur.

  • Si une demande est faite pour une valeur dynamique utilisée dans le domaine et que cette demande ne spécifie pas la variable dynamique ou l'un des alias préconfigurés pour cette variable, la demande échouera avec un code d'HTTP400état.

Exemple d'utilisation

Voici un exemple de configuration qui inclut des alias de configuration et des variables de domaine dynamiques. Portez une attention particulière aux variables des paramètres du joueur, par exemple dans les domaines AdDecisionServerUrl des VideoContentSourceUrl paramètres et. [player_params.origin_domain]

PUT /playbackConfiguration
   {
       "Name": "aliasedConfig",
       ...
       "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
       "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
       ...
       "ConfigurationAliases": {
           "player_params.origin_domain": {
               "pdx": "abc",
               "iad": "xyz"
           },
           "player_params.region": {
               "pdx": "us-west-2",
               "iad": "us-east-1"
           },
           "player_params.endpoint_id": {
               "pdx": "abcd",
               "iad": "wxyz"
           },
           "player_params.ad_type": {
               "customized": "abc12345",
               "default": "defaultAdType"
           },
       },
       ...
   }

À l'aide de la configuration précédente, créez une demande d'initialisation de session en spécifiant les variables et alias du joueur : 

POST master.m3u8
   {
       "playerParams": {
           "origin_domain": "pdx",
           "region": "pdx",
           "endpoint_id": "pdx",
           "ad_type": "customized"
       }
   }

MediaTailor remplace les chaînes d'alias par les valeurs mappées dans la configuration des alias de configuration.

La demande adressée au ADS ressemble à ceci : 

https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345

La demande adressée au VideoContentSource ressemble à ceci : 

https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd