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 小時時段變更為 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

重要

單一工作階段的多個多變量播放清單請求不會在第一個請求後更新參數。參數在工作階段持續時間內保持不變。