Création et utilisation d'alias de configuration avec MediaTailor - AWS Elemental MediaTailor
Étape 1 : créer des alias de configurationÉtape 2 : Utiliser des alias de configuration lors de l'initialisation de 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.

Création et utilisation d'alias de configuration avec MediaTailor

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.

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 les variables de domaine dans critical URLs (VideoContentSourceUrl,AdSegmentUrlPrefix,ContentSegmentUrlPrefix).

  • Si une demande est faite pour une variable de domaine critique URLs qui ne spécifie pas la variable dynamique ou utilise un alias non valide, la demande échouera avec un code d'400état HTTP. Les champs non critiques (SlateAdUrl,TranscodeProfileName, bumper URLs) enregistreront les avertissements mais ne feront pas échouer la demande.

Comportement de secours en cas d'alias manquants

Lorsque les alias de configuration sont introuvables ou ne sont pas valides, MediaTailor implémente le comportement de secours suivant :

  • Variables de domaine : si un alias de variable de domaine est manquant ou non valide, la demande échoue avec le code d'état HTTP 400. Des alias valides doivent être définis pour toutes les variables de domaine.

  • Variables non liées au domaine : pour les variables utilisées dans des parties non liées au domaine de URLs (telles que les éléments de chemin ou les paramètres de requête), les alias manquants entraînent le remplacement de chaînes vides.

  • Validation de la configuration : MediaTailor vérifie que tous les alias requis sont présents lors des opérations de création et de mise à jour de la configuration.

Étape 1 : créer des 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.

Console
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. Dans Paramètre du joueur, entrez le nom du paramètre du joueur que vous souhaitez utiliser comme variable dynamique. Par exemple, player_params.origin_domain.

  4. Dans Alias, entrez les alias et leurs valeurs que vous souhaitez utiliser pour le paramètre du joueur.

  5. Choisissez OK.

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

  6. Répétez les étapes précédentes pour ajouter d'autres paramètres au joueur.

  7. Choisissez Enregistrer.

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

Lorsque vous créez ou mettez à jour une MediaTailor configuration, utilisez le ConfigurationAliases paramètre avec la structure JSON suivante : 

{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }

Étape 2 : Utiliser des alias de configuration lors de l'initialisation de 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.

Exemple d'alias de configuration de base

Voici un exemple de configuration de base qui inclut des alias de configuration et des variables de domaine dynamiques :

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"
        }
    }
}
Exemple Initialisation de session avec des alias

En utilisant la configuration précédente, une demande d'initialisation de session utilisant les variables et les alias du lecteur ressemblerait à ce qui suit :

POST index.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 à l'ADS ressemblera à ce qui suit :

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

La demande adressée à l'origine pour les manifestes ressemblera à ce qui suit :

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