View a markdown version of this page

MediaTailor comportement et persistance des sessions de paramètres - 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 sessions de paramètres

AWS Elemental MediaTailor traite les paramètres lors de l'initialisation de la session et les conserve tout au long du cycle de vie de la session. Il est essentiel de comprendre le comportement des sessions pour mettre en œuvre 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 en tant que 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 :

  • One-time spécification : Les paramètres ne peuvent être spécifiés qu'une seule fois, lors de l'initialisation de la session

  • Session-wide persistance : les paramètres sont conservés pendant toute la durée de la session

  • Immuable après 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 en valeurs réelles avant d'être transférés vers les destinations

Scénarios de modification des paramètres

Pour modifier les paramètres pendant la lecture :

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

  • Transition du joueur  : passez facilement le joueur à la nouvelle session

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

Exemple Modifier les paramètres de décalage temporel

Pour passer d'une fenêtre de 1 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. Transférer le lecteur vers une nouvelle URL de session

Important

Les demandes de playlist multivariantes multiples pour une seule 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.