StartSelector - Amazon Kinesis Video Streams
目錄另請參閱

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

StartSelector

識別 Kinesis 視訊串流上您希望 GetMedia API 開始傳回媒體資料的區塊。您可以使用下列選項來識別起始區塊：

  • 選擇最新 (或最舊) 的區塊。

  • 識別特定區塊。您可以通過提供片段編號或時間戳記（服務器或生產者）來識別特定塊。

  • 每個塊的元數據包括一個繼續令牌作為 Matroska（MKV）標記（）。AWS_KINESISVIDEO_CONTINUATION_TOKEN如果您先前的GetMedia請求終止，您可以在下一個GetMedia請求中使用此標籤值。然後，API 開始返回從最後一個 API 結束的位置開始返回塊。

目錄

StartSelectorType

識別 Kinesis 視訊串流上您要從中開始取得資料的片段。

  • 現在-從流上的最新塊開始。

  • 最早-從串流上最早的可用區塊開始。

  • 片段編號-從特定片段之後的塊開始。您也必須指定 AfterFragmentNumber 參數。

  • 生產者時間戳或服務器時間戳-從包含具有指定生產者或服務器時間戳的片段的塊開始。您可以透過新增來指定時間戳記StartTimestamp。

  • 繼續令牌-使用指定的繼續令牌讀取。

注意

如果您選擇「立即」、「最早」或「繼續 _ 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

時間戳記值。如果您選擇生產者時間戳記或伺服器時間戳記作為，則需要此值。startSelectorType接著，GetMediaAPI 會從包含具有指定時間戳記之片段的區塊開始。

類型：Timestamp

必要：否

另請參閱

如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊，請參閱下列內容：