MediaTailor 多个内容和广告来源的域名变量

AWS Elemental MediaTailor 动态域变量允许您使用多个域名，例如 URL http://my-ads-server.com 中的.com部分，并在您的配置中使用播放器参数。my-ads-server这样，您就可以在单一配置中使用多个内容来源或广告决策服务器 (ADS)。

您可以将域变量与任何包含 URI 的参数一起使用：

• AdDecisionServerUrl

• AdSegmentUrlPrefix

• ContentSegmentUrlPrefix

• LivePreroll.AdDecisionServerUrl

• VideoContentSourceUrl

域变量与配置别名一起使用以执行动态变量替换。配置别名将一组别名和值映射到用于动态域配置的玩家参数。

创建配置别名以用作动态变量

在开始使用域变量之前，需要为配置创建配置别名。在会话初始化时，您可以使用配置别名作为域替换变量。例如，您可以使用配置别名在会话初始化期间动态配置源 URL。

创建配置别名

要使用 MediaTailor控制台创建用于域替换的配置别名，请执行以下步骤。

使用控制台创建配置别名

1. 打开 MediaTailor 控制台，网址为https://console.aws.amazon.com/mediatailor/。

2. 在配置页面的配置别名部分，选择添加玩家参数。

3. 键入要用作域名替换的动态变量的玩家参数名称。名称前必须加上player_params.。

4. 选择确定。

   AWS Elemental MediaTailor 在 “配置别名” 部分的表中显示新参数。

5. 现在，您将添加别名和值。选择您刚才命名的玩家参数。这将扩展参数名称下方的部分。

   选择 “添加新别名”。

6. 输入别名密钥和值。 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://777788889999.mediapackage.us-west-2.amazonaws.com/out/v1/abcd