View a markdown version of this page

创建 MediaTailor 播放配置 - AWS Elemental MediaTailor

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

创建 MediaTailor 播放配置

本主题介绍如何创建用于开始接收内容流的配置 AWS Elemental MediaTailor。它还展示了如何为下游播放设备提供请求内容的接入点。

您可以使用 AWS Elemental MediaTailor 控制台、 AWS Command Line Interface (AWS CLI) > 或 MediaTailor API 来创建配置。有关通过 AWS CLI 或 MediaTailor API 创建配置的信息,请参阅 AWS Elemental MediaTailor API 参考。

创建配置时,不要将敏感的识别信息放入自由格式字段,例如配置名称字段。识别信息可能包括客户账号之类的信息。此外,在 MediaTailor控制台、REST API、或 AWS SDK 中工作时,请勿使用识别信息。 AWS CLI您输入的任何数据都 MediaTailor 可能会被提取并包含在诊断日志或亚马逊 CloudWatch 活动中。

添加配置(控制台)
  1. 在处打开 MediaTailor 控制台https://console.aws.amazon.com/mediatailor/。

  2. 在 Configurations (配置) 页面上,选择 Create configuration (创建配置)。

  3. 填写配置和其他配置字段,如以下主题所述:

  4. 选择创建配置。

    AWS Elemental MediaTailor 在 “配置” 页面的表格中显示新配置。

  5. (推荐)使用 AWS Elemental MediaTailor 为清单和报告请求设置 CDN。您可以使用配置播放 URL 进行 CDN 设置。有关为清单和报告请求设置 CDN 的信息,请参阅使用 CDN 优化 MediaTailor 广告个性化和内容交付。

必需的设置

当您创建配置时,必须包括以下必需的设置。

Name

输入描述配置的唯一名称。此名称是配置的主要标识符。允许的最大长度为 512 个字符。

内容来源

输入此流的清单的 URL 前缀(去掉资产 ID)。最大长度为 512 个字符。

例如,网址前缀对http://origin-server.com/a/的 HLS 多变量播放列表网址http://origin-server.com/a/main.m3u8和的 DASH MPD 网址有效。http://origin-server.com/a/dash.mpd或者,您可以输入一个较短的前缀(如 http://origin-server.com),但 /a/ 必须包含在播放器内容请求的资产 ID 中。

注意

如果您的内容源使用 HTTPS,则其证书必须来自知名的证书颁发机构。它不能是自签名证书。如果你使用自签名证书, AWS Elemental MediaTailor 则无法连接到内容来源,也无法提供清单来响应玩家的请求。

广告决策服务器

输入您的广告决策服务器 (ADS) 的 URL。这是包含变量的 URL(如第 3 步:配置 ADS 请求 URL 和查询参数中所述),或用于测试用途的静态 VAST URL。最大长度为 25000 个字符。

注意

如果您的 ADS 使用 HTTPS,则其证书必须来自知名的证书颁发机构。它不能是自签名证书。这同样也适用于 ADS 返回的夹层广告 URL。如果您使用自签名证书,则 AWS Elemental MediaTailor 无法从内容来源检索广告并将其拼接到清单中。

可选配置设置

您可以选择在 MediaTailor 控制台、 MediaTailor API 或 AWS Command Line Interface (AWS CLI) 中配置配置别名、个性化详细信息和高级设置。

配置别名

以下是可选的配置别名,您可以在 MediaTailor 控制台中或使用 MediaTailor API 进行配置。

玩家参数变量

要在会话初始化期间进行动态域配置,请添加一个或多个玩家参数变量。

有关使用玩家参数变量动态配置域名的更多信息,请参阅MediaTailor 多个内容源的域变量。

日志配置

以下是日志配置设置。

已启用百分比

设置 MediaTailor 写入日志的回放配置会话 CloudWatch 日志的百分比。例如,如果您的播放配置有 1000 个会话,并且您将启用百分比设置为 60,则会将 600 个会话日志 MediaTailor 写入 CloudWatch 日志。

启用此选项后, MediaTailor 将自动创建一个服务相关角色, MediaTailor 允许在您的日志账户中写入和管理会话 CloudWatch 日志。有关更多信息,请参阅 将服务相关角色用于 MediaTailor。

记录策略

表示用于收集 MediaTailor发出的日志的方法。要将日志直接发送到 CloudWatch 日志,请选择LEGACY_CLOUDWATCH。要向 Logs 发送 CloudWatch 日志,然后由日志将日志发送到您选择的目的地,请VENDED_LOGS选择。支持的目标是 CloudWatch 日志组、Amazon S3 存储桶和亚马逊数据消防队数据流。

出售的日志需要进行额外设置。有关设置,请参阅使用已售日志。

ADS 互动日志选择加入事件

表示 MediaTailor 将为使用此配置初始化的会话发出RAW_ADS_RESPONSE日志。

RAW_ADS_RESPONSE日志事件包含来自 ADS 的整个 VAST 或 VMAP 响应。因此,日志可能很多,可能会增加您的日志记录成本。

ADS 互动日志排除事件

表示 MediaTailor 不会在日志中发出描述与 ADS 交互的选定事件。

有关 ADS 日志事件的描述,请参阅ADS 日志。

清单服务交互日志排除事件

表示 MediaTailor 不会在日志中发出描述与清单服务交互的选定事件。

有关清单服务日志事件的描述,请参阅清单日志。

广告调节

以下内容决定了在将广告拼接到内容流中之前 MediaTailor 需要采取哪些措施来对其进行修改。

流媒体文件调节

确定在决定拼接哪些广告时 MediaTailor 使用的逻辑。

  • 当流媒体文件条件设置为 Transcode 时,会在 MediaTailor 传progressive送时对媒体文件进行转码,并将它们拼接到清单中。如果没有足够的带有progressive投放媒体文件的广告来填补空缺,则进行 MediaTailor 转码并使用已streaming投放的媒体文件。

  • 当流媒体文件条件设置为 “无” 时,会将带有streaming投放 MediaTailor 媒体文件的广告拼接到清单中,而无需对其进行转码。如果没有足够的带有streaming投放媒体文件的广告来填补空缺,则进行 MediaTailor 转码并使用已progressive投放的媒体文件。

个性化细节

以下是您可以在 MediaTailor 控制台或 MediaTailor API 中配置的个性化详细信息。

画面广告

输入用于填充未填充广告时间的高质量 MP4 素材资源的网址。 MediaTailor 对于大多数工作流程,Slate 配置是可选的,但对于 VPAID 广告来说是强制性的。有关 Slate 行为、配置要求以及何时显示 slate 的全面信息,请参阅。MediaTailor slate 广告插入

起动保险杠

起始缓冲区资产位置的网址。Bumpers 是在广告插播开始或结束时播放的简短视频或音频片段。它们可以存储在亚马逊的S3或其他存储服务上。要了解有关保险杠的更多信息,请参阅。MediaTailor 保险杠广告插入

端部保险杠

末端缓冲区资产位置的网址。Bumpers 是在广告插播开始或结束时播放的简短视频或音频片段。它们可以存储在亚马逊的S3或其他存储服务上。要了解有关保险杠的更多信息,请参阅。MediaTailor 保险杠广告插入

个性化阈值

仅在与 Slate 广告配合使用时适用。定义在 MediaTailor 放弃个性化设置和展示基础内容之前,广告插播时间内允许的最大填充广告时长(以秒为单位)。此功能适用于直播和 VOD 流中的广告替换 而不是广告插入,因为它依赖于基础内容流。有关详细的行为场景和全面的信息,请参阅个性化阈值的工作原理。

实时前置式广告决策服务器

要在主要内容开始播放之前在实时流的开头插入广告,请从广告决策服务器 (ADS) 输入前置式广告的 URL。这是包含变量的 URL(如第 3 步:配置 ADS 请求 URL 和查询参数中所述),或用于测试用途的静态 VAST URL。最大长度为 25000 个字符。

注意

如果您的 ADS 使用 HTTPS,则其证书必须来自知名的证书颁发机构。它不能是自签名证书。这同样也适用于 ADS 返回的夹层广告 URL。如果您使用自签名证书,则 AWS Elemental MediaTailor 无法从内容来源检索广告并将其拼接到清单中。

有关前置式广告工作方式的信息,请参阅MediaTailor 片前广告插播。

实时前置式广告最大允许持续时间

当您在直播流的开头插入广告时,请输入前置式广告效用的最大允许持续时间。 MediaTailor 插入广告时不会超过此持续时间。如果广告的回复中包含的广告数量超过了该时段的容纳量,则在不超过持续时间的情况下使用尽可能多的广告来 MediaTailor 填补空缺。有关如何使用 MediaTailor 填充的更多详细信息,请参阅直播广告拼接行为。

可用抑制模式

设置效用禁止模式,也称为广告禁止。默认情况下,广告抑制处于关闭状态,并用广告或广告牌 MediaTailor 填充所有内容。当模式设置为时BEHIND_LIVE_EDGE,广告抑制处于活动状态, MediaTailor 不会填充清单回顾窗口中处于空闲抑制值时段或之后的广告插播时间。当模式设置为时AFTER_LIVE_EDGE,广告抑制处于活动状态。 MediaTailor在无用广告抑制期内或之后填补广告间隔,即实时优势加上无效抑制值加上缓冲时间。

可用抑制值

空闲抑制值是实时边缘偏移时间HH:MM:SS。 MediaTailor 这次不会在清单回顾窗口中填补广告插播时间段或落后时间。

插入模式

插入模式控制玩家是否可以使用拼接广告或引导式广告插入。默认值强制所有玩家会话使用拼接(服务器端)广告插入。STITCHED_ONLY设置 InsertionMode 为PLAYER_SELECT允许玩家在会话初始化时选择拼接广告或引导式广告插入。对于未指定插入模式的玩家,默认设置是拼接的。

高级设置

以下是可选的高级设置。你可以在 MediaTailor 控制台中使用 AWS Command Line Interface (AWS CLI) 或使用 MediaTailor API 进行配置。

CDN 内容分段前缀

AWS Elemental MediaTailor 允许使用内容分段的 CDN 路径的 URL 创建清单。在执行此步骤之前,请在 CDN 中设置规则以从来源服务器中拉取分段。对于 CDN content segment prefix (CDN 内容分段前缀),输入 CDN 前缀路径。

有关 MediaTailor 与 CDN 集成的更多信息,请参阅使用 CDN 优化 MediaTailor 广告个性化和内容交付。

CDN 广告分段前缀

AWS Elemental MediaTailor 允许使用您自己的 CDN 路径的网址为广告区段创建清单。默认情况下,使用默认缓存设置从亚马逊内部 CloudFront 分配中 MediaTailor提供广告片段。您必须先在 CDN 中设置规则以从以下来源拉取广告分段,然后才能填写 CDN ad segment prefix (CDN 广告分段前缀) 字段,如下例所示。

https://segments.mediatailor.<region>.amazonaws.com

对于 CDN ad segment prefix (CDN 广告分段前缀),在配置中输入您的 CDN 前缀的名称。

有关 MediaTailor 与 CDN 集成的更多信息,请参阅使用 CDN 优化 MediaTailor 广告个性化和内容交付。

DASH 原始清单类型

如果您的源服务器生成单周期 DASH 清单,请打开下拉列表并选择 SINGLE_PERIOD。默认情况下, MediaTailor 会将 DASH 清单作为多周期清单处理。有关更多信息,请参阅 整合 MPEG-DASH 来源。

DASH mpd 位置

(根据 DASH 的需要可选)媒体演示描述 (mpd) 的位置。对于以下情况,请选择 “禁用”:

  • 您可以设置用于访问 MediaTailor 清单的 CDN 路由规则。

  • 你使用客户端报告,或者你的玩家支持粘性 HTTP 重定向。

有关 Location (位置) 功能的更多信息,请参阅 DASH 定位功能。

对配置文件名称进行转码

将此配置与自定义转码配置文件关联的名称。此名称覆盖的动态转码默认值。 MediaTailor仅当您已经在 AWS Support 的帮助下设置了自定义配置文件时才填写此字段。

广告标记直通

对于 HLS,启用或禁用广告标记直通。启用广告标记直 MediaTailor 通EXT-X-CUE-IN功能后,会将EXT-X-SPLICEPOINT-SCTE35广告标记从源清单传递到 MediaTailor 个性化清单。EXT-X-CUE-OUT不对广告标记值应用任何逻辑;它们按原样从原始清单传递到个性化清单。例如,如果EXT-X-CUE-OUT来源清单60中的值为,但未投放任何广告,则 MediaTailor 不会将该值更改为个性化清单0中的值。

个人 ADS 请求超时

在直播或 VOD 播放期间解决广告决策时 MediaTailor 等待单个 HTTP 响应的最长时间(以毫秒为单位)。默认值:3000。有效范围:250— 6000。

有关如何在直播和 VOD 工作流程中 MediaTailor 处理广告拼接的更多信息,请参阅直播广告拼接行为和。VOD 的广告拼接行为

此设置对应于PutPlaybackConfigurationAdsPersonalizationTimeouts参数AdsRequestTimeoutMilliseconds的成员。

最大并发 ADS 请求数

MediaTailor 可以向 ADS 发出的同时请求的数量。默认值:1。有效范围:1— 100。

此设置对应于PutPlaybackConfigurationAdsPersonalizationConcurrency参数MaxConcurrentAdsRequests的成员。

直播最长 ADS 个性化时间

实时清单个性化期间所有 ADS 活动的总时间预算,以毫秒为单位。该预算将在单个清单请求中的所有广告时段中共享。默认值:10000。有效范围:250— 10000。

有关直播广告拼接行为的更多信息,请参阅直播广告拼接行为。

此设置对应于PutPlaybackConfigurationAdsPersonalizationTimeouts参数LiveMaximumAdsPersonalizationTimeMilliseconds的成员。

VOD 最长 ADS 个性化时间

VOD 清单个性化期间所有 ADS 活动的总时间预算,以毫秒为单位。该预算将在单个清单请求中的所有广告时段中共享。默认值:10000。有效范围:250— 10000。

有关 VOD 广告拼接行为的更多信息,请参阅。VOD 的广告拼接行为

此设置对应于PutPlaybackConfigurationAdsPersonalizationTimeouts参数VodMaximumAdsPersonalizationTimeMilliseconds的成员。

启用 VOD VAST 并行化

开启此设置后,将同时 MediaTailor 处理返回 VAST 响应的 VOD 工作流程的 ADS 请求。此设置仅适用于 VOD 工作流程。 MediaTailor 默认情况下关闭此设置。要生效,请将最大并发 ADS 请求数设置为大于的值1。

并发请求的频率上限

当您启用 VAST 并行化时,某些广告服务器可能不会对并发广告请求强制执行频率上限限制。请咨询您的广告服务器提供商,确认并行请求条件下是否支持频率上限。如果您的广告服务器不支持并发请求的频率上限,请考虑切换到 VMAP,它可以正确处理并行广告请求的频率上限。

此设置对应于PutPlaybackConfigurationAdsPersonalizationConcurrency参数EnableVodVastParallelization的成员。

预取 ADS 请求超时

在预取检索期间解析广告决策时 MediaTailor 等待单个 HTTP 响应的最长时间(以毫秒为单位)。默认:个人 ADS 请求超时值。有效范围:250— 10000。

有关预取的更多信息,请参阅预取广告。

此设置对应于PutPlaybackConfigurationAdsPersonalizationTimeouts参数PrefetchAdsRequestTimeoutMilliseconds的成员。

预取最长 ADS 个性化时间

预取检索期间所有 ADS 活动的总时间预算,以毫秒为单位。默认情况下,此超时没有上限。有效范围:250— 10000。

有关预取的更多信息,请参阅预取广告。

此设置对应于PutPlaybackConfigurationAdsPersonalizationTimeouts参数PrefetchMaximumAdsPersonalizationTimeMilliseconds的成员。

一起设置超时

对于每个工作流程,必须同时设置个人超时和总时间预算。个人超时时间不能超过总预算。直播和 VOD 工作流程共享一个个人 ADS 请求超时时间。将该超时时间与直播和 VOD 总时长预算一起设置。同样,同时设置 Prefetch ADS 请求超时时间和 Prefetch 最长 ADS 个性化时间,不能同时设置其中一个。