使用域變數 - AWS Elemental MediaTailor

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

使用域變數

使用動態域變量,您可以使用多個域,例如my-ads-server.com網址的一部分 HTTP://my-ads-server.com,並在您的配置中選擇玩家參數。這使您可以在一個配置中使用多個內容源或廣告決策服務器 (ADS)。

您可以將域變量與包含 URI 的任何參數一起使用:

  • AdDecisionServerUrl

  • AdSegmentUrlPrefix

  • ContentSegmentUrlPrefix

  • LivePreroll.AdDecisionServerUrl

  • VideoContentSourceUrl

域變量與配置別名來執行動態變量替換。配置別名將一組別名和值映射到用於動態域配置的播放器參數。

創建用作動態變量的配置別名

在開始使用域變量之前,請為配置創建配置別名。您可以在會話初始化時使用配置別名作為域替換變量。例如,您可以在會話初始化期間使用配置別名動態配置源 URL。

建立組態別名

要創建要用於域替換的配置別名,請使用 MediaTailor控制台,請執行以下程序。

使用控制台創建配置別名

  1. 開啟 MediaTailor 主控台位於https://console.aws.amazon.com/mediatailor/

  2. 配置別名區段中的組態頁面上,選取新增玩家參數

  3. 鍵入要用作域替換的動態變量的播放器參數名稱。您必須在名稱前加上player_params.

  4. 選擇 OK (確定)

    AWS Elemental Elemental MediaTailor 將在表格中顯示新參數配置別名區段。

  5. 現在,您將添加別名和值。選擇您剛才命名的播放器參數。這將展開參數名稱下面的部分。

    選擇新增別名

  6. 輸入別名金鑰和數值。 MediaTailor 使用數值作為域變量的替換值。

使用配置別名為會話動態配置域

設置配置別名後,您可以在會話初始化請求中將它們用作域的替換變量。這使您能夠為會話動態配置域。

限制

使用配置別名時,請注意下列限制:

  • 域中使用的所有動態變量都必須定義為ConfigurationAliases動態變數。

  • 播放器參數變數必須加上字首player_params.。例如 player_params.origin_domain

  • 對於每個玩家參數,別名值列表必須詳盡無遺。

  • 如果請求在域中使用的動態值,並且該請求沒有為該變量指定動態變量或其中一個預配置的別名,則請求將失敗並顯示 HTTP400狀態碼。

範例 使用範例使用方式

以下為一個包含配置別名和動態域變數的範例。特別注意玩家參數變量,例如[player_params.origin_domain],在AdDecisionServerUrlVideoContentSourceUrl參數域。

PUT /playbackConfiguration { "Name": "aliasedConfig", ... "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]", "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]", ... "ConfigurationAliases": { "player_params.origin_domain": { "pdx": "abc", "iad": "xyz" }, "player_params.region": { "pdx": "us-west-2", "iad": "us-east-1" }, "player_params.endpoint_id": { "pdx": "abcd", "iad": "wxyz" }, "player_params.ad_type": { "customized": "abc12345", "default": "defaultAdType" }, }, ... }

使用上述配置,創建會話初始化請求,指定播放器變量和別名:

POST master.m3u8 { "playerParams": { "origin_domain": "pdx", "region": "pdx", "endpoint_id": "pdx", "ad_type": "customized" } }

MediaTailor 將別名字符串替換為配置別名配置中的映射值。

對 ADS 的請求看起來如下:

https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345

請求VideoContentSource看起來如下:

https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd