As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Entender o registro de quadros JSON de reconhecimento facial do Kinesis
**nota**
O streaming de vídeo e a análise de imagens em massa não estão mais disponíveis para novos clientes. Para obter mais informações, consulte [Alterações na disponibilidade do recurso Amazon Rekognition](rekognition-availability-changes.md).
**Essa alteração não afeta a disponibilidade de outros recursos do Amazon Rekognition.**
O Amazon Rekognition Video pode reconhecer faces em um streaming de vídeo. Para cada quadro analisado, o Amazon Rekognition Video gera um registro de quadro JSON em um fluxo de dados do Kinesis. O Amazon Rekognition Video não analisa cada quadro que é passado para ele pelo stream de vídeo do Kinesis.
O registro de quadros JSON contém informações sobre o stream de entrada e de saída, o status do processador de fluxo e informações sobre faces que são reconhecidas no quadro analisado. Esta seção contém informações de referência para o registro de quadros JSON.
A seguir está a sintaxe JSON para um registro de fluxo de dados do Kinesis. Para obter mais informações, consulte [Trabalhando com eventos de streaming de vídeo](streaming-video.md).
**nota**
A API Amazon Rekognition Video funciona comparando as faces em seu stream de entrada com uma coleção de faces e retornando as correspondências mais próximas encontradas, junto com uma pontuação de similaridade.
```
{
"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"
}
}
]
}
]
}
```
## Registro JSON
O registro JSON inclui informações sobre um quadro processado pelo Amazon Rekognition Video. O registro inclui informações sobre o streaming de vídeo, o status do quadro analisado e informações sobre faces que são reconhecidas no quadro.
**InputInformation**
Informações sobre o stream de vídeo do Kinesis usado para transmitir vídeo para o Amazon Rekognition Video.
Tipo: objeto [InputInformation](#streaming-video-kinesis-output-reference-inputinformation)
**StreamProcessorInformation**
Informações sobre o processador de stream do Amazon Rekognition Video. Isso inclui informações de status para o status atual do processador de fluxo.
Tipo: objeto [StreamProcessorInformation](streaming-video-kinesis-output-reference-streamprocessorinformation.md)
**FaceSearchResponse**
Informações sobre as faces detectadas em um quadro de streaming de vídeo e as faces correspondentes encontradas na coleção de entrada.
Tipo: matriz de objetos [FaceSearchResponse](#streaming-video-kinesis-output-reference-facesearchresponse)
## InputInformation
Informações sobre um stream de vídeo de origem usado pelo Amazon Rekognition Video. Para obter mais informações, consulte [Trabalhando com eventos de streaming de vídeo](streaming-video.md).
**KinesisVideo**
Tipo: objeto [KinesisVideo](#streaming-video-kinesis-output-reference-kinesisvideostreams-kinesisvideo)
## KinesisVideo
Informações sobre o stream de vídeo do Kinesis que transmite o vídeo de origem para o Amazon Rekognition Video. Para obter mais informações, consulte [Trabalhando com eventos de streaming de vídeo](streaming-video.md).
**StreamArn**
O nome de recurso da Amazon (ARN) do stream de vídeo do Kinesis.
Tipo: string
**FragmentNumber**
O fragmento de streaming de vídeo que contém o quadro que esse registro representa.
Tipo: string
**ProducerTimestamp**
O time stamp do Unix do lado do produtor do fragmento. Para obter mais informações, consulte [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).
Tipo: número
**ServerTimestamp**
O time stamp do Unix do lado do servidor do fragmento. Para obter mais informações, consulte [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html).
Tipo: número
**FrameOffsetInSeconds**
O deslocamento do quadro (em segundos) dentro do fragmento.
Tipo: número
## FaceSearchResponse
Informações sobre uma face detectada em um quadro de streaming de vídeo e as faces em uma coleção que correspondem à face detectada. Você especifica a coleção em uma chamada para [CreateStreamProcessor](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_CreateStreamProcessor.html). Para obter mais informações, consulte [Trabalhando com eventos de streaming de vídeo](streaming-video.md).
**DetectedFace**
Detalhes de uma face detectada em um quadro de vídeo analisado.
Tipo: objeto [DetectedFace](#streaming-video-kinesis-output-reference-detectedface)
**MatchedFaces**
Uma matriz dos detalhes de faces em uma coleção que corresponda à face detectada na `DetectedFace`.
Tipo: matriz de objetos [MatchedFace](#streaming-video-kinesis-output-reference-facematch)
## DetectedFace
Informações sobre uma face detectada em um quadro de streaming de vídeo. As faces correspondentes na coleção de entrada estão disponíveis no campo do objeto [MatchedFace](#streaming-video-kinesis-output-reference-facematch).
**BoundingBox**
A caixa delimitadora coordena para uma face que é detectada dentro de um quadro de vídeo analisado. O BoundingBox objeto tem as mesmas propriedades do BoundingBox objeto usado para análise de imagem.
Tipo: objeto [BoundingBox](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_BoundingBox.html)
**Confiança**
O nível de confiança (1-100) que o Amazon Rekognition Video tem de que a face detectada é, na verdade, uma face. 1 é a confiança mais baixa, 100 é a mais alta.
Tipo: número
**Pontos de referência**
Uma matriz de pontos de referência faciais.
Tipo: Matriz de objetos de [pontos de referência](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Landmark.html)
**Pose**
Indica a pose da face conforme determinada pelos seus eixos lateral, vertical e longitudinal.
Tipo: Objeto de [pose](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Pose.html)
**Qualidade**
Identifica o brilho a nitidez da imagem da face.
Tipo: objeto [ImageQuality](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_ImageQuality.html)
## MatchedFace
Informações sobre uma face que corresponde a uma face detectada em um quadro de vídeo analisado.
**Rosto**
Informações sobre a correspondência de uma face na coleção de entrada que corresponde à face no objeto [DetectedFace](#streaming-video-kinesis-output-reference-detectedface).
Tipo: Objeto [Face](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_Face.html)
**Semelhança**
O nível de confiança (1-100) com o qual as faces coincidem. 1 é a confiança mais baixa, 100 é a mais alta.
Tipo: número