StartSelector - Amazon Kinesis Video Streams
内容另请参阅

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

StartSelector

标识 Kinesis 视频流中您希望 GetMedia API 开始返回媒体数据的区块。您可以通过以下选项来识别起始块：

  • 选择最新（或最旧）的区块。

  • 确定一个特定的区块。您可以通过提供片段编号或时间戳（服务器或生产者）来识别特定的区块。

  • 每个区块的元数据都包含一个作为 Matroska (MKV) 标签 () 的延续令牌。AWS_KINESISVIDEO_CONTINUATION_TOKEN如果您之前的GetMedia请求已终止，则可以在下一个GetMedia请求中使用此标签值。然后，API 开始返回从上一个 API 结束位置开始的区块。

内容

StartSelectorType

标识 Kinesis 视频流中您要从中开始获取数据的片段。

  • 现在-从直播中的最新片段开始。

  • 最早-从直播中最早的可用区块开始。

  • FRAGMENT_NUMBER-从特定片段之后的区块开始。还必须指定 AfterFragmentNumber 参数。

  • PRODUCER_TIMESTAMP 或 SERVER_TIMESTAMP-从包含具有指定生产者或服务器时间戳的片段的区块开始。您可以通过添加StartTimestamp来指定时间戳。

  • CONTINUATION_TOKEN-使用指定的延续令牌进行读取。

注意

如果您选择 “现在”、“最早” 或 “CONTINUATION_TOKEN” 作为startSelectorType，则无需在中提供任何其他信息。startSelector

类型：字符串

有效值：FRAGMENT_NUMBER | SERVER_TIMESTAMP | PRODUCER_TIMESTAMP | NOW | EARLIEST | CONTINUATION_TOKEN

必需：是

AfterFragmentNumber

指定您希望 GetMedia API 从何处开始返回片段的片段编号。

类型：字符串

长度限制：长度下限为 1。长度上限为 128。

模式：^[0-9]+$

必需：否

ContinuationToken

Kinesis Video Streams 在GetMedia之前的响应中返回的延续令牌。然后，GetMediaAPI 从延续令牌标识的区块开始。

类型：字符串

长度限制：长度下限为 1。长度上限为 128。

模式：^[a-zA-Z0-9_\.\-]+$

必需：否

StartTimestamp

时间戳值。如果您选择 PRODUCER_TIMESTAMP 或 SERVER_TIMESTAMP 作为，则需要此值。startSelectorType然后，GetMediaAPI 从包含具有指定时间戳的片段的区块开始。

类型：时间戳

必需：否

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：