Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Comprendre l'enregistrement de trame JSON de reconnaissance faciale Kinesis
**Note**
Les vidéos en streaming et l'analyse d'images en masse ne sont plus disponibles pour les nouveaux clients. Pour de plus amples informations, veuillez consulter [Modifications relatives à la disponibilité des fonctionnalités Amazon Rekognition](rekognition-availability-changes.md).
**Cette modification n'a aucune incidence sur la disponibilité des autres fonctionnalités d'Amazon Rekognition.**
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 de plus amples informations, veuillez consulter [Utilisation des vidéos streaming](streaming-video.md).
**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](#streaming-video-kinesis-output-reference-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](streaming-video-kinesis-output-reference-streamprocessorinformation.md)
**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](#streaming-video-kinesis-output-reference-facesearchresponse)
## InputInformation
Informations sur un flux vidéo source utilisé par Vidéo Amazon Rekognition. Pour de plus amples informations, veuillez consulter [Utilisation des vidéos streaming](streaming-video.md).
**KinesisVideo**
Type : objet [KinesisVideo](#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo)
## KinesisVideo
Informations sur le flux vidéo Kinesis qui diffuse la vidéo source sur Vidéo Amazon Rekognition. Pour de plus amples informations, veuillez consulter [Utilisation des vidéos streaming](streaming-video.md).
**StreamArn**
Le Amazon Resource Name (ARN) du flux vidéo Kinesis.
Type : Chaîne
**FragmentNumber**
Le fragment de vidéo streaming qui contient la trame que cet enregistrement représente.
Type : Chaîne
**ProducerTimestamp**
L’horodatage Unix côté producteur du fragment. Pour de plus amples informations, veuillez consulter [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).
Type : Number
**ServerTimestamp**
L’horodatage Unix côté serveur du fragment. Pour de plus amples informations, veuillez consulter [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).
Type : Number
**FrameOffsetInSeconds**
Le décalage de la trame (en secondes) dans le fragment.
Type : Number
## FaceSearchResponse
Informations sur un visage détecté dans la trame vidéo en streaming et sur les visages dans une collection qui correspondent au visage détecté. Vous spécifiez la collection dans un appel à [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html). Pour de plus amples informations, veuillez consulter [Utilisation des vidéos streaming](streaming-video.md).
**DetectedFace**
Détails d’un visage détecté dans une trame vidéo analysée.
Type : objet [DetectedFace](#streaming-video-kinesis-output-reference-detectedface)
**MatchedFaces**
Tableau de détails de visages pour des visages dans une collection qui correspond au visage détecté dans `DetectedFace`.
Type : tableau d’objets [MatchedFace](#streaming-video-kinesis-output-reference-facematch)
## DetectedFace
Informations sur un visage détecté dans une trame vidéo en streaming. Les visages correspondants dans la collection d’entrée sont disponibles dans le champ d’objet [MatchedFace](#streaming-video-kinesis-output-reference-facematch).
**BoundingBox**
Le cadre de délimitation s’accorde avec un visage détecté dans une trame vidéo analysée. L' BoundingBox objet possède les mêmes propriétés que l' BoundingBox objet utilisé pour l'analyse d'image.
Type : objet [BoundingBox](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_BoundingBox.html)
**Fiabilité**
Correspond au niveau de confiance (1 à 100) de Vidéo Amazon Rekognition quant au fait que le visage détecté est bien un visage. 1 correspond au niveau de confiance le plus faible, 100 au niveau le plus élevé.
Type : Number
**Traits caractéristiques**
Un tableau de traits caractéristiques de visage.
Type : tableau d’objets [repères](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html)
**Expression**
Indique l’expression du visage selon les axes vertical, horizontal, et l’orientation.
Type : objet [d’expression](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html)
**Qualité**
Identifie la luminosité et la netteté de l’image du visage.
Type : objet [ImageQuality](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ImageQuality.html)
## MatchedFace
Informations sur un visage correspondant à un visage détecté dans une trame vidéo analysée.
**Visage**
Informations de correspondance de visages pour un visage de la collection d’entrée qui correspond au visage dans l’objet [DetectedFace](#streaming-video-kinesis-output-reference-detectedface).
Type : objet [facial](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html)
**Similarité**
Le niveau de confiance (1 à 100) auquel les visages correspondent. 1 est le niveau de confiance le plus faible, 100 le plus élevé.
Type : Number