本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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
應中傳回的接續權杖。接著,GetMedia
API 會從延續權杖所識別的區塊開始。類型:字串
長度限制:長度下限為 1。長度上限為 128。
模式:
^[a-zA-Z0-9_\.\-]+$
必要:否
- StartTimestamp
-
時間戳記值。如果您選擇生產者時間戳記或伺服器時間戳記作為,則需要此值。
startSelectorType
接著,GetMedia
API 會從包含具有指定時間戳記之片段的區塊開始。類型:Timestamp
必要:否
另請參閱
如需在其中一個特定語言 AWS SDK 中使用此 API 的詳細資訊,請參閱下列內容: