你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

PresentationTimeRange

PresentationTimeRange 由清单筛选器 (AssetFilter和全局 Filter) 使用。 PresentationTimeRange 规则组用于筛选清单开始/结束点、演示窗口长度和实时起始位置。 Media Services 使用多个范围的交集来定义最终演示窗口。

有关动态生成的清单的详细概述和代码示例，请参阅 动态清单概述。

另请参阅 筛选器 和 AssetFilter。

本主题介绍 PresentationTimeRange 实体。

重要

访问媒体服务中的实体时，必须在 HTTP 请求中设置特定标头字段和值。
有关详细信息，请参阅设置媒体服务 REST API 开发和使用媒体服务 REST API 连接到媒体服务。

PresentationTimeRange 属性

属性	类型	说明
StartTimestamp 适用于 VoD 或直播流。	Edm.Int64	该值表示流的绝对起点。 该值将舍入为最接近的下一个 GOP 起点。 使用 StartTimestamp 和 EndTimestamp 修剪播放列表（清单）。 例如，如果 StartTimestamp=40000000 并且 EndTimestamp=100000000，则会生成包含 StartTimestamp 与 EndTimestamp 之间的媒体的播放列表。 如果某个段跨越边界，则整个段将包含在清单中。
EndTimestamp 适用于 VoD。 对于直播，将以静默方式忽略该属性；当呈现内容结束并且流变为 VoD 时，将应用该属性。	Edm.Int64	该值表示流的绝对终点。 它将舍入为最接近的下一个 GOP 起点。 使用 StartTimestamp 和 EndTimestamp 修剪播放列表（清单）。 例如，如果 StartTimestamp=40000000 并且 EndTimestamp=100000000，则会生成包含 StartTimestamp 与 EndTimestamp 之间的媒体的播放列表。 如果某个段跨越边界，则整个段将包含在清单中。
PresentationWindowDuration 适用于实况转播和 VoD。 对于 VoD，它用于在实时演示结束时启用平滑过渡。	Edm.Int64	使用 PresentationWindowDuration 对播放列表应用滑动窗口。 例如，设置 PresentationWindowDuration = 1200000000 可应用两分钟的滑动窗口。 直播边缘 2 分钟内的媒体将包含在播放列表中。 如果某个片段跨越边界，则整个片断将包含在播放列表中。 最小呈现窗口持续时间为 60 秒。
LiveBackoffDuration 仅适用于直播。 对于 VoD，将以无提示方式忽略此项，以便在演示结束时启用平滑过渡	Edm.Int64	用于定义实时播放位置。 使用此规则，可以延迟实时播放位置并为播放器创建服务器端缓冲区。 LiveBackoffDuration 相对于直播位置。 最大直播回退持续时间为 300 秒。
Timescale 适用于 VoD 或直播流。	Edm.Int64	前面指定的时间戳和持续时间使用的时间刻度。 默认时间刻度为 10000000。 可以使用备用时间刻度。 默认值为 10000000 HNS（100 纳秒）。