本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 了解 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 Resource Name (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 是最高的可信度。

類型：數字