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

# 處理串流影片事件
<a name="streaming-video"></a>

**注意**  
串流影片和大量影像分析不再提供給新客戶。如需詳細資訊，請參閱[Amazon Rekognition 功能可用性變更](rekognition-availability-changes.md)。  
**此變更不會影響其他 Amazon Rekognition 功能的可用性。**

您可以使用 Amazon Rekognition Video 來偵測及辨識串流影片中的人臉。Amazon Rekognition Video 使用 Amazon Kinesis Video Streams 來接收和處理影片串流。您可以使用顯示自己希望從影片串流偵測的內容的参数來建立串流處理器。Rekognition 會以 Amazon SNS 和 Amazon S3 通知的形式，從串流影片事件傳送標籤偵測結果。Rekognition 會將人臉搜尋結果輸出至 Kinesis 資料串流。

人臉搜尋串流處理器用 `FaceSearchSettings` 來搜尋系列中的臉孔。如需如何實作人臉搜尋串流處理器以分析串流影片中人臉的詳細資訊，請參閱 [在串流影片中搜尋集合中的人臉](collections-streaming.md)。

標籤偵測串流處理器用 `ConnectedHomeSettings` 在串流影片事件中搜尋人員、套件和寵物。如需如何實作標籤偵測串流處理器的詳細資訊，請參閱 [偵測串流影片事件中的標籤](streaming-video-detect-labels.md)。

## Amazon Rekognition Video 串流處理器操作概觀
<a name="using-rekognition-video-stream-processor"></a>

若要開始分析串流影片，請啟動 Amazon Rekognition Video 串流處理器，並將影片串流至 Amazon Rekognition Video。Amazon Rekognition Video 串流處理器可讓您啟動、停止及管理串流處理器。您可以通過呼叫 [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) 來建立流處理器。用於建立人臉搜尋串流處理器的請求參數包括 Kinesis 影片串流的 Amazon Resource Name (ARN)、Kinesis 資料串流，以及用來辨識串流影片中人臉的集合識別符。用於建立安全監控串流處理器的請求參數包括 Kinesis 影片串流的 Amazon Resource Name (ARN) 和 Amazon SNS 主題、要在影片串流中偵測到的物件類型，以及輸出結果之 Amazon S3 儲存貯體的資訊。該參數也包含您為串流處理器指定的名稱。

您可以透過呼叫 [StartStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartStreamProcessor.html) 操作來開始處理影片。若要取得串流處理器的狀態資訊，請呼叫 [DescribeStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DescribeStreamProcessor.html)。您可以呼叫的其他操作包括標記串流處理器的 [TagResource](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_TagResource.html) 與刪除串流處理器的 [DeleteStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DeleteStreamProcessor.html)。如果您使用的是人臉搜尋串流處理器，您也可以使用 [StopStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StopStreamProcessor.html) 來停止串流處理器。若要取得您帳戶中的串流處理器清單，請呼叫 [ListStreamProcessors](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ListStreamProcessors.html)。

在串流處理器開始執行之後，您可以透過在 `CreateStreamProcessor` 中指定的 Kinesis 影片串流，將該影片串流至 Amazon Rekognition Video。您可以使用 Kinesis Video Streams SDK [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) 操作，將影片傳遞至 Kinesis 影片串流。如需範例，請參閱 [PutMedia API 範例](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/examples-putmedia.html)。

如需應用程式從人臉搜尋串流處理器取用 Amazon Rekognition Video 分析結果的相關資訊，請參閱 [讀取串流影片分析結果](streaming-video-kinesis-output.md)。