

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á.

# Trabalhar com operações de análise de vídeo armazenado
<a name="video"></a>

O Amazon Rekognition Video é uma API que você pode usar para analisar vídeos. Com o Amazon Rekognition Video, você pode detectar rótulos, faces, pessoas, celebridades e conteúdo adulto (sugestivo e explícito) em vídeos armazenados em um bucket do Amazon Simple Storage Service (Amazon S3). Você pode usar o Amazon Rekognition Video em categorias como segurança pública. media/entertainment Anteriormente, escanear vídeos em busca de objetos ou pessoas exigia muitas horas de visualização propensa a erros por um ser humano. O Amazon Rekognition Video automatiza a detecção de itens e quando eles ocorrem em um vídeo.

Esta seção aborda os tipos de análise que o Amazon Rekognition Video pode realizar, uma visão geral da API e exemplos de uso do Amazon Rekognition Video.

**Topics**
+ [Tipos de análise](#video-recognition-types)
+ [Visão geral da API Amazon Rekognition Video](#video-api-overview)
+ [Chamando as operações de vídeo do Amazon Rekognition Video](api-video.md)
+ [Configuração do Amazon Rekognition Video](api-video-roles.md)
+ [Análise de um vídeo armazenado em um bucket do Amazon S3 com Java ou Python (SDK)](video-analyzing-with-sqs.md)
+ [Analisando um vídeo com o AWS Command Line Interface](video-cli-commands.md)
+ [Referência: Notificação de resultados de análise de vídeo](video-notification-payload.md)
+ [Vídeo sobre solução de problemas do Amazon Rekognition](video-troubleshooting.md)

## Tipos de análise
<a name="video-recognition-types"></a>

Você pode usar o Amazon Rekognition Video para analisar vídeos e obter as seguintes informações:
+ [Segmentos de vídeo](segments.md)
+ [Rótulos](labels.md)
+ [Conteúdo adulto sugestivo e explícito](moderation.md)
+ [Texto](text-detection.md)
+ [Celebridades](celebrities.md)
+ [Faces](faces.md)
+ [Pessoas](persons.md)

Para obter mais informações, consulte [Como o Amazon Rekognition funciona](how-it-works.md).

## Visão geral da API Amazon Rekognition Video
<a name="video-api-overview"></a>

O Amazon Rekognition Video processa um vídeo armazenado em um bucket do Amazon S3. O padrão de design é um conjunto assíncrono de operações. Inicie uma análise de vídeo chamando uma operação `Start`, como a [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartLabelDetection.html). O status de conclusão da solicitação é publicado em um tópico do Amazon Simple Notification Service (Amazon SNS). Para obter o status de conclusão do tópico do Amazon SNS, você pode usar uma fila ou uma função do Amazon Simple Queue Service (Amazon SQS). AWS Lambda Ao receber o status de conclusão, chame uma operação `Get`, como a [GetLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetLabelDetection.html) para obter os resultados da solicitação. 

O diagrama a seguir mostra o processo de detecção de rótulos em um vídeo armazenado em um bucket do Amazon S3. No diagrama, uma fila do Amazon SQS obtém o status de conclusão do tópico Amazon SNS. Como alternativa, você pode usar uma AWS Lambda função. 

![\[Diagrama de fluxo que descreve as etapas da análise de vídeo usando o Amazon Rekognition Video, o Amazon SNS e o Amazon SQS, com componentes como status de conclusão do trabalho e da publicação nas StartLabelDetection respectivas GetLabelDetection filas.\]](http://docs.aws.amazon.com/pt_br/rekognition/latest/dg/images/VideoRekognition.png)


O processo é o mesmo para outras operações de vídeo do Amazon Rekognition Video. A tabela a seguir lista as operações `Get` e `Start` para cada uma das operações do Amazon Rekognition que não são de armazenamento.


| Detecção | Operação Start | Operação Get | 
| --- | --- | --- | 
|  Segmentos de vídeo  |  [StartSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartSegmentDetection.html)  |  [GetSegmentDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetSegmentDetection.html)  | 
|  Rótulos  |  [StartLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartLabelDetection.html)  |  [GetLabelDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetLabelDetection.html)  | 
|  Conteúdo adulto sugestivo e explícito  |  [StartContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartContentModeration.html)  |  [GetContentModeration](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetContentModeration.html)  | 
|  Texto  |  [StartTextDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartTextDetection.html)  |  [GetTextDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetTextDetection.html)  | 
|  Celebridades  |  [StartCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartCelebrityRecognition.html)  |  [GetCelebrityRecognition](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetCelebrityRecognition.html)  | 
|  Faces  |  [StartFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceDetection.html)  |  [GetFaceDetection](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetFaceDetection.html)  | 
|  Pessoas  |  [StartPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartPersonTracking.html)  |  [GetPersonTracking](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GetPersonTracking.html)  | 

Para outras operações `Get` que não sejam `GetCelebrityRecognition`, o Amazon Rekognition Video retorna informações de rastreamento para quando entidades são detectadas em todo o vídeo de entrada.

Para obter mais informações sobre como usar o Amazon Rekognition Video, consulte [Chamando as operações de vídeo do Amazon Rekognition Video](api-video.md). Para ver um exemplo que faz análise de vídeo usando o Amazon SQS, consulte [Análise de um vídeo armazenado em um bucket do Amazon S3 com Java ou Python (SDK)](video-analyzing-with-sqs.md). Para obter AWS CLI exemplos, consulte[Analisando um vídeo com o AWS Command Line Interface](video-cli-commands.md).

### Formatos e armazenamento de vídeo
<a name="video-storage-formats"></a>

As operações do Amazon Rekognition podem analisar vídeos armazenados em buckets do Amazon S3. Para obter uma lista de todos os limites da operação de análise de vídeo, consulte [Diretrizes e cotas no Amazon Rekognition](limits.md).

O vídeo deve ser codificado usando o codec H.264. Os formatos de arquivo compatíveis são MPEG-4 e MOV. 

Um codec é um software ou hardware que comprime os dados para uma entrega mais rápida e descompacta os dados recebidos em sua forma original. O codec H.264 é comumente usado para gravação, compactação e distribuição de conteúdo de vídeo. O formato de arquivo de vídeo pode conter um ou mais codecs. Se o seu arquivo de vídeo no formato MOV ou MPEG-4 não funcionar com o Amazon Rekognition Video, verifique se o codec usado para codificar o vídeo é H.264. 

Qualquer API do Amazon Rekognition Video que analise dados de áudio só oferece suporte a codecs de áudio AAC.

O tamanho máximo do arquivo de um vídeo armazenado é de 10 GB.

### Procurando pessoas
<a name="video-searching-persons-overview"></a>

Você pode usar metadados faciais que estão armazenados em uma coleção para procurar pessoas em um vídeo. Por exemplo, você pode pesquisar um vídeo arquivado para buscar uma pessoa específica ou várias pessoas. Armazene metadados faciais de imagens de origem em uma coleção usando a operação [IndexFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_IndexFaces.html). Em seguida, você pode usar [StartFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_StartFaceSearch.html) para iniciar uma procura assíncrona de faces na coleção. Use [GetFaceSearch](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_GeFaceSearch.html) para obter os resultados de pesquisa. Para obter mais informações, consulte [Pesquisanda faces em vídeos armazenados](procedure-person-search-videos.md). Pesquisar pessoas é um exemplo de operação do Amazon Rekognition baseada em armazenamento. Para obter mais informações, consulte [Operações de API baseadas em armazenamento](how-it-works-storage-non-storage.md#how-it-works-storage-based).

Você também pode procurar pessoas em um vídeo de streaming. Para obter mais informações, consulte [Trabalhando com eventos de streaming de vídeo](streaming-video.md).