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

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

您可以使用 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)。

# 將標籤新增到新的串流處理器
<a name="streaming-video-tagging-stream-processor"></a>

您可以使用標籤來識別、組織、搜尋和篩選 Amazon Rekognition 串流處理器。每個標籤都是由使用者定義的金鑰和值組成的標籤。

您可以在使用 `CreateStreamProcessor` 操作建立串流處理器時，將標籤新增至串流處理器。在 `Tags` 陣列輸入參數中指定一或多個標籤。以下是 `CreateStreamProcessor` 要求的帶標記的 JSON 範例。

```
{
       "Name": "streamProcessorForCam",
       "Input": {
              "KinesisVideoStream": {
                     "Arn": "arn:aws:kinesisvideo:us-east-1:nnnnnnnnnnnn:stream/inputVideo"
              }
       },
       "Output": {
              "KinesisDataStream": {
                     "Arn": "arn:aws:kinesis:us-east-1:nnnnnnnnnnnn:stream/outputData"
              }
       },
       "RoleArn": "arn:aws:iam::nnnnnnnnnnn:role/roleWithKinesisPermission",
       "Settings": {
              "FaceSearch": {
                     "CollectionId": "collection-with-100-faces",
                     "FaceMatchThreshold": 85.5
              },
              "Tags": { 
      "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
       }
}
```

# 將標籤新增到現有串流處理器
<a name="add-tag-existing-stream-processor"></a>

您可以使用標籤來識別、組織、搜尋和篩選 Amazon Rekognition 串流處理器。每個標籤都是由使用者定義的金鑰和值組成的標籤。

若要將一個或多個標籤新增至現有串流處理器，請使用 `TagResource` 操作。指定串流處理器的 Amazon Resource Name (ARN) (`ResourceArn`) 和要新增的標籤 (`Tags`)。下列範例顯示如何結合標記。

```
aws rekognition tag-resource --resource-arn resource-arn \
                --tags '{"key1":"value1","key2":"value2"}'
```

**注意**  
如果您不知道串流處理器的 Amazon Resource Name，則可以使用該 `DescribeStreamProcessor` 操作。

# 列出串流處理器中的標籤
<a name="list-tags-stream-processor"></a>

您可以使用標籤來識別、組織、搜尋和篩選 Amazon Rekognition 串流處理器。每個標籤都是由使用者定義的金鑰和值組成的標籤。

若要列出連接到串流處理器的標籤，請使用此 `ListTagsForResource` 操作並指定串流處理器的 ARN (`ResourceArn`)。回應是連接到指定串流處理器標籤鍵和值的映射。

```
aws rekognition list-tags-for-resource --resource-arn resource-arn
```

輸出顯示連接到流處理器的標籤清單：

```
{
    "Tags": {
        "Dept": "Engineering",
        "Name": "Ana Silva Carolina",
        "Role": "Developer"
    }
}
```

# 從串流處理器刪除標籤
<a name="delete-tag-stream-processor"></a>

您可以使用標籤來識別、組織、搜尋和篩選 Amazon Rekognition 串流處理器。每個標籤都是由使用者定義的金鑰和值組成的標籤。

若要移除串流處理器的一個或多個標籤，請使用 `UntagResource` 操作。指定要移除的模型 (`ResourceArn`) 和標籤鍵 (`Tag-Keys`) 的 ARN。

```
aws rekognition untag-resource --resource-arn resource-arn \
                --tag-keys '["key1","key2"]'
```

或者，您可以使用以下格式指定標籤鍵：

```
--tag-keys key1,key2
```