Kinesis 顔認識JSONフレームレコードについて

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 オブジェクト配列

InputInformation

Amazon Rekognition Video によって使用されたソースビデオストリームに関する情報。詳細については、「ストリーミングビデオイベントの操作」を参照してください。

KinesisVideo

型: KinesisVideo オブジェクト

KinesisVideo

Amazon Rekognition Video にソースビデオをストリーミングする際に使用された Kinesis ビデオストリームに関する情報。詳細については、「ストリーミングビデオイベントの操作」を参照してください。

StreamArn

Kinesis ビデオストリームの Amazon リソースネーム (ARN）。

型: 文字列

FragmentNumber

このレコードを表すフレームが含まれるストリーミングビデオのフラグメント。

型: 文字列

ProducerTimestamp

フラグメントのプロデューサー側の Unix タイムスタンプ。詳細については、「」を参照してくださいPutMedia。

タイプ: 数値

ServerTimestamp

フラグメントのサーバー側の Unix タイムスタンプ。詳細については、「」を参照してくださいPutMedia。

タイプ: 数値

FrameOffsetInSeconds

フラグメント内のフレームのオフセット (秒)。

タイプ: 数値

FaceSearchResponse

ストリーミングビデオフレームで検出された顔と、検出された顔に一致するコレクション内の顔に関する情報。コレクションは、 への呼び出しで指定しますCreateStreamProcessor。詳細については、「ストリーミングビデオイベントの操作」を参照してください。

DetectedFace

分析されたビデオフレームで検出された顔の詳細情報。

型: DetectedFace オブジェクト

MatchedFaces

DetectedFace で検出された顔と一致するコレクション内の顔の詳細情報の配列。

型: MatchedFace オブジェクト配列

DetectedFace

ストリーミングビデオフレーム内で検出された顔に関する情報。入力コレクション内の一致した顔は MatchedFace オブジェクトフィールドにあります。

BoundingBox

分析されたビデオフレーム内で検出された顔の境界ボックスの座標。 BoundingBox オブジェクトのプロパティは、イメージ分析に使用される BoundingBox オブジェクトと同じです。

型: BoundingBox オブジェクト

Confidence

検出された顔が実際に顔であることを Amazon Rekognition Video が信頼するレベル (1 ～ 100)。1 が最も低い信頼度、100 が最も高い信頼度。

タイプ: 数値

Landmarks

顔の特徴の配列。

タイプ: Landmark オブジェクト配列

Pose

ピッチ、ロール、ヨーイングによって特定される顔の表情を示します。

タイプ: Pose オブジェクト

Quality

顔イメージの明るさとシャープネスを示します。

型: ImageQuality オブジェクト

MatchedFace

分析されたビデオフレーム内で検出された顔に一致する顔に関する情報。

Face

DetectedFace オブジェクトの顔と一致する入力コレクション内の顔に関する顔の一致情報。

タイプ: Face オブジェクト

Similarity

顔の一致の信頼度のレベル (1 ～ 100)。1 が最も低い信頼度、100 が最も高い信頼度です。

タイプ: 数値