リファレンス: Kinesis 顔認識レコード

Amazon Rekognition Video は、ストリーミングビデオ内で顔を認識できます。Amazon Rekognition Video は、分析された各フレームの JSON フレームレコードを Kinesis データストリームに配置します。Amazon Rekognition Video では、Kinesis ビデオストリームを通じて渡されたフレームはすべて分析されません。

JSON フレームレコードには、入力ストリームと出力ストリーム、ストリームプロセッサのステータス、および分析されたフレームで認識された顔に関する情報が含まれます。このセクションでは、JSON フレームレコードに関するリファレンス情報を紹介します。

以下に示しているのは、Kinesis データストリームのレコードの JSON 構文です。詳細については、「ストリーミングビデオイベントの操作」を参照してください。

注記

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 レコード

JSON レコードには、Amazon Rekognition Video によって処理されたフレームに関する情報が含まれます。レコードには、ストリーミングビデオ、分析されたフレームのステータス、およびフレームで認識された顔に関する情報が含まれます。

InputInformation

Amazon Rekognition Video にビデオをストリーミングする際に使用された Kinesis ビデオストリームに関する情報。

タイプ：InputInformation オブジェクト

StreamProcessorInformation

Amazon Rekognition Video ストリームプロセッサに関する情報。これには、ストリームプロセッサの現在のステータスに関する情報が含まれます。

タイプ：StreamProcessorInformation オブジェクト

FaceSearchResponse

ストリーミングビデオフレームで検出された顔と入力コレクション内で見つかった一致する顔に関する情報。

型: FaceSearchResponse オブジェクト配列