MediaTailor パラメータセッションの動作と永続性 - AWS Elemental MediaTailor

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

MediaTailor パラメータセッションの動作と永続性

AWS Elemental MediaTailor はセッションの初期化時にパラメータを処理し、セッションライフサイクルを通じてパラメータを維持します。動的パラメータシナリオを実装するには、セッションの動作を理解することが不可欠です。

セッションの初期化方法

MediaTailor は、パラメータを使用してセッションを初期化するための複数の方法をサポートしています。

  1. 暗黙的なセッション初期化： 最初のマニフェストリクエストに含まれるパラメータ

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

  2. 明示的セッション初期化 (POST): リクエスト本文で提供されるパラメータ

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

  3. 明示的セッション初期化 (GET): クエリパラメータとして提供されるパラメータ

    GET /v1/session/123456789/originId/index.m3u8?ads.param1=value1&manifestParams.auth_token=abc123
パラメータの永続性とイミュータビリティ

MediaTailor パラメータの動作は、次のルールに従います。

  • 1 回限りの仕様： パラメータはセッションの初期化時に 1 回のみ指定できます

  • セッション全体の永続性： パラメータはセッション全体で維持されます

  • 初期化後のイミュータブル： セッションの作成後にパラメータを変更することはできません

  • 設定エイリアス解決： エイリアスは送信先に転送する前に実際の値に解決されます

パラメータ変更シナリオ

再生中にパラメータを変更するには：

  • 新しいセッションを作成する： 更新されたパラメータ値を使用して新しいセッションを初期化する

  • プレイヤーの移行： プレイヤーを新しいセッションにシームレスに移行する

  • パラメータ継承： 変更されていないパラメータを転送して整合性を維持する

例 タイムシフトパラメータの変更

を 1 時間のウィンドウから 2 時間のウィンドウに変更するには：

  1. 現在のセッション: start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z

  2. 新しいセッションを作成する: start=2024-08-26T10:00:00Z&end=2024-08-26T12:00:00Z

  3. プレイヤーを新しいセッション URL に移行する

重要

1 つのセッションに対する複数の多変量プレイリストリクエストは、最初のリクエストの後にパラメータを更新しません。パラメータはセッション期間中変更できません。