{
'streamId': 'myStreamId',
'reportingMode': 'client'
}
```
1. 对于 **Prefetch 类型**，请进行选择并选择相应的部分，以获得有关其他字段的帮助：
+ 如果您要为活动中的一个广告时段创建一个预取时间表，请选择 “**单**个”。
+ 如果您要创建的时间表，以便在活动中的每个广告中断之前自动预取广告，请选择 “重**复**”。
## 单次预取时间表
创建一个时间表，在活动中投放一个广告之前预先获取广告。
1. 在 “**检索**” 窗格上，指定要使用的检索设置。这些设置决定何时从 ADS MediaTailor 中预取广告。它们还会决定在 ADS 请求中包含哪些动态会话变量（如果有）。
+ 在 “**开始时间**” 中，输入 MediaTailor 可以开始检索此广告时段的预取时间。 MediaTailor 将尝试针对您的客户在此时间或之后提出的清单请求预取广告。默认值为当前时间。如果您未指定值，则该服务会尽快开始预取检索。
+ 在 “**结束时间**” 中，输入您希望停止 MediaTailor 为此广告时段预取广告的时间。 MediaTailor 将尝试预取在此时间或之前出现的清单请求的广告。检索窗口可以与消费窗口重叠。
+ （可选）配置流量整形以限制一次向 ADS 发出的请求数量。选择以下方法之一：
*时间窗口方法*：对于**流量调整窗口持续时间**，请输入 MediaTailor 应将请求分发到 ADS 的秒数。有关更多信息，请参阅[单一预回迁时间表检索说明](understanding-prefetching.md#avail-matching-criteria-retr)。
*基于 TPS 的方法*：配置**峰值 TPS** 和**峰值并发用户**，以根据每秒交易量和并发用户数限制请求。有关更多信息，请参阅 [基于 TPS 的流量整形](tps-traffic-shaping.md)。
+ 在 “[**动态变量**](variables.md)” 部分，输入多达 100 个动态会话变量。 MediaTailor 在发送给 ADS 的预取请求中使用这些变量进行替换。如果您未输入任何动态会话变量， MediaTailor 请尽力插值 [AD](configurations-create.md#configurations-create-main) S 网址中包含的动态变量的值。
+ 选择 “**添加动态变量**”。
+ 对于 **Key**，输入动态会话变量密钥，例如`scte.event_id`。您可以使用任何 MediaTailor 支持的动态变量。有关动态会话变量的信息，请参见[MediaTailor ADS 请求的会话变量](variables-session.md)。
+ 在 “**值**” 中，输入动态变量值，例如*my-event*。
+ 要添加其他动态变量，请选择选择**添加动态变量**。
1. 在 “**消费**” 窗格上，指定要用于消费窗口的设置。这些设置决定了何时将广告放 MediaTailor 置在广告插播中。它们还会确定您要使用的任何可用性匹配标准。
+ 在 “**开始时间**” 中，输入您想要 MediaTailor 开始将预取广告放置到广告插播时间点的时间。默认值为当前时间。如果您未指定时间，则该服务会尽快开始使用预取数据。
+ 在 “**结束时间**” 中，输入您希望 MediaTailor 停止将预取的广告放入广告插播时间点的时间。 MediaTailor 将尝试针对您的客户在此时间或之前提出的清单请求预取广告。结束时间必须晚于开始时间，且距离现在不到一天。消费窗口可以与检索窗口重叠。
+ 在 “[**可用性匹配条件**](variables.md)” 部分中，选择 “**添加可用性标准**”，然后将尽可能多的广告五个可用性匹配条件添加到您的日程安排中。然后，在 “**动态变量键**” 下，添加动态变量键，例如`scte.event_id`。 MediaTailor *只有*当预取的广告符合由您的客户传递给的动态变量值或从会话数据等信息中推断出的动态变量值定义的条件时 MediaTailor，才会将其放置在广告插 MediaTailor 播中。如果广告插播时间不符合指定的匹配条件，则会 MediaTailor 跳过该广告插播时间的预取。有关信息，请参阅[单次预取计划消耗说明](understanding-prefetching.md#avail-matching-criteria)。
1. 选择 “**添加可用性标准**”。
预取计划在消费窗口结束时间后自动过期。出于诊断目的，它们至少会在 7 天内保持可见，之后它们 MediaTailor 会自动删除。或者，您可以随时手动删除预回迁时间表。有关如何手动删除预回迁时间表的信息，请参阅下一[删除预回迁计划](deleting-prefetch-schedules.md)节。
### 确定您的客户应多久调用 CreatePrefetchSchedule API 的频率
如果您确切知道广告中断的发生时间，则您的客户可以每天以编程方式调用一次 [CreatePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_CreatePrefetchSchedule.html)API 来设置检索和消费。或者，您的客户可以在一天中多次调用 API 来定义检索和使用。选择 API 调用频率时，请考虑[有效预取计划的最大数量](quotas.md#prefetch-schedules-limit)，以及在您创建预取计划后您的广告中断时间表是否会发生变化的可能性。如果在您创建了预提时间表之后，广告中断时间表可能会发生变化，那么您可能需要更频繁地调用 API。
## 定期预取计划
创建时间表，在活动中每个广告投放之前预先获取广告。
1. 在**重复检索**窗格上，指定要使用的检索设置。这些设置决定何时从 ADS MediaTailor 中预取广告。它们还会决定在 ADS 请求中包含哪些动态会话变量（如果有）。
+ 在 “**重复预取” 窗口中**，输入此广告时段 MediaTailor 可以开始预取回的时间。 MediaTailor 将尝试针对您的客户在此时间或之后提出的清单请求预取广告。默认值为当前时间。如果您未指定值，则该服务会尽快开始预取检索。
+ 对于可用性**结束后的延迟**，请输入在可用性结束后等待的秒数，然后再预取下一个可用性的广告。 MediaTailor如果未指定值，则 MediaTailor 默认为无延迟。
+ （可选）配置流量整形以限制一次向 ADS 发出的请求数量。选择以下方法之一：
*时间窗口方法*：对于**流量调整窗口持续时间**，请输入 MediaTailor 应将请求分发到 ADS 的秒数。有关更多信息，请参阅[重复预取计划检索说明](understanding-prefetching.md#avail-matching-criteria-recurring-retr)
*基于 TPS 的方法*：配置**峰值 TPS** 和**峰值并发用户**，以根据每秒交易量和并发用户数限制请求。有关更多信息，请参阅 [基于 TPS 的流量整形](tps-traffic-shaping.md)。
+ 在 “[**动态变量**](variables.md)” 部分，输入多达 100 个动态会话变量。 MediaTailor 在发送给 ADS 的预取请求中使用这些变量进行替换。如果您未输入任何动态会话变量， MediaTailor 请尽力插值 [AD](configurations-create.md#configurations-create-main) S 网址中包含的动态变量的值。
+ 选择 “**添加动态变量**”。
+ 对于 **Key**，输入动态会话变量密钥，例如`scte.event_id`。您可以使用任何 MediaTailor 支持的动态变量。有关动态会话变量的信息，请参见[MediaTailor ADS 请求的会话变量](variables-session.md)。
+ 在 “**值**” 中，输入动态变量值，例如*my-event*。
+ 要添加其他动态变量，请选择选择**添加动态变量**。
1. 在 “**消费**” 窗格上，指定要用于消费窗口的设置。这些设置决定了何时将广告放 MediaTailor 置在广告插播中。它们还会确定您要使用的任何可用性匹配标准。
+ 对于**检索到的广告过期**，请指明检索广告在多长时间内可供插入。
+ 在 “[**可用性匹配条件**](variables.md)” 部分中，选择 “**添加可用性标准**”，然后将尽可能多的广告五个可用性匹配条件添加到您的日程安排中。然后，在 “**动态变量键**” 下，添加动态变量键，例如`scte.event_id`。 MediaTailor *只有*当预取的广告符合由您的客户传递给的动态变量值或从会话数据等信息中推断出的动态变量值定义的条件时 MediaTailor，才会将其放置在广告插 MediaTailor 播中。如果广告插播时间不符合指定的匹配条件，则会 MediaTailor 跳过该广告插播时间的预取。有关信息，请参阅[定期预取计划消耗说明](understanding-prefetching.md#avail-matching-criteria-recur)。
1. 选择 “**添加可用性标准**”。
预取计划在消费窗口结束时间后自动过期。出于诊断目的，它们至少会在 7 天内保持可见，之后它们 MediaTailor 会自动删除。或者，您可以随时手动删除预回迁时间表。有关如何手动删除预回迁时间表的信息，请参阅下一[删除预回迁计划](deleting-prefetch-schedules.md)节。
# 基于 TPS 的流量整形
AWS Elemental MediaTailor 提供了两种可选的流量整形方法，用于限制一次向 ADS 发出的请求数量。基于 TPS 的流量整形为预取计划提供了一种替代基于时间窗的流量整形。这种方法允许您根据每秒交易量 (TPS) 和预期并发用户而不是时间计算来指定广告决策服务器 (ADS) 容量，从而提供更直观的配置。
## 基于 TPS 的流量整形的工作原理
您无需指定检索窗口的持续时间，而是提供以下参数：
峰值 TPS
您的 ADS 每秒可以处理的最大请求数。此参数没有默认值。
并发用户峰值
您的内容的预期并发观看人数峰值。此参数没有默认值。
MediaTailor 无论并发会话数量多少，都会自动将预回迁请求分发到指定的 TPS 限制之内。
**Example 基于 TPS 的配置示例**
你的广告可以处理 500 TPS，你预计在高峰时段会有 100,000 名并发观众。您可以配置：
+ 峰值 TPS：500
+ 并发用户峰值：100,000
MediaTailor 无论并发会话数量多少，都会自动将预回迁请求分发到指定的 TPS 限制之内。
# 删除预回迁计划
以下过程说明如何使用 MediaTailor控制台删除预回迁时间表。*有关如何使用 API 以编程方式删除预取计划的信息，请参阅 MediaTailor API 参考[DeletePrefetchSchedule](https://docs.aws.amazon.com/mediatailor/latest/apireference/API_DeletePrefetchSchedule.html)中的AWS Elemental MediaTailor 。*
**注意**
删除不是实时发生的。在 MediaTailor 删除预回迁时间表时，您可能会遇到延迟，在此期间，预回迁的检索和使用将继续在后台运行。
**使用控制台删除预回迁时间表**
1. 打开 MediaTailor 控制台，网址为[https://console.aws.amazon.com/mediatailor/](https://console.aws.amazon.com/mediatailor/)。
1. 在导航窗格中，选择**配置**。选择包含要删除的预回迁计划的播放配置。
1. 在 “**预回迁计划**” 选项卡上，选择要删除的预回迁时间表。然后选择**删除**。
# 将预处理广告与 AWS Elemental MediaTailor
在[典型的广告插入工作流程](what-is-flow.md)中，对广告进行 MediaTailor 动态转码以匹配内容流，将其保存，然后将广告拼接到直播中。由于此过程仅在 MediaTailor 收到来自广告决策服务器 (ADS) 的 VAST 响应中的广告后才会发生，因此广告可供拼接的时间会有所延迟。如果在广告拼接工作流程中引入额外的延迟（可能是由于广告超时或其他内容或网络问题），则 MediaTailor 可能会部分填补空白，或者完全错过广告时段。
为了缩短将广告拼接到内容中的时间，您可以使用预处理广告。预处理广告是指您在广告插入中使用之前对其进行转码的 MediaTailor 广告。与其在广告中 URLs 提供无条件广告，不 URLs 如为预处理广告提供。在对 MediaTailor 请求的VAST回应中，ADS包含了指向预处理广告的直接链接。通过删除广告拼接中的转码部分， MediaTailor 只需保存广告并将其拼接到内容流中即可。使用预处理广告的广告拼接过程缩短了从通过 VAST 响应得 MediaTailor 知广告到将广告拼接到内容中的时间。
或者，您也可以使用广告预取，即您配置为在 MediaTailor 需要广告插播之前的预定时间执行广告拼接流程。有关广告预取的更多信息，请参阅。[预取广告](prefetching-ads.md)
## 预处理广告要求
以下是使用预处理广告设置广告拼接工作流程时需要考虑的要求。
### `MediaFiles`要求
广告服务器发送到的 VAST 响应 MediaTailor 必须包含`MediaFiles`满足以下要求的响应：
广告 (`Creative`) 必须具有符合内容流比特率变体的变体。 *您有责任确保 VAST 响应使用正确的广告变体来匹配模板清单。*
虽然使用预处理广告可以帮助提高广告插入的效率，但 MediaTailor 无法管理转码过程来确保广告的媒体文件与内容清单规范兼容。如果广告与内容流不匹配，则 MediaTailor 可能会错过插入，或者不匹配可能会导致播放设备出错。
此外，要在不进行 MediaTailor 转码的情况下拼接到内容流中，`MediaFile`必须满足以下要求：
+ 它必须可以在公共互联网上访问，这样 MediaTailor 才能下载它。
+ 它必须使用流式传输，如VAST响应`delivery="streaming"`中所示。
+ 它必须是`.m3u8`（对于 HLS）或`.mpd`（对于 DASH）文件。
**Example 反应迅速**
在以下 VAST 响应示例中， MediaTailor 插入`MediaFile`带有以下内容的 URLs：
+ 对于 HLS 直播， MediaTailor 使用`https://example-ad-origin.amazonaws.com/ad1/index_low.m3u8`。这是第一款`MediaFile`采用流媒体传输和支持的文件扩展名的 (. `m3u8`)。
+ 对于 DASH 直播， MediaTailor 使用`https://example-ad-origin.amazonaws.com/ad1/index.mpd`。这是第一款`MediaFile`采用流媒体传输和支持的文件扩展名的 (. `mpd`)。
```
ExampleAdSystem
ad1
de8e0d33-9c72-4d77-bb3a-f7e566ffc605
00:00:30
```
### 广告清单要求
要使用预处理广告，您的父广告和子广告清单必须满足以下要求：
+ 在 VAST 响应`Creative`部分中链接的清单必须是父广告清单。
+ f URLs or the child 的广告清单必须是相对路径。
+ 子广告清单必须与父多变体播放列表位于同一目录中，且级别相同。子清单不能位于子目录或其他位置。
**Example 支持的父多变体播放列表**
以下父广告多变体播放列表包含子广告媒体 URLs 的相关播放列表。子播放列表也与父多变体播放列表位于同一目录中。
```
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=150000,RESOLUTION=416x234,CODECS="avc1.42e00a,mp4a.40.2"
index_1.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=440000,RESOLUTION=416x234,CODECS="avc1.42e00a,mp4a.40.2"
index_2.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=640000,RESOLUTION=640x360,CODECS="avc1.42e00a,mp4a.40.2"
index_3.m3u8
```
**Example 不支持的父级多变体播放列表：子目录**
以下父级广告多变体播放列表包含子播放列表，这些子播放列表位于相对于父多变体播放列表的子目录中。它不支持预处理广告的播放列表。
```
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=150000,RESOLUTION=416x234,CODECS="avc1.42e00a,mp4a.40.2"
child/index_1.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=440000,RESOLUTION=416x234,CODECS="avc1.42e00a,mp4a.40.2"
child/index_2.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=640000,RESOLUTION=640x360,CODECS="avc1.42e00a,mp4a.40.2"
child/index_3.m3u8
```
**Example 不支持的父级多变体播放列表：绝对 URLs**
以下父广告多变体播放列表包含绝对值 URLs的子播放列表。它不支持预处理广告的播放列表。
```
#EXTM3U
#EXT-X-STREAM-INF:BANDWIDTH=150000,RESOLUTION=416x234,CODECS="avc1.42e00a,mp4a.40.2"
https://example.mediatailor.us-west-2.amazonaws.com/index_1.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=440000,RESOLUTION=416x234,CODECS="avc1.42e00a,mp4a.40.2"
https://example.mediatailor.us-west-2.amazonaws.com/index_2.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=640000,RESOLUTION=640x360,CODECS="avc1.42e00a,mp4a.40.2"
https://example.mediatailor.us-west-2.amazonaws.com/index_3.m3u8
```
## 预处理广告工作流程
以下是对预处理广告在广告拼接工作流程中的运作方式的基本描述。 MediaTailor工作流程的第一部分是为使用预处理广告进行设置所必须采取的操作。第二部分描述了如何 MediaTailor 处理广告。
**第 1 部分：预处理广告的设置**
完成以下步骤，设置在中 MediaTailor使用预处理广告的工作流程。
1. 使用转码器服务（例如）将您的广告素材调整为支持模板清单中不同比特率、分辨率和编解码器的变体。 AWS Elemental MediaConvert
1. 将预先转码 URLs 的媒体文件提供给 ADS，以便在 VAST 响应中使用。
1. 在中@@ [创建您的播放](configurations-create.md)配置 MediaTailor。要使用预处理广告，请在配置中的**流媒体文件调节**设置中选择 “**无**”。
1. 像往常一样继续设置内容分发。
**第 2 部分： MediaTailor 广告处理**
MediaTailor 广告拼接按中所[MediaTailor 广告插入的工作原理](what-is-flow.md)述完成。当 MediaTailor 收到来自 ADS 的 VAST 回复时，它会使用以下逻辑来确定要对广告采取哪些行动。此逻辑由播放配置上的**流媒体文件调节**设置决定。
+ 当 “**流媒体文件调节**” 设置为 “**转码**” 时，在`progressive`交付时对媒体文件进行 MediaTailor 转码，然后将其拼接到清单中。如果没有足够的带有`progressive`投放媒体文件的广告来填补空缺，请对这些广告进行 MediaTailor 转码并使用带有`streaming`投放效果的广告。
+ 当 “**流媒体文件调节**” 设置为 “**无**” 时，将包含 MediaTailor `streaming`投放媒体文件的广告拼接到清单中，而无需对其进行转码。如果没有足够的带有`streaming`投放媒体文件的广告来填补空缺，请对这些广告进行 MediaTailor 转码并使用带有`progressive`投放效果的广告。
# MediaTailor ADS 请求的动态广告变量
AWS Elemental MediaTailor 使用动态广告变量将您的观看会话中的信息传递到广告决策服务器 (ADS)。这些信息可帮助广告为您的观众选择最相关的广告。
本节概述了动态广告变量，并提供了指向特定实施指南的链接。有关 step-by-step配置说明，请参阅下面的各个主题。
**动态变量类型**
MediaTailor 支持四种类型的动态变量：
+ **会话变量**-自动生成的值，例如会话 ID 和 SCTE-35 数据。请参阅[MediaTailor ADS 请求的会话变量](variables-session.md)。
+ **播放器变量**-视频播放器发送的自定义参数。请参阅[MediaTailor ADS 请求的玩家变量](variables-player.md)。
+ 带有**配置别****名的域变量**-用于多源配置的动态 URL 域。
+ **配置别名**-用于动态变量替换的预定义映射。请参阅[配置别名](configuration-aliases-overview.md)。
**常见使用案例**
使用动态广告变量可以：
+ 将观众的人口统计数据和偏好传递给您的广告
+ 根据地理位置将请求路由到不同的起点
+ 通过集成实现时移查看 MediaPackage
+ 实施 A/B 测试和故障转移场景
以下各节提供了有关在中使用动态广告变量的更多详细信息 MediaTailor。
**Topics**
+ [会话变量](variables-session.md)
+ [玩家变量](variables-player.md)
+ [域变量](variables-domains.md)
+ [配置别名](configuration-aliases-overview.md)
+ [传递 ADS 参数](passing-paramters-to-the-ads.md)
+ [参数路由](parameter-routing-behavior.md)
+ [MediaPackage 集成](mediapackage-integration-param.md)
+ [会话行为](parameter-session-behavior.md)
+ [参数参考](parameter-comprehensive-reference.md)
+ [参数疑难解答](parameter-troubleshooting.md)
+ [别名故障排除](configuration-aliases-troubleshooting.md)
有关参数格式化要求和疑难解答，请参阅[MediaTailor 参数参考和限制](parameter-comprehensive-reference.md)和[MediaTailor 参数疑难解答指南](parameter-troubleshooting.md)。
# MediaTailor ADS 请求的会话变量
AWS Elemental MediaTailor 当您配置为在模板 ADS 网址中指定本节中列出的一个或多个变量时，会话数据会发送 AWS Elemental MediaTailor 到广告决策服务器 (ADS)。您可以使用单个变量，也可以连接多个变量以创建单个值。 MediaTailor 生成一些值，然后从清单和玩家的会话初始化请求等来源获取其余值。
下表描述了可在模板 ADS 请求网址配置中使用的会话数据变量。表中列出的章节编号对应于有线电信工程师协会 (SCTE) -35 规范《[数字节目插入提示信息](https://account.scte.org/standards/library/catalog/scte-35-digital-program-insertion-cueing-message/)》的2019a版本。有关广告预取的详细信息，请参阅。[预取广告](prefetching-ads.md)
| Name | 可用于广告预取 | SCTE-35 规格部分 | Description |
| --- | --- | --- | --- |
| [avail.index] | 是 | | 一个数字，表示广告在索引中的位置。在播放会话开始时， MediaTailor 创建清单中所有可用广告的索引，并存储会话剩余部分的索引。当向ADS MediaTailor 提出填补空缺的请求时，它会包括广告可用的索引号。此参数使 ADS 能够通过使用竞争排除和频次上限等功能来改进广告选择。 |
| [avail.random] | 是 | | 一个介于 0 到 10,000,000,000 之间的随机数，作为长数，为每次向 ADS 的请求 MediaTailor 生成。某些广告服务器使用此参数来实现将广告与竞争对手公司的广告进行隔离等功能。 |
| [scte.archive\$1allowed\$1flag] | 是 | 10.3.3.1 | 一个可选的布尔值。当此值为 0 时，将对该片段施加录制限制。当此值为 1 时，不对片段施加录制限制。 |
| [scte.avail\$1num] | 是 | 9.7.2.1 | MediaTailor 从 SCTE-35 字段中解析的值avail\$1num，为长数字。 MediaTailor 可以使用此值来指定线性广告可用数量。值必须为整数。 |
| [scte.avails\$1expected] | 是 | 9,7.2.1 | 一个可选的长整值，它给出当前事件中预期的可用次数。 |
| [scte.delivery\$1not\$1restricted\$1flag] | 是 | 10.3.3.1 | 一个可选的布尔值。当此值为 0 时，将保留接下来的五位。当此值为 1 时，接下来的五位将采用 SCTE-35 规范中描述的含义。 |
| [scte.device\$1restrictions] | 是 | 10.3.3.1 | 一个可选的整数值，表示三个预定义的、独立的和非分层的设备组。有关此变量的更多信息，请参阅 SCTE-35 规范中的 segments\$1 expected 描述。 |
| [scte.event\$1id] | 是 | 9.1 和 9.7.2.1 | MediaTailor 从 SCTE-35 字段中解析的值splice\$1event\$1id，为长数字。 MediaTailor 使用此值来指定线性广告可用数或填充广告服务器查询字符串，例如广告栏位置。值必须为整数。 |
| [scte.no\$1regional\$1blackout\$1flag] | 是 | 10.3.3.1 | 一个可选的布尔值。当此值为 0 时，区域封锁限制适用于该分段。当此值为 1 时，区域封锁限制不适用于该区段。 |
| [scte.segment\$1num] | 是 | 10.3.3.1 | 一个可选的整数值，用于对分段集合中的区段进行编号。有关此变量的更多信息，请参阅 SCTE-35 规范中的 s egment\$1num 描述。 |
| [scte.segmentation\$1event\$1id] | 是 | 10.3.3.1 | MediaTailor 将此变量公开为。[scte.event_id](#scte.event_id) |
| [scte.segmentation\$1type\$1id] | 是 | 10.3.3.1 | 一个可选的 8 位整数值，用于指定分段类型。有关此变量的更多信息，请参阅 SCTE-35 规范中的 s egmentation\$1type\$1id 描述。 |
| [scte.segmentation\$1upid] | `segmentation_upid_type`：是 `private_data`：是 | **segmentation\$1upid：10.3.3.1** 托管私有 UPID：10.3.3.3 | 对应于 SCTE-35 `segmentation_upid` 元素。该`segmentation_upid`元素包含`segmentation_upid_type`和`segmentation_upid_length`。 MediaTailor 支持以下`segmentation_upid`类型： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/mediatailor/latest/ug/variables-session.html) |
| [scte.segmentation\$1upid.assetId] | 是 | | 与托管私有 UPID (0xC) 配合使用，segmentation\$1 upid\$1type用于播客工作流程。 MediaTailor从 MPU 的 private\$1data JSON assetId 结构中的参数中派生此值。有关更多信息，请参阅 [Managed Private UPID JSON structure for a podbuster workflow](#podbuster-workflow)。 |
| [scte.segmentation\$1upid.cueData.key] | 是 | | 与托管私有 UPID (0xC) 配合使用，segmentation\$1 upid\$1type用于播客工作流程。 MediaTailor从 MPU 的 private\$1data JSON cueData.key 结构中的参数中派生此值。有关更多信息，请参阅 [Managed Private UPID JSON structure for a podbuster workflow](#podbuster-workflow)。 |
| [scte.segmentation\$1upid.cueData.value] | 是 | | 与托管私有 UPID (0xC) 配合使用，segmentation\$1 upid\$1type用于播客工作流程。 MediaTailor从 MPU 的 private\$1data JSON cueData.key 结构中的参数中派生此值。有关更多信息，请参阅 [Managed Private UPID JSON structure for a podbuster workflow](#podbuster-workflow)。值可以是字符串。 |
| [scte.segmentation\$1upid.private\$1data.\$1index\$1] | 是 | | 与托管私有 UPID (0xC) 配合使用，segmentation\$1upid\$1type用于定向广告工作流程。 MediaTailor 拆分以冒号分隔的分段 UPID 标记，并创建索引会话变量。该索引对应于以冒号分隔的列表中的位置，忽略了初始冒号中的前导空格。例如，如果`segmentation_upid = ":3213214:2313321/5:3943"`，那么： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/mediatailor/latest/ug/variables-session.html) 值可以是字符串。 |
| [scte.segments\$1expected] | 是 | 10.3.3.1 | 一个可选的整数值，它给出区段集合中各个分段的预期数量。有关此变量的更多信息，请参阅 SCTE-35 规范中的 segments\$1 expected 描述。 |
| [scte.sub\$1segment\$1num] | 是 | 10.3.3.1 | 一个可选的整数值，用于标识子分段集合中的特定子分段。有关此变量的更多信息，请参阅 SCTE-35 规范中的 sub\$1segment\$1num 描述。 |
| [scte.sub\$1segments\$1expected] | 是 | 10.3.3.1 | 一个可选的整数值，它给出子分段集合中各个子分段的预期数量。有关此变量的更多信息，请参阅 SCTE-35 规范中的 sub\$1segments\$1expected 描述。 |
| [scte.unique\$1program\$1id] | 是 | 9.7.2.1 | 由 SCTE-35 splice\$1insert 字段unique\$1program\$1id解析 MediaTailor 的整数值。ADS 使用唯一程序 ID (UPID) 为直播线性流提供程序级广告定向。如果 SCTE-35 命令不是拼接插入，则将其 MediaTailor 设置为空值。值必须为整数。 |
| [session.avail\$1duration\$1ms] | 是 | | 广告投放时段的持续时间（以毫秒为单位）。默认值为 300,000 毫秒。 AWS Elemental MediaTailor 从输入清单中获取持续时间值，如下所示： [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/mediatailor/latest/ug/variables-session.html) |
| [session.avail\$1duration\$1secs] | 是 | | 以秒为单位的广告投放时段或广告可用性，四舍五入到最接近的秒数。 MediaTailor 确定此值的方式与其确定的方式相同[session.avail\$1duration\$1ms]。 |
| [session.client\$1ip] | 否 | | MediaTailor 请求来自的远程 IP 地址。如果 X-forwarded-for 标头已设置，则该值就是 MediaTailor 用于 client\$1ip 的值。 |
| [session.id] | 否 | | 当前播放会话的唯一数字标识符。播放器针对某个会话发出的所有请求都具有相同的 ID，因此它可用于旨在关联针对单一查看的请求的 ADS 字段。 |
| [session.referer] | 否 | | 通常是托管视频播放器的页面的网址。 MediaTailor 将此变量设置为玩家在其请求中使用的Referer标头的值 MediaTailor。如果播放器未提供此标头， MediaTailor 会将 [session.referer] 留空。如果您在清单端点前使用内容分发网络 (CDN) 或代理，并且想要显示此变量，请在此处代理来自播放器的正确标头。 |
| [session.user\$1agent] | 否 | | 从玩家的会话初始化请求中 MediaTailor 收到的User-Agent标头。如果您要在清单终端节点前面使用 CDN 或代理，则必须在此处代理播放器中的正确标头。 |
| [session.uuid] | 否 | | 的替代方案**[session.id]**。这是当前播放会话的唯一标识符，如下所示： e039fd39-09f0-46b2-aca9-9871cc116cde
|
| [avail.source\$1content\$1time\$1epoch\$1ms] | 否 | | 对于 HLS，该值是开始使用的原始分段的 PDT。对于 DASH 来说，` urn:scte:dash:utc-time```该值是包含``. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/mediatailor/latest/ug/variables-session.html) |
**Example**
如果 ADS 要求使用唯一会话标识符传递名为 `deviceSession` 的查询参数，则 AWS Elemental MediaTailor 中的模板 ADS URL 可能类似于下面这样：
```
https://my.ads.server.com/path?deviceSession=[session.id]
```
AWS Elemental MediaTailor 自动为每个直播生成一个唯一的标识符，然后输入该标识符来代替`session.id`。如果标识符是`1234567`，则向 ADS 发出的最终请求将如下所示： MediaTailor
```
https://my.ads.server.com/path?deviceSession=1234567
```
如果 ADS 需要传递多个查询参数，则其中的模板 ADS 网址 AWS Elemental MediaTailor 可能如下所示：
```
https://my.ads.server.com/sample?e=[scte.avails_expected]&f=[scte.segment_num]&g=[scte.segments_expected]&h=[scte.sub_segment_num]&j=[scte.sub_segments_expected]&k=[scte.segmentation_type_id]
```
以下 DASH 标记示例 XML 片段显示了如何使用`scte35:SpliceInsert`：
```
```
以下 DASH 标记示例 XML 片段显示了如何使用`scte35:TimeSignal`：
```
0100
```
以下 DASH 标记示例 XML 片段显示了如何使用`scte35:Binary`：
```
/DAhAAAAAAAAAP/wEAUAAAHAf+9/fgAg9YDAAAAAAAA25aoh
QW5vdGhlciB0ZXN0IHN0cmluZyBmb3IgZW5jb2RpbmcgdG8gQmFzZTY0IGVuY29kZWQgYmluYXJ5Lg==
```
以下 HLS 标签示例显示了如何使用`EXT-X-DATERANGE`：
```
#EXT-X-DATERANGE:ID="splice-6FFFFFF0",START-DATE="2014-03-05T11:
15:00Z",PLANNED-DURATION=59.993,SCTE35-OUT=0xFC002F0000000000FF0
00014056FFFFFF000E011622DCAFF000052636200000000000A0008029896F50
000008700000000
```
以下 HLS 标签示例显示了如何使用`EXT-X-CUE-OUT`：
```
#EXT-OATCLS-SCTE35:/DA0AAAAAAAAAAAABQb+ADAQ6QAeAhxDVUVJQAAAO3/PAAEUrEoICAAAAAAg+2UBNAAANvrtoQ==
#EXT-X-ASSET:CAID=0x0000000020FB6501
#EXT-X-CUE-OUT:201.467
```
以下 HLS 标签示例显示了如何使用`EXT-X-SPLICEPOINT-SCTE35`：
```
#EXT-X-SPLICEPOINT-SCTE35:/DA9AAAAAAAAAP/wBQb+uYbZqwAnAiVDVUVJAAAKqX//AAEjW4AMEU1EU05CMDAxMTMyMjE5M19ONAAAmXz5JA==
```
以下示例显示了如何使用`scte35:Binary`解码：
```
{
"table_id": 252,
"section_syntax_indicator": false,
"private_indicator": false,
"section_length": 33,
"protocol_version": 0,
"encrypted_packet": false,
"encryption_algorithm": 0,
"pts_adjustment": 0,
"cw_index": 0,
"tier": "0xFFF",
"splice_command_length": 16,
"splice_command_type": 5,
"splice_command": {
"splice_event_id": 448,
"splice_event_cancel_indicator": false,
"out_of_network_indicator": true,
"program_splice_flag": true,
"duration_flag": true,
"splice_immediate_flag": false,
"utc_splice_time": {
"time_specified_flag": false,
"pts_time": null
},
"component_count": 0,
"components": null,
"break_duration": {
"auto_return": false,
"duration": {
"pts_time": 2160000,
"wall_clock_seconds": 24.0,
"wall_clock_time": "00:00:24:00000"
}
},
"unique_program_id": 49152,
"avail_num": 0,
"avails_expected": 0
"segment_num": 0,
"segments_expected": 0,
"sub_segment_num": 0,
"sub_segments_expected": 0
},
"splice_descriptor_loop_length": 0,
"splice_descriptors": null,
"Scte35Exception": {
"parse_status": "SCTE-35 cue parsing completed with 0 errors.",
"error_messages": [],
"table_id": 252,
"splice_command_type": 5
}
}
```
# MediaTailor ADS 请求的玩家变量
AWS Elemental MediaTailor 当您配置为在模板 ADS 网址中指定`player_params.`变量时，会 AWS Elemental MediaTailor 将从玩家那里收到的数据发送到 ADS。例如，如果玩家向发送请求`user_id`中名为的查询参数 MediaTailor，则要在 ADS 请求中传递该数据，请将其包含`[player_params.user_id]`在 ADS 网址配置中。
这使您能够控制 ADS 请求中包含的查询参数。通常，您将 ADS 可识别的特殊查询参数添加到 ADS 请求 URL，并提供键-值对作为参数值。
以下过程中使用的示例将使用以下键-值对：
+ *值为 *1 的 param1*：*
+ *值为 *2 的 param2*：*
**添加查询参数作为键-值对**
1. 在中 AWS Elemental MediaTailor，配置 ADS 请求模板网址以引用参数。以下 URL 显示包含了示例参数：
```
https://my.ads.com/path?param1=[player_params.param1]¶m2=[player_params.param2]
```
1. （可选）对于服务器端广告跟踪报告，对播放器上的键-值对进行 URL 编码。 MediaTailor 收到会话初始化请求时，它会对值进行网址解码一次，然后再将其替换为 ADS 请求网址。
**注意**
如果您的 ADS 需要 URL 编码值，请在播放器上对值进行两次 URL 编码。这样，由完成的解码就会为 AD MediaTailor S 生成一个曾经编码过的值。
例如，如果发送到 ADS 的值的解码表示形式为 `param1=value1:¶m2=value2:`，则 URL 编码表示形式为 `param1=value1%3A¶m2=value2%3A`。
1. 在来自玩家的会话初始化调用中，将键值对 MediaTailor 作为单个查询参数的值传递给。以下示例调用将为服务器端和客户端广告跟踪报告提供示例键-值对。
+ 服务器端广告跟踪报告的示例请求 - 使用 URL 编码对
HLS：
```
.m3u8?ads.param1=value1%3A&ads.param2=value2%3A
```
DASH：
```
.mpd?ads.param1=value1%3A&ads.param2=value2%3A
```
+ 客户端广告跟踪报告的示例请求 - 不使用 URL 编码
HLS：
```
POST .m3u8
{
"adsParams": {
"param1": "value1:",
"param2": "value2:"
}
}
```
DASH：
```
POST .mpd
{
"adsParams": {
"param1": "value1:",
"param2": "value2:"
}
}
```
对于服务器端报告，在收到玩家请求时对参数进行 MediaTailor 解码。对于客户端报告，它不会更改 JSON 负载中接收到的参数。 MediaTailor 向 ADS 发送以下请求：
```
https://my.ads.com/?param1=value1:¶m2=value2:
```
这样，`param1` 和 `param2` 键-值对将作为 ADS 请求中的第一类查询参数包含在内。
# MediaTailor 多个内容源的域变量
AWS Elemental MediaTailor **动态域变量允许您在配置中使用多个域名，例如 URL http://my-ads-server.com 的.com部分，以及玩家参数。my-ads-server**这样，您就可以在单一配置中使用多个内容来源或广告决策服务器 (ADS)。
您可以将域变量与任何包含 URI 的参数一起使用：
+ `AdDecisionServerUrl`
+ `AdSegmentUrlPrefix`
+ `ContentSegmentUrlPrefix`
+ `LivePreroll.AdDecisionServerUrl`
+ `VideoContentSourceUrl`
域变量与*配置别*名一起使用以执行动态变量替换。配置别名将一组别名和值映射到用于动态域配置的玩家参数。有关设置过程，请参见[创建和使用配置别名 MediaTailor](creating-configuration-aliases.md)。有关详细的参考信息，请参阅[MediaTailor 配置别名概述](configuration-aliases-overview.md)。
# MediaTailor 配置别名概述
AWS Elemental MediaTailor 配置别名允许在 URL 域和其他支持的字段中进行动态变量替换。使用此功能可在会话初始化 URLs 期间使用多个域并进行动态配置。
## 使用案例
配置别名可为以下场景启用复杂的多配置架构：
+ **地理路由：**使用特定地区的别名，根据观看者的位置将请求路由到不同的来源或广告服务器。有关实施指南，请参阅[CloudFront 源故障转移](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/high_availability_origin_failover.html)。
+ **基于内容的路由：**将不同的内容类型定向到专门的来源或处理管道。有关路由行为的配置，请参阅[为以下各项设置 CDN 路由行为 MediaTailor](cdn-routing-behaviors.md)。
+ **故障转移场景：**使用别名切换实现自动故障转移的备份源和广告服务器。有关实施的详细信息，请参见[MediaTailor 使用 MQAR 实现多区域弹性](media-quality-resiliency.md)和[规划您的 CDN 集成 AWS Elemental MediaTailor](planning-cdn-integration.md)。
+ **A/B 测试：**根据玩家参数路由流量，测试不同的广告服务器、来源或配置。有关负载测试指南，请参阅[ CloudFront 使用真实用户监控功能为 Amazon 准备和运行性能测试](https://aws.amazon.com/blogs/networking-and-content-delivery/prepare-and-run-performance-tests-for-amazon-cloudfront-with-real-user-monitoring/)。
+ **设备特定优化：**针对不同的设备类型或功能优化内容投放和广告投放。有关全面的指导，请参阅[使用 MediaTailor、 MediaPackage和 CDN 设置清单筛选](cdn-emp-manifest-filtering.md)。
+ **负载平衡：**使用动态路由在多个来源或广告服务器之间分配负载。有关实施指导，请参见[MediaTailor 使用 MQAR 实现多区域弹性](media-quality-resiliency.md)和[规划您的 CDN 集成 AWS Elemental MediaTailor](planning-cdn-integration.md)。
## 支持的字段
您可以在以下配置字段中使用动态变量：
+ `VideoContentSourceUrl`
+ `AdDecisionServerUrl`
+ `LivePreroll.AdDecisionServerUrl`
+ `AdSegmentUrlPrefix`
+ `ContentSegmentUrlPrefix`
+ `TranscodeProfileName`
+ `SlateAdUrl`
+ `StartUrl`
+ `EndUrl`
以下各节介绍如何使用配置别名。
**Topics**
+ [使用案例](#configuration-aliases-use-cases)
+ [支持的字段](#configuration-aliases-supported)
+ [创建和使用](creating-configuration-aliases.md)
+ [流程示例](configuration-aliases-examples.md)
# 创建和使用配置别名 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/](https://console.aws.amazon.com/mediatailor/)。
1. **在**配置页面的配置别名**部分，选择**添加玩家参数**。**
1. 在 P **layer 参数**中，输入要用作动态变量的玩家参数的名称。例如 `player_params.origin_domain`。
1. 对于**别名**，请输入要用于玩家参数的别名及其值。
1. 选择**确定**。
AWS Elemental MediaTailor 在 “**配置别名**” 部分的表中显示新参数。
1. 重复上述步骤以添加更多播放器参数。
1. 选择**保存**。
------
#### [ 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：在会话初始化中使用配置别名
设置配置别名后，可以在会话初始化请求中将其用作域的替换变量。这使您能够动态配置会话的域。
**Example 基本配置别名示例**
以下是包含配置别名和动态域变量的配置的基本示例：
```
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"
}
}
}
```
**Example 使用别名进行会话初始化**
使用上述配置，使用玩家变量和别名的会话初始化请求将类似于以下内容：
```
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
```
# 带有 MediaTailor 使用示例的配置别名
以下示例显示了如何使用配置别名的完整 MediaTailor 配置、带别名的会话初始化请求以及别名的处理流程。
**Example 使用别名完成配置**
以下示例显示了包括配置别名和动态域变量的完整配置：
```
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]",
"AdSegmentUrlPrefix": "https://[player_params.ad_cdn_domain]/ads/",
"ContentSegmentUrlPrefix": "https://[player_params.content_cdn_domain]/content/",
"TranscodeProfileName": "[player_params.transcode_profile]",
"SlateAdUrl": "https://[player_params.slate_domain]/slate/[player_params.slate_type].mp4",
"StartUrl": "https://[player_params.tracking_domain]/start?session=[session.id]",
"EndUrl": "https://[player_params.tracking_domain]/end?session=[session.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"
},
"player_params.ad_cdn_domain": {
"pdx": "ads-west.cdn.example.com",
"iad": "ads-east.cdn.example.com"
},
"player_params.content_cdn_domain": {
"pdx": "content-west.cdn.example.com",
"iad": "content-east.cdn.example.com"
},
"player_params.transcode_profile": {
"mobile": "mobile_optimized",
"desktop": "high_quality",
"tv": "4k_profile"
},
"player_params.slate_domain": {
"pdx": "slate-west.example.com",
"iad": "slate-east.example.com"
},
"player_params.slate_type": {
"standard": "default_slate",
"branded": "brand_slate"
},
"player_params.tracking_domain": {
"pdx": "tracking-west.example.com",
"iad": "tracking-east.example.com"
}
}
}
```
**Example 使用别名进行会话初始化**
以下示例显示了指定玩家变量和别名的会话初始化请求：
```
POST master.m3u8
{
"playerParams": {
"origin_domain": "pdx",
"region": "pdx",
"endpoint_id": "pdx",
"ad_type": "customized",
"ad_cdn_domain": "pdx",
"content_cdn_domain": "pdx",
"transcode_profile": "mobile",
"slate_domain": "pdx",
"slate_type": "branded",
"tracking_domain": "pdx"
}
}
```
**Example 参数处理流程**
在以下示例中， MediaTailor 将别名字符串替换为配置别名中的映射值。处理后会产生以下请求：
+ 广告请求：
```
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
```
+ AdSegmentUrlPrefix:
```
https://ads-west.cdn.example.com/ads/
```
+ ContentSegmentUrlPrefix:
```
https://content-west.cdn.example.com/content/
```
+ TranscodeProfileName:
```
mobile_optimized
```
+ SlateAdUrl:
```
https://slate-west.example.com/slate/brand_slate.mp4
```
+ StartUrl:
```
https://tracking-west.example.com/start?session=[session.id]
```
+ EndUrl:
```
https://tracking-west.example.com/end?session=[session.id]
```
# MediaTailor 向 ADS 传递参数
AWS Elemental MediaTailor 支持使用以下步骤在向 ADS 发出的 MediaTailor 请求中设置动态变量。
+ 有关查询参数支持的格式的信息，请参见[MediaTailor 参数参考和限制](parameter-comprehensive-reference.md)。
+ 有关配置别名和域变量，请参见[MediaTailor 配置别名概述](configuration-aliases-overview.md)。
+ 有关 ADS 请求的其他自定义设置，请参阅[高级用法](#variables-advanced-usage)。
**会话初始化方法**
MediaTailor 支持多种会话初始化和参数传递方法：
1. **带有请求正文的 POST：**
```
POST .m3u8
{
"adsParams": {"param1": "value1", "param2": "value2"},
"playerParams": {"param3": "value3"}
}
```
1. **URL 中的查询参数：**
```
GET .m3u8?ads.param1=value1&ads.param2=value2&playerParams.param3=value3
```
**重要**
在初始化时，只能指定一次参数。在转发之前，配置别名会解析为实际值。
**将会话和播放器信息传递到 ADS**
1. 与 ADS 合作，确定其回复广告查询所需的信息 AWS Elemental MediaTailor。
1. 在中创建使用满足 ADS MediaTailor 要求的模板 ADS 请求网址的配置。在 URL 中，包含静态参数和用于动态参数的占位符。在配置的 **Ad decision server (广告决策服务器)** 字段中输入您的模板 URL。
在以下示例模板 URL 中，`correlation` 提供会话数据，`deviceType` 提供播放器数据：
```
https://my.ads.server.com/path?correlation=[session.id]&deviceType=[player_params.deviceType]
```
1. 在播放器上，为 AWS Elemental MediaTailor 配置会话发起请求以便为播放器数据提供参数。在会话发起请求中包含您的参数，并在后续会话请求中省略它们。
玩家为初始化会话而进行的调用类型决定了玩家（客户端）还是 MediaTailor （服务器）是否为会话提供广告跟踪报告。有关这两个选项的信息，请参阅[报告广告跟踪数据](ad-reporting.md)。
根据您是需要服务器端还是客户端广告跟踪报告来进行以下类型的呼叫之一。在两个示例调用中，`userID` 适用于 ADS，`auth_token` 适用于源：
+ （选项）要求服务器端广告跟踪报告 — 在要发送 MediaTailor 到 ADS 的参数前面加上前缀。`ads`为您希望 MediaTailor 将其发送到源服务器的参数消除前缀：
以下示例显示了 HLS 和 DASH 的传入请求。 AWS Elemental MediaTailor MediaTailor `deviceType`在向 ADS 发出的请求中使用，`auth_token`在对源服务器的请求中使用。
HLS 示例：
```
GET master.m3u8?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
DASH 示例：
```
GET manifest.mpd?ads.deviceType=ipad&auth_token=kjhdsaf7gh
```
+ （选项）调用客户端广告跟踪报告 — 为对象内部的 ADS 提供参数。`adsParams`
HLS 示例：
```
POST master.m3u8
{
"adsParams": {
"deviceType": "ipad"
}
}
```
DASH 示例：
```
POST manifest.mpd
{
"adsParams": {
"deviceType": "ipad"
}
}
```
当玩家发起会话时，将模板 ADS 请求网址中的变量 AWS Elemental MediaTailor 替换为会话数据和玩家的`ads`参数。它将剩余参数从播放器传递到源服务器。
**Example MediaTailor 带有广告变量的请求**
以下示例显示了来自 AWS Elemental MediaTailor 的针对 ADS 和源服务器的调用（对应于上述播放器的会话初始化调用示例）。
+ MediaTailor 使用会话数据和玩家的设备类型调用 ADS：
```
https://my.ads.server.com/path?correlation=896976764&deviceType=ipad
```
+ MediaTailor 使用玩家的授权令牌调用源服务器。
+ HLS 示例：
```
https://my.origin.server.com/master.m3u8?auth_token=kjhdsaf7gh
```
+ DASH 示例：
```
https://my.origin.server.com/manifest.mpd?auth_token=kjhdsaf7gh
```
## 高级用法
您可以通过播放器和会话数据以多种方式自定义 ADS 请求。您只需要包含 ADS 主机名即可。
以下示例显示了一些可用来自定义请求的方法：
+ 连接播放器参数和会话参数以创建新参数。示例：
```
https://my.ads.com?key1=[player_params.value1][session.id]
```
+ 使用播放器参数作为路径元素的一部分。示例：
```
https://my.ads.com/[player_params.path]?key=value
```
+ 使用播放器参数传递路径元素和键本身，而不仅仅是值。示例：
```
https://my.ads.com/[player_params.path]?[player_params.key1]=[player_params.value1]
```
# MediaTailor ADS 和起点的参数路由
AWS Elemental MediaTailor routes 根据参数的前缀和用途将参数查询到不同的目的地。了解参数路由对于实现特定于原点的功能（例如使用时移查看）至关重要。 MediaPackage
**参数路由规则**
MediaTailor 对查询参数使用以下路由规则：
+ **Origin 参数（无前缀）：**没有特定前缀的参数会传递到源服务器以实现特定于起源的功能
+ **ADS 参数（`ads.`前缀）：**前缀为的`ads.`参数发送到广告决策服务器
+ **清单参数（`manifest.`前缀）：**前缀为的参数用`manifest.`于 CDN 路由和授权
**Example 参数路由示例**
以下会话初始化演示了参数路由：
```
POST /v1/session/123456789/originId/index.m3u8
{
"adsParams": {
"param1": "value1",
"param2": "value2"
},
"manifestParams": {
"auth_token": "abc123"
}
}
```
在本示例中：
+ `param1`并`param2`被发送到 ADS
+ `auth_token`用于 CDN 路由和授权
+ 不带前缀的参数将被传递到源服务器
## 源服务器参数行为
传递给源服务器的参数可启用特定于原点的功能，例如时移查看、内容筛选和身份验证。
**常见的原点参数用例**
Origin 参数通常用于：
+ **时移查看：**`start`以及 MediaPackage 时移内容的`end`参数
+ **内容认证：**源服务器所需的身份验证令牌
+ **内容过滤：**控制返回哪些内容变体的参数
+ **特定于 Origin 的功能：**源服务器用于内容处理的任何参数
**重要**
参数在会话初始化时处理，并在整个会话期间进行维护。要修改诸如时移窗口之类的参数，必须使用更新的值创建一个新的会话。
# MediaTailor 和 MediaPackage 时移观看集成
AWS Elemental MediaTailor 可以将时移的观看参数传递给 MediaPackage 原点，以启用 startover 和 chack-up 查看功能。这种集成允许观众从较早的时间点开始观看直播内容。
**MediaPackage 时移观看参数**
MediaPackage 支持以下可以传递 MediaTailor的时移查看参数：
+ `start`: Epoch 或 ISO 8601 时间戳定义时移清单的开头
+ `end`: Epoch 或 ISO 8601 时间戳定义时移清单的结尾
+ `time_delay`：将内容可用性延迟指定秒数
+ `manifest_window_seconds`: 请求比配置的窗口更短的清单
**Example MediaTailor 使用 MediaPackage 时移参数进行会话初始化**
以下示例说明如何使用时移查看参数初始化会话：
```
GET /v1/master/123456789/originId/index.m3u8?start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z
```
或者使用显式会话初始化：
```
POST /v1/session/123456789/originId/index.m3u8
{
"adsParams": {
"param1": "value1"
}
}
```
使用其他查询参数：
```
?start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z
```
**会话期间的参数行为**
时移观看参数具有特定的行为特征：
+ **会话初始化：**创建会话时会处理参数
+ **参数持久性：**在整个播放过程中，参数与会话保持关联
+ **初始化后不可变：**在活动会话期间无法更改参数
+ **需要新会话：**要修改时移窗口，请使用更新的参数值创建一个新会话
**MediaPackage 起步窗口要求**
要使用时移查看 MediaPackage，请确保满足以下条件：
1. 在 MediaPackage 终端上配置启动窗口（最长 24 小时）
1. 确保您的 CDN 将必要的查询参数转发给 MediaPackage
1. 在玩家会话中使用一致的播放窗口以获得更好的 CDN 缓存
1. 验证开始和结束时间是否在配置的开始时间范围内
**重要**
使用时移观看时，应在各个玩家会话中使用一致的播放窗口，而不是为每个观看者生成唯一的开始或结束时间。这样可以在 CDN 上获得更好的缓存，并避免潜在的限制。
有关 MediaPackage 时移查看配置和参数的完整信息，请参阅《*AWS Elemental MediaPackage 用户*指南》 AWS Elemental MediaPackage中的[时移视](https://docs.aws.amazon.com/mediapackage/latest/ug/time-shifted.html)图。
# MediaTailor 参数会话行为和持久性
AWS Elemental MediaTailor 在会话初始化时处理参数，并在整个会话生命周期中对其进行维护。了解会话行为对于实现动态参数场景至关重要。
**会话初始化方法**
MediaTailor 支持多种使用参数进行会话初始化的方法：
1. **隐式会话初始化：**初始清单请求中包含的参数
```
GET /v1/master/123456789/originId/index.m3u8?manifest.auth_token=abc123&start=2024-08-26T10:00:00Z
```
1. **显式会话初始化 (POST)：**请求正文中提供的参数
```
POST /v1/session/123456789/originId/index.m3u8
{
"adsParams": {"param1": "value1"},
"manifestParams": {"auth_token": "abc123"}
}
```
1. **显式会话初始化 (GET)：**作为查询参数提供的参数
```
GET /v1/session/123456789/originId/index.m3u8?ads.param1=value1&manifestParams.auth_token=abc123
```
**参数持久性和不可变性**
MediaTailor 参数行为遵循以下规则：
+ **一次性规范：**参数只能在会话初始化时指定一次
+ **整个会话的持久性：**参数在整个会话中都保持不变
+ **初始化后不可变：**创建会话后无法修改参数
+ **配置别名解析：**在转发到目的地之前，别名会被解析为实际值
**参数修改场景**
要在播放期间修改参数，请执行以下操作：
+ **创建新会话：**使用更新的参数值初始化新会话
+ **玩家过渡：**将玩家无缝过渡到新会话
+ **参数继承：继承**未更改的参数以保持一致性
**Example 修改时移参数**
要从 1 小时窗口更改为 2 小时窗口，请执行以下操作：
1. 当前会话：`start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z`
1. 创建新会话：`start=2024-08-26T10:00:00Z&end=2024-08-26T12:00:00Z`
1. 将玩家过渡到新的会话 URL
**重要**
针对单个会话的多个多变体播放列表请求不会在第一个请求之后更新参数。参数在会话持续时间内保持不可变。
# MediaTailor 参数参考和限制
在配置动态广告变量之前，请了解适用于所有 MediaTailor 配置的参数格式要求和限制。
AWS Elemental MediaTailor 提供了有关参数字符限制、长度限制以及清单查询参数和 ADS 参数支持的格式的全面信息。
## 清单查询参数字符限制
清单查询参数支持特定字符，并且具有定义的长度限制。
**支持的字符（没有 URL 编码）**
您可以直接在清单查询参数中使用以下字符：
+ 字母数字字符（A-Z、a-z、0-9）
+ 时期 (.)
+ 连字符 (-)
+ 下划线 (\$1)
+ 反斜杠 (\$1)
**支持的带有 URL 编码的字符**
URL 编码时支持以下特殊字符：
+ 时期 (.) = %2E
+ 短划线 (-) = %2D
+ 下划线 (\$1) = %5F
+ 百分比 (%) = %25
+ 波浪号 (\$1) = %7E
+ 正斜杠 (/) = %2F
+ 星号 (\$1) = %2A
+ 等于 (=) = %3D
+ 问题 (？) = %3F
**网址编码支持**
MediaTailor 当你在 URL 编码中使用百分号 (%) 时（例如，hello%20world = hello world = hello world），则支持该符号。您可以使用任何 URL 编码字符，只要它们是符合 HTTP 规范的有效网址编码即可。
**不支持的字符**
如果没有 URL 编码，则不能在清单查询参数中使用以下字符：`:`、`?`、`&`、`=``%`、`/`（正斜杠）。
**重要**
MediaTailor 不支持双字符，例如%%% 或 ==。由于字符限制，您不能使用 full URLs 作为清单查询参数值。
**长度限制**
所有清单查询参数（键和值的组合）的总长度不得超过 2000 个字符。
## ADS 参数长度限制
以下长度限制适用于向 ADS 发出的请求中使用的参数：
+ **ADS 参数名称**：最多 10,000 个字符
+ **ADS 参数值**：最多 25,000 个字符
+ **广告网址**：最多 25,000 个字符
# MediaTailor 参数疑难解答指南
AWS Elemental MediaTailor 为解决中与参数相关的常见问题提供了指导 MediaTailor，包括字符限制、URL 编码问题和配置别名错误。
## 字符限制错误
包含不支持的字符的参数值可能会导致错误或意外行为。
**常见症状**
以下症状可能表示存在字符限制问题：
+ 参数未出现在清单中 URLs
+ 会话初始化期间的 HTTP 400 错误
+ 参数值被截断或损坏
+ 由于格式错误，ADS 请求失败 URLs
**解决步骤**
要解决字符限制错误，请执行以下操作：
1. 查看不支持的字符的参数值：`:`、、`?`、`&`、`=`、`%` `/`
1. 对特殊字符应用正确的 URL 编码（请参阅）[MediaTailor 参数参考和限制](parameter-comprehensive-reference.md)
1. 避免使用双字符，例如`%%%`或 `==`
1. 如果 URLs 无法使用完整参数格式，请考虑使用其他参数格式
**Example 网址编码示例**
而不是使用：
```
manifest.redirect_url=https://example.com/path?param=value
```
使用 URL 编码格式：
```
manifest.redirect_url=https%3A%2F%2Fexample.com%2Fpath%3Fparam%3Dvalue
```
## 长度限制错误
超过长度限制的参数可能会被截断或导致错误。
**长度限制**
适用以下长度限制（有关完整[MediaTailor 参数参考和限制](parameter-comprehensive-reference.md)详细信息，请参阅）：
+ 清单查询参数（总计）：2000 个字符
+ ADS 参数名称：10,000 个字符
+ ADS 参数值：25,000 个字符
+ 广告 URLs：25,000 个字符
**解决策略**
要处理长度限制，请执行以下操作：
1. 尽可能使用较短的参数名称和值
1. 将较大的参数值拆分为多个较小的参数
1. 使用配置别名将短别名映射到较长的值（请参阅）[MediaTailor 配置别名概述](configuration-aliases-overview.md)
1. 考虑使用外部存储来存储带有参数引用的大型数据
## 配置别名错误
配置别名问题可能导致 HTTP 400 错误或参数值意外。
**常见的配置别名错误**
配置别名通常会出现以下错误：
+ HTTP 400 错误：别名值缺失或无效
+ 域变量无法正确解析
+ 玩家参数未被替换为别名值
**解决方案清单**
要解决配置别名错误，请执行以下操作：
1. 验证所有域变量均定义为 `ConfigurationAliases`
1. 确保玩家参数变量使用`player_params.`前缀
1. 确认关键域变量的别名值列表是详尽无遗的 URLs (`VideoContentSourceUrl`,`AdSegmentUrlPrefix`,`ContentSegmentUrlPrefix`)
1. 检查会话初始化请求是否指定了有效的别名值
1. 验证 ConfigurationAliases 参数的 JSON 结构
有关详细的故障排除指南，请参阅[MediaTailor 配置别名疑难解答指南](configuration-aliases-troubleshooting.md)。
**Example 配置别名验证**
确保您的配置包括所有必需的别名：
```
"ConfigurationAliases": {
"player_params.origin_domain": {
"pdx": "abc.mediapackage.us-west-2.amazonaws.com",
"iad": "xyz.mediapackage.us-east-1.amazonaws.com"
// Must include all possible values used in session initialization
}
}
```
## 参数处理流程问题
了解参数处理流程有助于解决参数转发和转换问题。
**参数处理顺序**
MediaTailor 按以下顺序处理参数：
1. 会话初始化参数验证
1. 配置别名解析（如果适用）
1. 参数过滤（ADS 与来源 vs 清单）
1. URL 编码和格式
1. 参数应用于 URLs
**调试参数流**
要调试参数处理问题，请执行以下操作：
1. 验证在会话初始化中是否正确指定了参数
1. 检查配置别名是否解析为预期值
1. 确认参数以正确的方式显示 URLs （清单、广告、来源）
1. 验证 URL 编码是否正确应用
**Example 参数流示例**
会话初始化：
```
POST master.m3u8
{
"playerParams": {"origin_domain": "pdx"},
"manifestParams": {"test": "123"}
}
```
在别名解析和处理之后：
+ 起源请求：`https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd`
+ 清单网址：`/v1/master/.../index.m3u8?aws.sessionId=session&test=123`
## 安全性注意事项和最佳实践
MediaTailor 为参数处理实施安全措施，以防止出现常见的安全问题。
**安全措施**
MediaTailor 实施了以下安全措施：
1. 防止数据库膨胀的输入大小限制
1. 对用户输入进行适当的编码和审查
1. 对输入进行网址编码，以防止响应损坏
**最佳实践**
请按照以下最佳实践进行安全参数处理：
+ 发送前在客户端验证参数值
+ 使用配置别名限制可能的参数值
+ 避免在参数中包含敏感信息
+ 监控参数使用情况，以发现异常模式
+ 将参数值保持在建议的长度限制之内
# MediaTailor 配置别名疑难解答指南
AWS Elemental MediaTailor 为常见的配置别名问题和错误场景提供系统的故障排除指导。
## 配置别名验证错误
当配置别名丢失或无效时， MediaTailor 会返回特定的错误响应以帮助识别问题。
**常见的错误场景**
下表描述了常见的配置别名错误及其解决步骤：
| 错误 | 原因 | 解决方案 |
| --- | --- | --- |
| HTTP 400：玩家参数别名无效 | 在中找不到玩家参数值 ConfigurationAliases | 验证玩家参数值是否作为键存在于相应的 ConfigurationAliases 映射中 |
| HTTP 400：缺少所需的配置别名 | 使用没有相应 ConfigurationAliases条目的域变量 | 将缺少的玩家参数添加到 ConfigurationAliases 包含所有必需的别名映射中 |
| HTTP 400：配置验证失败 | ConfigurationAliases 结构格式错误或不完整 | 验证 JSON 结构并确保所有域变量都有相应的别名 |
| 中的空字符串替换 URLs | 未找到非域变量别名 | 添加缺失的别名映射或在中提供默认值 ConfigurationAliases |
**验证核对清单**
使用以下清单来验证您的配置别名设置：
1. **域变量覆盖率：**确保域部分中使用的所有变量 URLs 都有相应的 ConfigurationAliases 条目
1. **别名完整性：**验证所有可能的玩家参数值是否都作为键包含在别名映射中
1. **JSON 结构：**验证 ConfigurationAliases JSON 的格式和嵌套是否正确
1. **参数命名：**确认所有玩家参数都使用前`player_params.`缀
1. **值一致性：**确保别名值对于其预期用途（URLs、配置文件名称等）有效
## 调试配置别名解析
按照这种系统的方法来调试配置别名解析问题。
**Step-by-step 调试方法**
使用以下步骤来识别和解决配置别名问题：
**配置别名调试程序**
1. **验证配置结构：**确认您的播放配置包括格式正确的内容 ConfigurationAliases
```
{
"ConfigurationAliases": {
"player_params.example_param": {
"alias1": "value1",
"alias2": "value2"
}
}
}
```
1. **检查玩家参数格式：**确保会话初始化包括格式正确的玩家参数
```
{
"playerParams": {
"example_param": "alias1"
}
}
```
1. **验证别名映射：**确认玩家参数值 (“alias1") 作为键存在于映射中 ConfigurationAliases
1. **使用简单配置进行测试：**从最低配置开始以找出问题
1. **监控错误响应：**检查 MediaTailor错误响应中是否有特定的验证消息
1. **验证已解决 URLs：**确认最终解决方案有效 URLs 且可访问
## 配置别名最佳实践
请遵循这些最佳实践，以确保可靠的配置别名实现。
**安全注意事项**
使用配置别名时，请实施以下安全措施：
+ **输入验证：**在别名解析中使用所有玩家参数值之前，请先对其进行验证
+ **别名值清理：**确保别名值仅包含预期的字符和格式
+ **域名限制：**将域别名限制为可信、受控的域名
+ **访问控制：**仅限授权人员修改配置
**性能优化**
使用以下建议优化配置别名性能：
+ **尽量减少别名数：**仅使用必要的别名以减少处理开销
+ **高效命名：**对别名和参数使用清晰、一致的命名约定
+ **默认值：**为常见用例提供合理的默认别名
+ **配置缓存：**利用 MediaTailor配置缓存提高性能
**维护和监控**
通过以下做法保持可靠的配置别名操作：
+ **定期验证：**定期验证所有别名映射是否为最新且功能正常
+ **错误监控：**监控与别名缺失或无效相关的 HTTP 400 错误
+ **文档：**保持所有别名映射及其用途的清晰文档
+ **测试程序：**对所有别名组合实施全面测试
# MediaTailor 清单查询参数
AWS Elemental MediaTailor 处理用于不同目的的查询参数：用于 CDN 路由和授权的清单查询参数，以及可用于源特定功能的其他查询参数。
AWS Elemental MediaTailor 保留会话初始化的查询参数并将其附加到个性化清单 URLs 和其他资产。当您在客户端播放器之间有内容分发网络 (CDN) 时 MediaTailor ，请使用此功能。
当您的 CDN 需要以下内容的查询参数时，请使用清单查询参数：
+ 动态路由到不同的 MediaTailor 端点
+ 令牌授权
**客户端行为与 CDN 行为**
MediaTailor 为客户端报告端点添加查询参数，但不会为 CDN 分段附加查询参数。更新后的功能为各种 MediaTailor 资产的查询参数提供了更全面的支持，增强了 CDN 路由和授权用例的灵活性。
MediaTailor 为客户端报告端点添加查询参数，但它不会为 CloudFront （或其他 CDN）细分追加查询参数。
要使用参数保存，请联系 [AWS S](https://aws.amazon.com/premiumsupport/) upport，请求启用清单查询参数通过。
在 HLS 和 DASH 之间，以及显式和隐式会话初始化之间，行为会有所不同。以下主题介绍如何配置会话初始化请求，以便将参数 MediaTailor 传递到清单：
# MediaTailor 原点的查询参数处理
AWS Elemental MediaTailor 根据查询参数的用途，对查询参数的处理方式有所不同。清单查询参数（前缀为`manifest.`）用于 CDN 路由和授权，而其他查询参数可用于源特定功能。
**时移观看 MediaPackage**
要使用时移查看功能 MediaPackage，您可以在请求中包含`start`和`end`参数。这些参数定义了特定的内容窗口，用于从头到尾查看和追赶查看。
**Example 时移观看请求**
在清单请求中加入开始和结束参数，以便进行时移查看：
```
GET /v1/master/111122223333/originId/index.m3u8?start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z
```
**会话期间的参数行为**
查询参数在会话初始化时处理。对于时移观看或其他特定于原点的功能：
+ **会话初始化：**在初始清单请求中包含必需的参数
+ **参数持久性：**参数与会话相关联，并在整个播放过程中保持不变
+ **更改参数：**要修改时移窗口或其他参数，请使用更新的值创建一个新会话
**重要**
查询参数的具体处理取决于您的来源配置和内容来源支持的参数。要进行 MediaPackage 集成，请确保您的 CDN 已配置为转发必要的查询参数，如中所述。[配置基本查询参数](mediapackage-integration.md#mediapackage-query-strings)
# MediaTailor 参数字符限制和 URL 编码
AWS Elemental MediaTailor 支持清单查询参数中的特定字符。您可以对特殊字符使用 URL 编码。
**支持的带有 URL 编码的字符**
URL 编码支持以下特殊字符：
+ 时期 (.) = %2E
+ 短划线 (-) = %2D
+ 下划线 (\$1) = %5F
+ 百分比 (%) = %25
+ 波浪号 (\$1) = %7E
+ 正斜杠 (/) = %2F
+ 星号 (\$1) = %2A
+ 等于 (=) = %3D
+ 问题 (？) = %3F
**网址编码支持**
MediaTailor 当你在 URL 编码中使用百分号 (%) 时（例如，hello%20world = hello world = hello world），则支持该符号。您可以使用任何 URL 编码字符，只要它们是符合 HTTP 规范的有效 URL 编码即可。
**重要**
MediaTailor 不支持双字符，例如%%% 或 ==。
**安全注意事项**
MediaTailor 为参数处理实现了以下安全措施：
1. 防止数据库膨胀的输入大小限制
1. 对用户输入进行适当的编码和审查
1. 对输入进行网址编码，以防止响应损坏
**Topics**
+ [来源查询参数](origin-query-parameters.md)
+ [MediaTailor字符限制](manifest-query-parameters-character-restrictions.md)
+ [MediaTailorHLS 隐式会话](manifest-query-parameters-hls-implicit-session-initialization.md)
+ [MediaTailor DASH 隐式会话](manifest-query-parameters-dash-implicit-session-initialization.md)
+ [MediaTailor 显式会话初始化](manifest-query-parameters-hls-and-dash-explicit-session-initialization.md)
+ [MediaTailor特定于协议的行为](manifest-query-parameters-protocol-differences.md)
+ [MediaTailor 内容分发网络集成](manifest-query-parameters-cdn-integration.md)
# MediaTailor HLS 隐式会话初始化
AWS Elemental MediaTailor 如果您的请求包含带有密钥的查询参数，则在 MediaTailor 资源链接中包含查询参数`manifest.*`。以下示例显示了这种请求格式：
```
GET /v1/master/111122223333/originId/index.m3u8?manifest.test=123&other=456
```
链接不包含前`manifest.`缀。
**HLS 中的参数应用**
对于 HLS 隐式会话，将参数 MediaTailor 应用于清单层次结构中的以下位置：
+ 多变体播放列表 URLs
+ 媒体播放列表 URLs
+ 内容细分 URLs
+ 广告细分 URLs
+ HLS 初始化 URLs
**Example 多变播放列表**
以下示例显示了如何在多变体播放列表的网址中 MediaTailor 包含查询参数：
```
#EXTM3U
#EXT-X-VERSION:3
#EXT-X-INDEPENDENT-SEGMENTS
#EXT-X-MEDIA:LANGUAGE="eng",AUTOSELECT=YES,FORCED=NO,TYPE=SUBTITLES,URI="../../../manifest/111122223333/originId/session/1.m3u8?test=123",GROUP-ID="subtitles",DEFAULT=YES,NAME="caption_1"
#EXT-X-STREAM-INF:CODECS="avc1.640029,mp4a.40.2",AVERAGE-BANDWIDTH=2525657,RESOLUTION=960x540,SUBTITLES="subtitles",FRAME-RATE=29.97,BANDWIDTH=2665212
../../../manifest/111122223333/originId/session/0.m3u8?test=123
```
**Example 媒体播放列表**
以下示例显示了如何在中 MediaTailor 包含内容分段 URLs的查询参数：
```
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:7
#EXT-X-MEDIA-SEQUENCE:28716269
#EXT-X-DISCONTINUITY-SEQUENCE:0
#EXTINF:6.006,
https://origin.com/contentSegment_1.ts?originQueryParam=foo&test=123
#EXT-X-DISCONTINUITY
#EXTINF:6.006,
../../../../segment/111122223333/originId/session/0/2?test=123
```
# MediaTailor DASH 隐式会话初始
AWS Elemental MediaTailor 为客户端创建会话，并在客户端在没有会话的情况下发出清单请求时使用查询参数重定向该会话。以下示例显示了这种请求格式：
```
GET /v1/dash/111122223333/originId/index.mpd?manifest.test=123&other=456
```
MediaTailor 为客户端创建会话并使用查询参数重定向该会话：
```
/v1/dash/111122223333/originId/index.mpd?sessionId=session&test=123
```
**DASH 中的参数应用**
DASH 清单响应包括不同位置的查询参数，包括内容细分、广告细分和初始化 URLs。 MediaTailor 将参数应用于以下内容：
+ DASH 清单位置元素
+ SegmentTemplate 初始化属性
+ SegmentTemplate 媒体属性
+ 内容细分 URLs
+ 广告细分 URLs
当客户端发出请求时，会使用类似于以下示例的 DASH 清单进行 MediaTailor 响应。第一个句点是内容周期，因此 MediaTailor 不要在那里插入清单查询参数。在第二个时段（即广告时段）中，将清单查询参数 MediaTailor插入`SegmentTemplate`元素的`initialization`属性和`media`属性中。该`Location`元素还具有清单查询参数。
```
https://origin.com/contentSegments/
https://mediatailor.com/v1/dash/111122223333/originId/index.mpd?test=123&aws.sessionId=session