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

# 使用存储视频分析操作
<a name="video"></a>

Amazon Rekognition Video 是可用于分析视频的 API。利用 Amazon Rekognition Video，您可以检测存储于 Amazon Simple Storage Service (Amazon S3) 存储桶的视频中的标签、人脸、人员、名人和成人（暗示性和明显的）内容。您可以在公共安全等类别中使用亚马逊 Rekognition Video。 media/entertainment 以前，扫描视频中的物体或人员可能需要人进行数小时的查看，并且这种方式容易出错。Amazon Rekognition Video 将自动检测视频中的项目和它们出现的时间。

本节介绍 Amazon Rekognition Video 可执行的分析类型、API 的概述以及使用 Amazon Rekognition Video 的示例。

**Topics**
+ [分析类型](#video-recognition-types)
+ [Amazon Rekognition Video API 概述](#video-api-overview)
+ [调用 Amazon Rekognition Video 操作](api-video.md)
+ [配置 Amazon Rekognition Video](api-video-roles.md)
+ [使用 Java 或 Python 分析存储在 Amazon S3 存储桶中的视频 (SDK)](video-analyzing-with-sqs.md)
+ [使用分析视频 AWS Command Line Interface](video-cli-commands.md)
+ [参考：视频分析结果通知](video-notification-payload.md)
+ [Amazon Rekognition Video 故障排除](video-troubleshooting.md)

## 分析类型
<a name="video-recognition-types"></a>

您可以使用 Amazon Rekognition Video 分析视频中的以下信息：
+ [视频分段](segments.md)
+ [标签](labels.md)
+ [暗示性和明显的成人内容](moderation.md)
+ [文本](text-detection.md)
+ [名人](celebrities.md)
+ [人脸](faces.md)
+ [人员](persons.md)

有关更多信息，请参阅 [Amazon Rekognition 的工作原理](how-it-works.md)。

## Amazon Rekognition Video API 概述
<a name="video-api-overview"></a>

Amazon Rekognition Video 处理存储在 Amazon S3 存储桶中的视频。设计模式是异步操作集。您可通过调用 `Start` 操作 (如 [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartLabelDetection.html)) 来启动视频分析。将请求完成状态发布到Amazon Simple Notification Service (Amazon SNS) 主题。要从亚马逊 SNS 主题中获取完成状态，您可以使用亚马逊简单队列服务 (Amazon SQS) Simple Queue 队列或函数。 AWS Lambda 在获得完成状态之后，请调用 `Get` 操作 (如 [GetLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetLabelDetection.html)) 以获取请求的结果。

下图显示了检测存储于 Amazon S3 存储桶的视频中的标签的过程。在此图中，Amazon SQS 队列将从 Amazon SNS 主题获取完成状态。或者，你可以使用一个 AWS Lambda 函数。

![流程图描述了使用 Amazon Rekognition Video、Amazon SNS 和 Amazon SQS 进行视频分析的步骤，以及任务和向相应 StartLabelDetection队列发布 GetLabelDetection 完成状态等组件。](http://docs.aws.amazon.com/zh_cn/rekognition/latest/dg/images/VideoRekognition.png)


其他 Amazon Rekognition Video 操作的过程相同。下表列出了每个非存储 Amazon Rekognition 操作的 `Start` 和 `Get` 操作。


| 检测 | Start 操作 | Get 操作 | 
| --- | --- | --- | 
| 视频分段 | [StartSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartSegmentDetection.html) | [GetSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetSegmentDetection.html) | 
| 标签 | [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartLabelDetection.html) | [GetLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetLabelDetection.html) | 
| 明显的或暗示性成人内容 | [StartContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartContentModeration.html) | [GetContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetContentModeration.html) | 
| 文本 | [StartTextDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartTextDetection.html) | [GetTextDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetTextDetection.html) | 
| 名人 | [StartCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartCelebrityRecognition.html) | [GetCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetCelebrityRecognition.html) | 
| 人脸 | [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html) | [GetFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html) | 
| People | [StartPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartPersonTracking.html) | [GetPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetPersonTracking.html) | 

对于 `Get` 之外的 `GetCelebrityRecognition` 操作，Amazon Rekognition Video 将返回有关何时在整个输入视频中检测到实体的跟踪信息。

有关使用 Amazon Rekognition Video 的更多信息，请参阅[调用 Amazon Rekognition Video 操作](api-video.md)。有关使用 Amazon SQS 执行视频分析的示例，请参阅[使用 Java 或 Python 分析存储在 Amazon S3 存储桶中的视频 (SDK)](video-analyzing-with-sqs.md)。有关 AWS CLI 示例，请参见[使用分析视频 AWS Command Line Interface](video-cli-commands.md)。

### 视频格式和存储
<a name="video-storage-formats"></a>

Amazon Rekognition 操作可以分析存储在 Amazon S3 存储桶中的视频。有关对视频分析操作的所有限制的列表，请参阅[Amazon Rekognition 中的准则和配额](limits.md)。

必须使用编解码器对视频进行 H.264 编码。支持的文件格式为 MPEG-4 和 MOV。

编解码器是一种软件或硬件，用于压缩数据以提高传输速度以及将收到的数据解压为其原始形式。编 H.264 解码器通常用于录制、压缩和分发视频内容。视频文件格式可包含一个或多个编解码器。如果您的 MOV 或 MPEG-4 格式化视频文件不适用于亚马逊 Rekognition Video，请检查用于对视频进行编码的编解码器是否是。 H.264

任何分析音频数据的 Amazon Rekognition Video API 仅支持 AAC 音频编解码器。

存储视频的最大文件大小为 10GB。

### 搜索人员
<a name="video-searching-persons-overview"></a>

您可以使用存储在集合中的面部元数据来搜索视频中的人员。例如，您可以在已存档视频中搜索某个特定人员或搜索多个人员。您使用 [IndexFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_IndexFaces.html) 操作将源图像中的面部元数据存储在集合中。然后，您可以使用 [StartFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceSearch.html) 在集合中开始异步搜索人脸。您使用 [GetFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GeFaceSearch.html) 获取搜索结果。有关更多信息，请参阅 [搜索存储视频中的人脸](procedure-person-search-videos.md)。搜索人员是基于存储的 Amazon Rekognition 操作的一个示例。有关更多信息，请参阅 [Storage-based API 操作](how-it-works-storage-non-storage.md#how-it-works-storage-based)。

您还可以在流视频中搜索人员。有关更多信息，请参阅 [使用流视频事件](streaming-video.md)。