翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Kinesis 顔認識 JSON フレームレコードについて
<a name="streaming-video-kinesis-output-reference"></a>

**注記**  
ストリーミングビデオと一括イメージ分析は、新しいお客様では利用できなくなりました。詳細については、「[Amazon 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) オブジェクト 

**Confidence**

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

タイプ: 数値

**Landmarks**

顔の特徴の配列。

タイプ: [Landmark](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html) オブジェクト配列

**Pose**

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

タイプ: [Pose](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html) オブジェクト

**Quality**

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

タイプ: [ImageQuality](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ImageQuality.html) オブジェクト

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

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

**Face**

[DetectedFace](#streaming-video-kinesis-output-reference-detectedface) オブジェクトの顔と一致する入力コレクション内の顔に関する顔の一致情報。

タイプ: [Face](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html) オブジェクト 

**類似度**

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

タイプ: 数値