创建和使用配置别名 MediaTailor - AWS Elemental MediaTailor
步骤 1：创建配置别名步骤 2：在会话初始化中使用配置别名

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建和使用配置别名 MediaTailor

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

限制

使用配置别名时，请注意以下限制：

  • 域中使用的所有动态变量都必须定义为ConfigurationAliases动态变量。

  • 玩家参数变量前缀必须为。player_params.例如 player_params.origin_domain。

  • 对于处于临界状态 URLs (,,ContentSegmentUrlPrefix) 的域变量VideoContentSourceUrl，AdSegmentUrlPrefix别名值列表必须详尽无遗。

  • 如果请求的关键 URLs 域变量未指定动态变量或使用无效别名，则请求将失败，并显示 HTTP 400 状态码。非关键字段（SlateAdUrl、TranscodeProfileName、bump URLs er）将记录警告，但不会使请求失败。

缺少别名的后备行为

当找不到配置别名或配置别名无效时，将 MediaTailor 实现以下回退行为：

  • 域变量：如果域变量别名缺失或无效，则请求将失败，并显示 HTTP 400 状态码。所有域变量都必须定义有效的别名。

  • 非域变量：对于的非域部分中使用的变量 URLs （例如路径元素或查询参数），缺少别名会导致替换空字符串。

  • 配置验证： MediaTailor 验证在配置创建和更新操作期间是否存在所有必需的别名。

步骤 1：创建配置别名

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

Console
使用控制台创建配置别名

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

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

  3. 在 P layer 参数中，输入要用作动态变量的玩家参数的名称。例如 player_params.origin_domain。

  4. 对于别名，请输入要用于玩家参数的别名及其值。

  5. 选择确定。

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

  6. 重复上述步骤以添加更多播放器参数。

  7. 选择保存。

API
使用 API 创建配置别名

创建或更新 MediaTailor 配置时，请使用具有以下 JSON 结构的ConfigurationAliases参数：

{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }

步骤 2：在会话初始化中使用配置别名

设置配置别名后，可以在会话初始化请求中将其用作域的替换变量。这使您能够动态配置会话的域。

例 基本配置别名示例

以下是包含配置别名和动态域变量的配置的基本示例：

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 index.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

向来源索取清单的请求将如下所示：

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