本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用流视频事件
<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 资源名称 (ARNs)、Kinesis 数据流以及用于识别流视频中人脸的集合标识符。创建安全监控流处理器的请求参数包括 Kinesis 视频流和 Amazon SNS 主题的 Amazon 资源名称 (ARNs)、您要在视频流中检测到的对象类型以及输出结果的 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 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)SDK 操作将视频传送到 Kinesis 视频流中。有关示例，请参阅 [PutMediaAPI 示例](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 资源名称（ARN）（`ResourceArn`）和要添加的标签（`Tags`）。以下示例说明了如何添加两个标签。

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

**注意**  
如果您不了解流处理器的 Amazon 资源名称，则可以使用 `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` 操作。指定模型的 ARN（`ResourceArn`）和要移除的标签键（`Tag-Keys`）。

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

或者，您可以按以下格式指定标签键：

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