Référence : enregistrement de reconnaissance faciale Kinesis

Vidéo Amazon Rekognition peut reconnaître des visages dans une vidéo diffusée en streaming. Pour chaque trame analysée, Vidéo Amazon Rekognition transmet un enregistrement de trame JSON à un flux de données . Vidéo Amazon Rekognition n’analyse pas toutes les images qui lui sont transmises via le flux vidéo Kinesis.

L’enregistrement de trame JSON contient des informations sur les flux d’entrée et de sortie, le statut du processeur de flux, ainsi que des informations sur les visages reconnus dans les trames analysées. Cette section contient des informations de référence pour l’enregistrement de fréquence JSON.

Voici la syntaxe JSON pour un enregistrement de flux de données Kinesis. Pour plus d’informations, consultez Utilisation d'événements vidéo en streaming.

Note

L’API de Vidéo Amazon Rekognition compare les visages de votre flux d’entrée à une collection de visages, puis renvoie les correspondances les plus proches trouvées, ainsi qu’un score de similarité.

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

Enregistrement JSON

L’enregistrement JSON contient inclut des informations sur une trame traitée par Vidéo Amazon Rekognition. L’enregistrement contient des informations sur la vidéo streaming, le statut de la trame analysée et les visages reconnus dans la trame.

InputInformation

Informations sur le flux vidéo Kinesis utilisé pour diffuser des vidéos dans Vidéo Amazon Rekognition.

Type : objet InputInformation

StreamProcessorInformation

Informations sur le processeur de flux Vidéo Amazon Rekognition. Comprend des informations sur le statut en cours du processeur de flux.

Type : objet StreamProcessorInformation

FaceSearchResponse

Informations sur les visages détectés dans la trame vidéo en streaming et sur les visages correspondants trouvés dans la collection d’entrée.

Type : tableau d’objets FaceSearchResponse