

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Memahami rekam bingkai JSON pengenalan wajah Kinesis
<a name="streaming-video-kinesis-output-reference"></a>

**catatan**  
Streaming Video dan Analisis Gambar Massal tidak lagi tersedia untuk pelanggan baru. Untuk informasi selengkapnya, lihat [Perubahan ketersediaan fitur Amazon Rekognition](rekognition-availability-changes.md).  
**Perubahan ini tidak memengaruhi ketersediaan fitur Amazon Rekognition lainnya.**

Amazon Rekognition Video dapat mengenali wajah dalam video streaming. Untuk setiap frame yang dianalisis, Amazon Rekognition Video menghasilkan catatan frame JSON ke aliran data Kinesis. Amazon Rekognition Video tidak menganalisis setiap frame yang diteruskan melalui aliran video Kinesis. 

Catatan frame JSON berisi informasi tentang input dan output stream, status pemroses aliran, dan informasi tentang wajah yang diakui dalam frame yang dianalisis. Bagian ini berisi informasi referensi untuk catatan bingkai JSON.

Berikut ini adalah sintaksis JSON untuk catatan aliran data Kinesis. Untuk informasi selengkapnya, lihat [Bekerja dengan acara video streaming](streaming-video.md).

**catatan**  
API Amazon Rekognition Video bekerja dengan membandingkan wajah di input aliran Anda dengan koleksi wajah, dan memberikan hasil wajah yang paling cocok yang ditemukan, bersama dengan skor kesamaan.

```
{
    "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"
                    }
                }
            ]
        }
    ]
}
```

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

Catatan JSON mencakup informasi tentang frame yang diproses oleh Amazon Rekognition Video. Catatan tersebut mencakup informasi tentang video streaming tersebut, status frame yang dianalisis, dan informasi tentang wajah yang dikenali dalam frame.

**InputInformation**

Informasi tentang aliran video Kinesis yang digunakan untuk melakukan streaming video ke Amazon Rekognition Video.

Tipe: Objek [InputInformation](#streaming-video-kinesis-output-reference-inputinformation)

**StreamProcessorInformation**

Informasi tentang pemroses aliran Amazon Rekognition Video. Ini termasuk informasi status untuk status pemroses aliran saat ini.

Tipe: Objek [StreamProcessorInformation](streaming-video-kinesis-output-reference-streamprocessorinformation.md) 

**FaceSearchResponse**

Informasi tentang wajah yang terdeteksi dalam frame video streaming dan wajah paling cocok yang ditemukan dalam koleksi input.

Tipe: Array objek [FaceSearchResponse](#streaming-video-kinesis-output-reference-facesearchresponse)

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

Informasi tentang aliran video sumber yang digunakan oleh Amazon Rekognition Video. Untuk informasi selengkapnya, lihat [Bekerja dengan acara video streaming](streaming-video.md).

**KinesisVideo**

Tipe: Objek [KinesisVideo](#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo)

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

Informasi tentang aliran video Kinesis yang mengalirkan video sumber ke Amazon Rekognition Video. Untuk informasi selengkapnya, lihat [Bekerja dengan acara video streaming](streaming-video.md).

**StreamArn**

Amazon Resource Name (ARN) dari aliran video Kinesis.

Tipe: String 

**FragmentNumber**

Fragmen video streaming yang berisi frame yang diwakilkan oleh catatan ini.

Tipe: String

**ProducerTimestamp**

Stempel waktu Unix sisi produsen fragmen. Untuk informasi selengkapnya, lihat [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).

Jenis: Angka

**ServerTimestamp**

Stempel waktu Unix sisi server fragmen. Untuk informasi selengkapnya, lihat [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).

Jenis: Angka

**FrameOffsetInSeconds**

Offset frame (dalam detik) di dalam fragmen.

Jenis: Angka 

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

Informasi tentang wajah yang terdeteksi dalam frame video streaming dan wajah dalam koleksi yang sesuai dengan wajah yang terdeteksi. Anda menentukan koleksi dalam panggilan ke [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html). Untuk informasi selengkapnya, lihat [Bekerja dengan acara video streaming](streaming-video.md). 

**DetectedFace**

Detail wajah untuk wajah yang terdeteksi dalam frame video yang dianalisis.

Tipe: Objek [DetectedFace](#streaming-video-kinesis-output-reference-detectedface)

**MatchedFaces**

Array detail wajah untuk wajah dalam koleksi yang cocok dengan wajah yang terdeteksi di `DetectedFace`.

Tipe: Array objek [MatchedFace](#streaming-video-kinesis-output-reference-facematch)

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

Informasi tentang wajah yang terdeteksi dalam frame video streaming. Wajah yang cocok dalam koleksi input tersedia di bidang objek [MatchedFace](#streaming-video-kinesis-output-reference-facematch).

**BoundingBox**

Kotak batas mengoordinasikan wajah yang terdeteksi dalam bingkai video yang dianalisis. BoundingBox Objek memiliki sifat yang sama dengan BoundingBox objek yang digunakan untuk analisis gambar.

Tipe: Objek [BoundingBox](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_BoundingBox.html) 

**Keyakinan**

Tingkat kepercayaan (1-100) yang dimiliki Amazon Rekognition Video bahwa wajah yang terdeteksi adalah benar-benar wajah. 1 adalah kepercayaan terendah, 100 adalah yang tertinggi.

Tipe: Angka

**Tengara**

Array penanda wajah

Jenis: [Array objek Landmark](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html)

**Pose**

Menunjukkan pose wajah sebagaimana ditentukan oleh pitch, roll, dan yaw.

Jenis: [Pose](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html) objek

**Kualitas**

Mengidentifikasi kecerahan dan ketajaman citra wajah. 

Tipe: Objek [ImageQuality](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ImageQuality.html)

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

Informasi tentang wajah yang cocok dengan wajah yang terdeteksi dalam bingkai video yang dianalisis.

**Wajah**

Informasi kecocokan wajah untuk wajah dalam koleksi input yang cocok dengan wajah di objek [DetectedFace](#streaming-video-kinesis-output-reference-detectedface). 

Jenis: Objek [wajah](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html) 

**Kesamaan**

Tingkat kepercayaan (1-100) bahwa tersebut wajah cocok. 1 adalah kepercayaan terendah, 100 adalah yang tertinggi.

Jenis: Angka 