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 的詳細資訊,請參閱下列內容: