MediaTailor comportement et persistance des paramètres de session - AWS Elemental MediaTailor

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.

MediaTailor comportement et persistance des paramètres de session

AWS Elemental MediaTailor traite les paramètres lors de l'initialisation de la session et les gère tout au long du cycle de vie de la session. Il est essentiel de comprendre le comportement des sessions pour implémenter des scénarios de paramètres dynamiques.

Méthodes d'initialisation de session

MediaTailor prend en charge plusieurs méthodes d'initialisation de session avec des paramètres :

  1. Initialisation implicite de session : paramètres inclus dans la demande de manifeste initiale

    GET /v1/master/123456789/originId/index.m3u8?manifest.auth_token=abc123&start=2024-08-26T10:00:00Z

  2. Initialisation explicite de session (POST) : paramètres fournis dans le corps de la requête

    POST /v1/session/123456789/originId/index.m3u8
{
    "adsParams": {"param1": "value1"},
    "manifestParams": {"auth_token": "abc123"}
}

  3. Initialisation explicite de session (GET) : paramètres fournis sous forme de paramètres de requête

    GET /v1/session/123456789/originId/index.m3u8?ads.param1=value1&manifestParams.auth_token=abc123
Persistance et immuabilité des paramètres

MediaTailor le comportement des paramètres suit les règles suivantes :

  • Spécification unique : les paramètres ne peuvent être spécifiés qu'une seule fois, lors de l'initialisation de la session

  • Persistance à l'échelle de la session : les paramètres sont conservés tout au long de la session

  • Immuable après l'initialisation : les paramètres ne peuvent pas être modifiés après la création de la session

  • Résolution des alias de configuration : les alias sont résolus à leurs valeurs réelles avant d'être transférés vers les destinations

Scénarios de modification de paramètres

Pour modifier les paramètres pendant la lecture, procédez comme suit :

  • Créer une nouvelle session : initialise une nouvelle session avec des valeurs de paramètres mises à jour

  • Transition de joueur : faites passer facilement le joueur à la nouvelle session

  • Héritage des paramètres : reportez les paramètres inchangés pour maintenir la cohérence

Exemple Modification des paramètres de décalage horaire

Pour passer d'une fenêtre d'une heure à une fenêtre de 2 heures :

  1. Session en cours : start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z

  2. Créez une nouvelle session : start=2024-08-26T10:00:00Z&end=2024-08-26T12:00:00Z

  3. Faire passer le lecteur à l'URL de la nouvelle session

Important

Plusieurs demandes de playlist multivariantes pour une même session ne mettent pas à jour les paramètres après la première demande. Les paramètres restent immuables pendant toute la durée de la session.