

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

# StartSelector
<a name="API_dataplane_StartSelector"></a>

識別您希望 `GetMedia` API 開始傳回媒體資料的 Kinesis 影片串流上的區塊。您有下列選項來識別開始區塊：
+ 選擇最新 （或最舊） 區塊。
+ 識別特定區塊。您可以提供片段編號或時間戳記 （伺服器或生產者） 來識別特定區塊。
+ 每個區塊的中繼資料都包含接續字符做為 Matroska (MKV) 標籤 ()`AWS_KINESISVIDEO_CONTINUATION_TOKEN`。如果您之前的`GetMedia`請求已終止，您可以在下一個`GetMedia`請求中使用此標籤值。然後，API 會從最後一個 API 結束的位置開始傳回區塊。

## 目錄
<a name="API_dataplane_StartSelector_Contents"></a>

 ** StartSelectorType **   <a name="KinesisVideo-Type-dataplane_StartSelector-StartSelectorType"></a>
識別您要開始從中取得資料的 Kinesis 影片串流片段。  
+ 現在 - 從串流上的最新區塊開始。
+ EARLIEST - 從串流上最早的可用區塊開始。
+ FRAGMENT\$1NUMBER - 從特定片段之後的區塊開始。您也必須指定 `AfterFragmentNumber` 參數。
+ PRODUCER\$1TIMESTAMP 或 SERVER\$1TIMESTAMP - 從包含具有指定生產者或伺服器時間戳記之片段的區塊開始。您可以新增 來指定時間戳記`StartTimestamp`。
+  CONTINUATION\$1TOKEN - 使用指定的接續字符讀取。
如果您選擇 NOW、EARLIEST 或 CONTINUATION\$1TOKEN 做為 `startSelectorType`，則不會在 中提供任何其他資訊`startSelector`。
類型：字串  
有效值:`FRAGMENT_NUMBER | SERVER_TIMESTAMP | PRODUCER_TIMESTAMP | NOW | EARLIEST | CONTINUATION_TOKEN`   
必要：是

 ** AfterFragmentNumber **   <a name="KinesisVideo-Type-dataplane_StartSelector-AfterFragmentNumber"></a>
指定您希望 `GetMedia` API 從中開始傳回片段的片段編號。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`^[0-9]+$`  
必要：否

 ** ContinuationToken **   <a name="KinesisVideo-Type-dataplane_StartSelector-ContinuationToken"></a>
Kinesis Video Streams 在上一個`GetMedia`回應中傳回的連續字符。然後，`GetMedia`API 會從接續字符識別的區塊開始。  
類型：字串  
長度限制：長度下限為 1。長度上限為 128。  
模式：`^[a-zA-Z0-9_\.\-]+$`  
必要：否

 ** StartTimestamp **   <a name="KinesisVideo-Type-dataplane_StartSelector-StartTimestamp"></a>
時間戳記值。如果您選擇 PRODUCER\$1TIMESTAMP 或 SERVER\$1TIMESTAMP 作為 ，則需要此值`startSelectorType`。`GetMedia` API 接著會從包含具有指定時間戳記之片段的區塊開始。  
類型：Timestamp  
必要：否

## 另請參閱
<a name="API_dataplane_StartSelector_SeeAlso"></a>

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容：
+  [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-data-2017-09-30/StartSelector) 
+  [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-data-2017-09-30/StartSelector) 
+  [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-data-2017-09-30/StartSelector) 