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

# 使用流视频事件
<a name="streaming-video"></a>

**注意**  
新客户不再可以使用流媒体视频和批量图像分析。有关更多信息，请参阅 [亚马逊 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 资源名称 (ARN)、Kinesis 数据流以及用于识别流视频中的人脸的集合的标识符。创建安全监控流处理器的请求参数包括 Kinesis 视频流和 Amazon SNS 主题的 Amazon 资源名称 (ARN)、您要在视频流中检测到的对象类型以及输出结果的 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)。