Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Comprendere il frame record JSON di riconoscimento facciale Kinesis
**Nota**
Streaming Video and Bulk Image Analysis non è più disponibile per i nuovi clienti. Per ulteriori informazioni, consulta [Modifiche alla disponibilità delle funzionalità di Amazon Rekognition](rekognition-availability-changes.md).
**Questa modifica non influisce sulla disponibilità di altre funzionalità di Amazon Rekognition.**
Video Amazon Rekognition può riconoscere i volti in un video in streaming. Per ogni fotogramma analizzato, Video Amazon Rekognition invia un record di fotogramma JSON a un flusso di dati Kinesis. Video Amazon Rekognition non analizza tutti i fotogrammi che gli vengono trasmessi tramite il flusso video Kinesis.
Il record di fotogramma JSON contiene informazioni sul flusso di input e output, sullo stato dell'elaboratore di flussi e informazioni sui volti riconosciuti nel fotogramma analizzato. Questa sezione contiene informazioni di riferimento per il record di fotogramma JSON.
Di seguito è riportata la sintassi JSON per un record di flusso di dati Kinesis. Per ulteriori informazioni, consulta [Utilizzo degli eventi video in streaming](streaming-video.md).
**Nota**
L'API Video Amazon Rekognition funziona confrontando i volti nel flusso di input con una raccolta di volti e restituendo le corrispondenze trovate più vicine, insieme a un punteggio di somiglianza.
```
{
"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"
}
}
]
}
]
}
```
## Record JSON
Il record JSON include informazioni su un fotogramma elaborato da Video Amazon Rekognition. Il record include informazioni sul video in streaming, lo stato del fotogramma analizzato e informazioni sui volti riconosciuti nel fotogramma.
**InputInformation**
Informazioni sul flusso video Kinesis utilizzato per lo streaming di video in Video Amazon Rekognition.
Tipo: oggetto [InputInformation](#streaming-video-kinesis-output-reference-inputinformation)
**StreamProcessorInformation**
Informazioni sull'elaboratore di flussi di Video Amazon Rekognition. Sono incluse le informazioni sullo stato attuale dell'elaboratore di flussi.
Tipo: oggetto [StreamProcessorInformation](streaming-video-kinesis-output-reference-streamprocessorinformation.md)
**FaceSearchResponse**
Informazioni sui volti rilevati in un fotogramma video in streaming e i volti corrispondenti trovati nella raccolta di input.
Tipo: array di oggetti [FaceSearchResponse](#streaming-video-kinesis-output-reference-facesearchresponse)
## InputInformation
Informazioni su un flusso video di origine utilizzato da Video Amazon Rekognition. Per ulteriori informazioni, consulta [Utilizzo degli eventi video in streaming](streaming-video.md).
**KinesisVideo**
Tipo: oggetto [KinesisVideo](#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo)
## KinesisVideo
Informazioni sul flusso video Kinesis che esegue lo streaming del video di origine in Video Amazon Rekognition. Per ulteriori informazioni, consulta [Utilizzo degli eventi video in streaming](streaming-video.md).
**StreamArn**
Il nome della risorsa Amazon (ARN) del flusso video Kinesis.
Tipo: String
**FragmentNumber**
Frammento del video in streaming che contiene il fotogramma rappresentato da questo record.
Tipo: String
**ProducerTimestamp**
Time stamp Unix lato produttore del frammento. Per ulteriori informazioni, consulta [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).
Tipo: numero
**ServerTimestamp**
Time stamp Unix lato server del frammento. Per ulteriori informazioni, consulta [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).
Tipo: numero
**FrameOffsetInSeconds**
Offset del fotogramma (in secondi) all'interno del frammento.
Tipo: numero
## FaceSearchResponse
Informazioni su un volto rilevato in un fotogramma video in streaming e sui volti in una raccolta che corrispondono al volto rilevato. La raccolta viene specificata in una chiamata a [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html). Per ulteriori informazioni, consulta [Utilizzo degli eventi video in streaming](streaming-video.md).
**DetectedFace**
I dettagli di un volto rilevato in un fotogramma video analizzato.
Tipo: oggetto [DetectedFace](#streaming-video-kinesis-output-reference-detectedface)
**MatchedFaces**
Una matrice di dettagli di volti per i volti in una raccolta corrispondente al volto rilevato in `DetectedFace`.
Tipo: array di oggetti [MatchedFace](#streaming-video-kinesis-output-reference-facematch)
## DetectedFace
Informazioni su un volto rilevato in un fotogramma di un video in streaming. I volti corrispondenti nella raccolta di input sono disponibili nel campo oggetto [MatchedFace](#streaming-video-kinesis-output-reference-facematch).
**BoundingBox**
Coordinate della cornice per un volto rilevato in un fotogramma di un video analizzato. L' BoundingBox oggetto ha le stesse proprietà dell' BoundingBox oggetto utilizzato per l'analisi delle immagini.
Tipo: oggetto [BoundingBox](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_BoundingBox.html)
**Confidence**
Il livello di confidenza (1-100) che Video Amazon Rekognition ha sul fatto che il volto rilevato sia effettivamente un volto. 1 è la confidenza più bassa, 100 è la più alta.
Tipo: numero
**Landmarks**
Matrice di punti di riferimento del volto.
Tipo: matrice di oggetti [Landmark](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html)
**Posa**
Indica la posa del volto definita da beccheggio, rollio e imbardata.
Tipo: oggetto [Pose](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html)
**Qualità**
Identifica la luminosità e la nitidezza dell'immagine del volto.
Tipo: oggetto [ImageQuality](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ImageQuality.html)
## MatchedFace
Informazioni su un volto che corrisponde a un volto rilevato in un fotogramma video analizzato.
**Face**
Informazioni di corrispondenza per un volto nella raccolta di input che corrisponde al volto rilevato nell'oggetto [DetectedFace](#streaming-video-kinesis-output-reference-detectedface).
Tipo: oggetto [Face](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html)
**Somiglianza**
Il livello di confidenza (1-100) sul fatto che i volti corrispondano. 1 è la confidenza più bassa, 100 è la più alta.
Tipo: numero