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

# MediaTailor パラメータセッションの動作と永続性
<a name="parameter-session-behavior"></a>

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

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

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

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

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

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

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

   ```
   GET /v1/session/123456789/originId/index.m3u8?ads.param1=value1&manifestParams.auth_token=abc123
   ```

**パラメータの永続性とイミュータビリティ**  
MediaTailor パラメータの動作は、次のルールに従います。
+ **1 回限りの仕様:** パラメータはセッションの初期化時に 1 回のみ指定できます
+ **セッション全体の永続性:** パラメータはセッション全体で維持されます
+ **初期化後にイミュータブル:** セッションの作成後にパラメータを変更することはできません
+ **設定エイリアス解決:** エイリアスは送信先に転送する前に実際の値に解決されます

**パラメータ変更シナリオ**  
再生中にパラメータを変更するには:
+ **新しいセッションを作成する:** 更新されたパラメータ値を使用して新しいセッションを初期化する
+ **プレイヤーの移行:** プレイヤーを新しいセッションにシームレスに移行する
+ **パラメータ継承:** 変更されていないパラメータを転送して整合性を維持する

**Example タイムシフトパラメータの変更**  
を 1 時間のウィンドウから 2 時間のウィンドウに変更するには:  

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

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

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

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