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

# 了解 Kinesis 人脸识别 JSON 帧记录
<a name="streaming-video-kinesis-output-reference"></a>

**注意**  
新客户不再可以使用流媒体视频和批量图像分析。有关更多信息，请参阅 [亚马逊 Rekognition 功能可用性变更](rekognition-availability-changes.md)。  
**此更改不会影响其他 Amazon Rekognition 功能的可用性。**

您可以使用 Amazon Rekognition Video 来识别流视频中的人脸。对于每个分析过的帧，Amazon Rekognition Video 会将 JSON 帧记录输出到 Kinesis 数据流中。Amazon Rekognition Video 不会分析通过 Kinesis 视频流传递给它的每一帧。

JSON 帧记录包含以下信息：输入和输出流、流处理器的状态以及在分析过的帧中识别的人脸。本节包含 JSON 帧记录的参考信息。

以下是 Kinesis 数据流记录的 JSON 语法。有关更多信息，请参阅 [使用流视频事件](streaming-video.md)。

**注意**  
Amazon Rekognition Video API 的工作原理是将输入流中的人脸与人脸集合进行比较，并返回找到的最接近的匹配项以及相似度分数。

```
{
    "InputInformation": {
        "KinesisVideo": {
            "StreamArn": "string",
            "FragmentNumber": "string",
            "ProducerTimestamp": number,
            "ServerTimestamp": number,
            "FrameOffsetInSeconds": number
        }
    },
    "StreamProcessorInformation": {
        "Status": "RUNNING"
    },
    "FaceSearchResponse": [
        {
            "DetectedFace": {
                "BoundingBox": {
                    "Width": number,
                    "Top": number,
                    "Height": number,
                    "Left": number
                },
                "Confidence": number,
                "Landmarks": [
                    {
                        "Type": "string",
                        "X": number,
                        "Y": number
                    }
                ],
                "Pose": {
                    "Pitch": number,
                    "Roll": number,
                    "Yaw": number
                },
                "Quality": {
                    "Brightness": number,
                    "Sharpness": number
                }
            },
            "MatchedFaces": [
                {
                    "Similarity": number,
                    "Face": {
                        "BoundingBox": {
                            "Width": number,
                            "Top": number,
                            "Height": number,
                            "Left": number
                        },
                        "Confidence": number,
                        "ExternalImageId": "string",
                        "FaceId": "string",
                        "ImageId": "string"
                    }
                }
            ]
        }
    ]
}
```

## JSON 记录
<a name="streaming-video-kinesis-output-reference-processorresult"></a>

JSON 记录包含有关由 Amazon Rekognition Video 处理的帧的信息。该记录包含有关流视频的信息、分析过的帧的状态信息以及有关在该帧中识别的人脸的信息。

**InputInformation**

有关用于将视频流式传输到 Amazon Rekognition Video 的 Kinesis 视频流的信息。

类型：[InputInformation](#streaming-video-kinesis-output-reference-inputinformation) 对象

**StreamProcessorInformation**

有关 Amazon Rekognition Video 流处理器的信息。这包括流处理器的当前状态的状态信息。

类型：[StreamProcessorInformation](streaming-video-kinesis-output-reference-streamprocessorinformation.md) 对象 

**FaceSearchResponse**

有关在流视频帧中检测到的人脸与在输入集合中找到的匹配人脸的信息。

类型：[FaceSearchResponse](#streaming-video-kinesis-output-reference-facesearchresponse) 对象数组

## InputInformation
<a name="streaming-video-kinesis-output-reference-inputinformation"></a>

有关 Amazon Rekognition Video 使用的源视频流的信息。有关更多信息，请参阅 [使用流视频事件](streaming-video.md)。

**KinesisVideo**

类型：[KinesisVideo](#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo) 对象

## KinesisVideo
<a name="streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo"></a>

有关将源视频流式传输到 Amazon Rekognition Video 的 Kinesis 视频流的信息。有关更多信息，请参阅 [使用流视频事件](streaming-video.md)。

**StreamArn**

Kinesis 数据流的 Amazon 资源名称 (ARN)。

类型：字符串 

**FragmentNumber**

一个流视频的片断，包含此记录表示的帧。

类型：字符串

**ProducerTimestamp**

片段的生成者端 Unix 时间戳。有关更多信息，请参阅 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)。

类型：数字

**ServerTimestamp**

片段的服务器端 Unix 时间戳。有关更多信息，请参阅 [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html)。

类型：数字

**FrameOffsetInSeconds**

片段内的帧的偏移量（以秒为单位）。

类型：数字 

## FaceSearchResponse
<a name="streaming-video-kinesis-output-reference-facesearchresponse"></a>

有关在流视频帧中检测到的人脸与集合中的与检测到的人脸匹配的人脸的信息。您可在调用 [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) 时指定集合。有关更多信息，请参阅 [使用流视频事件](streaming-video.md)。

**DetectedFace**

在分析的视频帧中检测到的人脸的人脸详细信息。

类型：[DetectedFace](#streaming-video-kinesis-output-reference-detectedface) 对象

**MatchedFaces**

集合中的人脸的人脸详细信息数组，该集合与在 `DetectedFace` 中检测到的人脸匹配。

类型：[MatchedFace](#streaming-video-kinesis-output-reference-facematch) 对象数组

## DetectedFace
<a name="streaming-video-kinesis-output-reference-detectedface"></a>

有关在流视频帧中检测到的人脸的信息。[MatchedFace](#streaming-video-kinesis-output-reference-facematch) 对象字段中提供了输入集合中的匹配人脸。

**BoundingBox**

在分析过的视频帧内检测到的人脸的边界框坐标。该 BoundingBox 对象与用于图像分析的 BoundingBox 对象具有相同的属性。

类型：[BoundingBox](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_BoundingBox.html) 对象 

置信度

Amazon Rekognition Video 对检测到的人脸是否真的是人脸的置信度 (1-100)。1 表示最低置信度，100 表示最高置信度。

类型：数字

**标记**

一组人脸标记。

类型：[地标](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html)对象数组

**姿势**

指示根据人脸的俯仰、翻滚和偏转确定的人脸的姿势。

类型：[姿势](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html)对象

**质量**

确定人脸图像亮度和锐度。

类型：[ImageQuality](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ImageQuality.html) 对象

## MatchedFace
<a name="streaming-video-kinesis-output-reference-facematch"></a>

有关与在分析的视频帧中检测到的人脸匹配的人脸的信息。

**人脸**

人脸匹配信息，针对输入集合中与 [DetectedFace](#streaming-video-kinesis-output-reference-detectedface) 对象中的人脸匹配的人脸。

类型：[人脸](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html)对象 

**相似度**

人脸匹配的置信度 (1-100)。1 表示最低置信度，100 表示最高置信度。

类型：数字