本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用域变量
使用动态域变量,您可以将多个域名(例如 URL http://my-ads-server.com 中的.com 部分)与配置中的玩家参数一起使用。my-ads-server这样,您就可以在单一配置中使用多个内容源或广告决策服务器 (ADS)。
您可以将域变量与任何包含以下内容的参数一起使用URI:
-
AdDecisionServerUrl
-
AdSegmentUrlPrefix
-
ContentSegmentUrlPrefix
-
LivePreroll.AdDecisionServerUrl
-
VideoContentSourceUrl
域变量与配置别名一起使用以执行动态变量替换。配置别名将一组别名和值映射到用于动态域配置的玩家参数。
创建配置别名以用作动态变量
在开始使用域变量之前,需要为配置创建配置别名。在会话初始化时,您可以使用配置别名作为域替换变量。例如,您可以使用配置别名URL在会话初始化期间动态配置源。
创建配置别名
要使用 MediaTailor控制台创建用于域替换的配置别名,请执行以下步骤。
使用控制台创建配置别名
打开 MediaTailor 控制台,网址为https://console.aws.amazon.com/mediatailor/
。 -
在配置页面的配置别名部分,选择添加玩家参数。
-
键入要用作域名替换的动态变量的玩家参数名称。您必须在名称前面加上
player_params.
。 -
选择确定。
AWS Elemental MediaTailor 在 “配置别名” 部分的表中显示新参数。
-
现在,您将添加别名和值。选择您刚才命名的玩家参数。这将扩展参数名称下方的部分。
选择 “添加新别名”。
-
输入别名密钥和值。 MediaTailor 使用 Valu e 作为域变量的替换值。
使用配置别名为会话动态配置域
设置配置别名后,可以在会话初始化请求中将其用作域的替换变量。这使您能够动态配置会话的域。
限制
使用配置别名时,请注意以下限制:
-
域中使用的所有动态变量都必须定义为
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