

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Den JSON-Frame-Datensatz für Kinesis-Gesichtserkennung verstehen
<a name="streaming-video-kinesis-output-reference"></a>

**Anmerkung**  
Streaming-Video und Bildanalyse in großen Mengen sind für Neukunden nicht mehr verfügbar. Weitere Informationen finden Sie unter [Änderungen der Verfügbarkeit der Amazon Rekognition Rekognition-Funktionen](rekognition-availability-changes.md).  
**Diese Änderung hat keine Auswirkungen auf die Verfügbarkeit anderer Amazon Rekognition Rekognition-Funktionen.**

Amazon Rekognition Video kann Gesichter in einem Streaming-Video erkennen. Für jedes analysierte Bild gibt Amazon Rekognition Video einen JSON-Bilddatensatz an einen Kinesis-Datenstrom aus. Amazon Rekognition Video analysiert nicht jedes Bild, das über den Kinesis-Videostrom an Amazon Rekognition Video weitergegeben wird. 

Der JSON-Frame-Datensatz enthält Informationen über den Input- und Output-Stream, den Status des Stromprozessors und Informationen über Gesichter, die im analysierten Frame erkannt wurden. Dieser Abschnitt enthält Referenzinformationen für den JSON-Frame-Datensatz.

Im Folgenden finden Sie die JSON-Syntax für einen Kinesis-Datenstromdatensatz. Weitere Informationen finden Sie unter [Arbeiten mit Streaming-Videoereignissen](streaming-video.md).

**Anmerkung**  
Die Amazon-Rekognition-Video-API vergleicht die Gesichter in Ihrem Eingabestrom mit einer Sammlung von Gesichtern und gibt die größten gefundenen Übereinstimmungen zusammen mit einem Ähnlichkeitswert zurück.

```
{
    "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-Datensatz
<a name="streaming-video-kinesis-output-reference-processorresult"></a>

Der JSON-Datensatz enthält Informationen über den Frame, der von Amazon Rekognition Video verarbeitet wurde. Der Datensatz enthält Informationen über das Streaming-Video, den Status des analysierten Frames und Informationen über Gesichter, die im analysierten Frame erkannt wurden.

**InputInformation**

Informationen über den Kinesis-Videostrom, der zum Streamen von Videos in Amazon Rekognition Video verwendet wird.

Typ: [InputInformation](#streaming-video-kinesis-output-reference-inputinformation) Objekt

**StreamProcessorInformation**

Informationen über den Amazon-Rekognition-Video-Stromprozessor. Dies umfasst Statusinformationen über den aktuellen Status des Stromprozessors.

Typ: [StreamProcessorInformation](streaming-video-kinesis-output-reference-streamprocessorinformation.md) Objekt 

**FaceSearchResponse**

Informationen über die erkannten Gesichter in einem Streaming-Video-Frame und die übereinstimmenden Gesichter, die in der Eingabesammlung gefunden wurden.

Typ: [FaceSearchResponse](#streaming-video-kinesis-output-reference-facesearchresponse) Objekt-Array

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

Informationen über einen Quellvideostrom, der von Amazon Rekognition Video verwendet wird. Weitere Informationen finden Sie unter [Arbeiten mit Streaming-Videoereignissen](streaming-video.md).

**KinesisVideo**

Typ: [KinesisVideo](#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo) Objekt

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

Informationen über den Kinesis-Videostrom, der das Quellvideo in Amazon Rekognition Video streamt. Weitere Informationen finden Sie unter [Arbeiten mit Streaming-Videoereignissen](streaming-video.md).

**StreamArn**

Der Amazon-Ressourcenname (ARN) des Kinesis-Videostroms.

Typ: Zeichenfolge 

**FragmentNumber**

Das Fragment des Streaming-Videos, das den Frame enthält, den dieser Datensatz darstellt.

Typ: Zeichenfolge

**ProducerTimestamp**

Der produzentenseitige Unix-Zeitstempel des Fragments. Weitere Informationen finden Sie unter [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).

Typ: Zahl

**ServerTimestamp**

Der serverseitige Unix-Zeitstempel des Fragments. Weitere Informationen finden Sie unter [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).

Typ: Zahl

**FrameOffsetInSeconds**

Der Versatz des Frames (in Sekunden) innerhalb des Fragments.

Typ: Zahl 

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

Informationen über ein erkanntes Gesicht in einem Streaming-Video-Frame und die Gesichter in einer Eingabesammlung, die mit dem erkannten Gesicht übereinstimmen. Sie geben die Sammlung in einem Aufruf von [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html) an. Weitere Informationen finden Sie unter [Arbeiten mit Streaming-Videoereignissen](streaming-video.md). 

**DetectedFace**

Gesichtsdetails zu einem in einem analysierten Video-Frame erkannten Gesicht.

Typ: [DetectedFace](#streaming-video-kinesis-output-reference-detectedface) Objekt

**MatchedFaces**

Ein Array von Gesichtsdetails für Gesichter in einer Sammlung, die mit dem in `DetectedFace` erkannten Gesicht übereinstimmen.

Typ: [MatchedFace](#streaming-video-kinesis-output-reference-facematch) Objekt-Array

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

Informationen über ein Gesicht, das in einem Streaming-Video-Frame erkannt wurde. Übereinstimmende Gesichter in der Eingabesammlung stehen im [MatchedFace](#streaming-video-kinesis-output-reference-facematch)-Objektfeld zur Verfügung.

**BoundingBox**

Der Begrenzungsrahmen liefert die Koordinaten für ein Gesicht, das in einem analysierten Videobild erkannt wird. Das BoundingBox Objekt hat dieselben Eigenschaften wie das BoundingBox Objekt, das für die Bildanalyse verwendet wird.

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

**Wahrscheinlichkeit**

Das Zuverlässigkeitsniveau (1–100) von Amazon Rekognition Video, dass es sich bei dem erkannten Gesicht tatsächlich um ein Gesicht handelt. 1 ist das niedrigste Zuverlässigkeitsniveau, 100 das höchste.

Typ: Zahl

**Erkennungszeichen**

Ein Array von Gesichtsmerkmalen.

Typ: [Merkmal](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html)-Objekt-Array

**Pose**

Gibt die Pose des Gesichts an, die durch Nicken, Neigen und Drehen bestimmt ist.

Typ: [Pose](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html)-Objekt

**Qualität**

Gibt die Helligkeit und Schärfe des Gesichtsbilds an. 

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

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

Informationen über ein Gesicht, das mit einem in einem analysierten Video-Frame erkannten Gesicht übereinstimmt.

**Gesicht**

Informationen zur Gesichtsübereinstimmung für ein Gesicht in der Eingabesammlung, das mit dem Gesicht übereinstimmt, das im [DetectedFace](#streaming-video-kinesis-output-reference-detectedface)-Objekt erkannt wurde. 

Typ: [Gesichts](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html)-Objekt 

**Ähnlichkeit**

Das Zuverlässigkeitsniveau (1–100), dem die Gesichter entsprechen. 1 ist das niedrigste Zuverlässigkeitsniveau, 100 das höchste.

Typ: Zahl 