本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用網域變數
透過動態網域變數,您可以使用多個網域,例如 URL http://my-ads-server.com 的 my-ads-server .com 部分,並在設定中使用播放程式參數。這樣您就可以在單一設定中使用多個內容來源或廣告決策伺服器 (ADS)。
您可以將網域變數與包含下列項目的任何參數搭配使用URI:
-
AdDecisionServerUrl
-
AdSegmentUrlPrefix
-
ContentSegmentUrlPrefix
-
LivePreroll.AdDecisionServerUrl
-
VideoContentSourceUrl
域變量與配置別名一起使用,以執行動態變量替換。組態別名會將一組別名和值對應至用於動態網域組態的播放程式參數。
建立要用作動態變數的組態別名
在開始使用網域變數之前,請先為您的組態建立組態別名。您可以在工作階段初始化時使用組態別名做為網域取代變數。例如,您可以使用組態別名,URL在階段作業初始化期間動態設定原點。
建立組態別名
若要使用 MediaTailor主控台建立用於網域取代的組態別名,請執行下列程序。
使用控制台建立組態別名
在開啟 MediaTailor 主控台https://console.aws.amazon.com/mediatailor/
。 -
在 [組態] 頁面的 [組態別名] 區段中,選擇 [新增播放程式參數]。
-
輸入您想要當做網域取代動態變數使用的播放程式參數名稱。您必須在名稱前面加上
player_params.
。 -
選擇確定。
AWS Elemental MediaTailor 在「組態別名」段落的表格中顯示新參數。
-
現在,您將添加一個別名和值。選取您剛才命名的播放程式參數。這會展開參數名稱下方的區段。
選取 [新增別名]。
-
輸入別名鍵值和值。 MediaTailor 使用 Value 作為網域變數的取代值。
使用組態別名來動態設定階段作業的網域
設定組態別名之後,您可以在工作階段初始化要求中使用它們做為網域的取代變數。這可讓您動態設定工作階段的網域。
限制
使用組態別名時,請注意下列限制:
-
網域中使用的所有動態變數都必須定義為
ConfigurationAliases
動態變數。 -
播放程式參數變數必須加上前綴
player_params.
。例如:player_params.origin_domain
。 -
別名值的列表必須是每個播放器參數的詳盡無遺。
-
如果要求是針對網域中使用的動態值,而且該要求未指定動態變數或該變數的其中一個預先設定的別名,則要求將會失敗,並顯示HTTP
400
狀態碼。
範例 使用示例
以下是包含組態別名和動態網域變數的組態範例。請特別注意玩家參數變數,例如[player_params.origin_domain]
AdDecisionServerUrl
和VideoContentSourceUrl
參數網域中的參數。
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