本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
StartSelector
识别 Kinesis 视频流中您希望 GetMedia
API 开始返回媒体数据的区块。您可以通过以下几种方式设置 Condition 子句:
-
选择最新(或最旧)的区块。
-
确定特定的区块。您可以通过提供片段号或时间戳(服务器或生产者)来识别特定的块。
-
每个区块的元数据都包含一个作为 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
响应中返回的延续令牌。然后,GetMedia
API 从延续令牌标识的区块开始。类型:字符串
长度限制:最小长度为 1。最大长度为 128。
模式:
^[a-zA-Z0-9_\.\-]+$
必需:否
- StartTimestamp
-
时间戳值。如果您选择 PRODUCER_TIMESTAMP 或 SERVER_TIMESTAMP 作为必填值。
startSelectorType
然后,GetMedia
API 从包含具有指定时间戳的片段的区块开始。类型:Timestamp
必需:否
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: