MediaTailor 參數疑難排解指南 - AWS Elemental MediaTailor
字元限制錯誤長度限制錯誤組態別名錯誤參數處理流程問題安全考量和最佳實務

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

MediaTailor 參數疑難排解指南

AWS Elemental MediaTailor 提供在 MediaTailor 中疑難排解常見參數相關問題的指引，包括字元限制、URL 編碼問題和組態別名錯誤。

字元限制錯誤

包含不支援字元的參數值可能會導致錯誤或意外行為。

常見症狀

下列症狀可能表示角色限制問題：

  • 未出現在資訊清單 URLs中的參數

  • 工作階段初始化期間的 HTTP 400 錯誤

  • 截斷或損毀的參數值

  • ADS 請求因 URL 格式錯誤而失敗 URLs

解決步驟

若要解決字元限制錯誤：

  1. 檢閱不支援字元的參數值：:、?、&、=、%、 /

  2. 針對特殊字元套用適當的 URL 編碼 （請參閱 MediaTailor 參數參考和限制)

  3. 避免使用 %%%或 等雙字元 ==

  4. 如果無法使用完整 URLs請考慮其他參數格式

範例 URL 編碼範例

而不是使用：

manifest.redirect_url=https://example.com/path?param=value

使用 URL 編碼格式：

manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue

長度限制錯誤

超過長度限制的參數可能會被截斷或導致錯誤。

長度限制

適用下列長度限制 （如需完整詳細資訊MediaTailor 參數參考和限制，請參閱 )：

  • 資訊清單查詢參數 （總計）：2000 個字元

  • ADS 參數名稱：10，000 個字元

  • ADS 參數值：25，000 個字元

  • ADS URLs：25，000 個字元

解決策略

若要處理長度限制：

  1. 盡可能使用較短的參數名稱和值

  2. 將大型參數值分割成多個較小的參數

  3. 使用組態別名將短別名映射至較長值 （請參閱 MediaTailor 組態別名概觀)

  4. 考慮將外部儲存體用於具有參數參考的大型資料

組態別名錯誤

組態別名問題可能會導致 HTTP 400 錯誤或非預期的參數值。

常見的組態別名錯誤

組態別名經常發生下列錯誤：

  • HTTP 400 錯誤：缺少別名值或其無效

  • 網域變數未正確解析

  • 玩家參數未被別名值取代

解決方案檢查清單

若要解決組態別名錯誤：

  1. 確認所有網域變數都定義為 ConfigurationAliases

  2. 確保玩家參數變數使用player_params.字首

  3. 確認關鍵 URLs (VideoContentSourceUrl、AdSegmentUrlPrefix、ContentSegmentUrlPrefix) 中網域變數的別名值清單詳盡

  4. 檢查工作階段初始化請求是否指定有效的別名值

  5. 驗證 ConfigurationAliases 參數的 JSON 結構

如需詳細的故障診斷指引，請參閱 MediaTailor 組態別名疑難排解指南。

範例 組態別名驗證

確保您的組態包含所有必要的別名：

"ConfigurationAliases": {
    "player_params.origin_domain": {
        "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
        "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
        // Must include all possible values used in session initialization
    }
}

參數處理流程問題

了解參數處理流程有助於疑難排解參數轉送和轉換的問題。

參數處理順序

MediaTailor 會依下列順序處理參數：

  1. 工作階段初始化參數驗證

  2. 組態別名解析 （如適用）

  3. 參數篩選 (ADS 與原始伺服器與資訊清單）

  4. URL 編碼和格式化

  5. 參數應用程式到 URLs

偵錯參數流程

若要偵錯參數處理問題：

  1. 驗證工作階段初始化中已正確指定參數

  2. 檢查組態別名是否解析為預期值

  3. 確認參數出現在正確的 URLs中 （資訊清單、ADS、原始伺服器）

  4. 驗證 URL 編碼是否正確套用

範例 參數流程範例

工作階段初始化：

POST master.m3u8
{
    "playerParams": {"origin_domain": "pdx"},
    "manifestParams": {"test": "123"}
}

別名解析和處理後：

  • 原始伺服器請求： https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd

  • 資訊清單 URL： /v1/master/.../index.m3u8?aws.sessionId=session&test=123

安全考量和最佳實務

MediaTailor 會實作參數處理的安全措施，以防止常見的安全問題。

安全措施

MediaTailor 實作下列安全措施：

  1. 防止資料庫膨脹的輸入大小限制

  2. 適當編碼和淨化使用者輸入

  3. 輸入 URL 編碼以防止回應損毀

最佳實務

遵循以下安全參數處理的最佳實務：

  • 在傳送之前驗證用戶端的參數值

  • 使用組態別名來限制可能的參數值

  • 避免在參數中包含敏感資訊

  • 監控參數用量是否有異常模式

  • 將參數值保持在建議的長度限制內