

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

# Exemplo: streaming de uma fonte RTSP
<a name="examples-rtsp"></a>

O [C\+\+](producer-sdk-cpp.md) contém uma definição para um contêiner [Docker](https://www.docker.com/) que se conecta a uma câmera de rede RTSP (Real-Time Streaming Protocol). O uso do Docker padroniza o ambiente operacional do Kinesis Video Streams, o que simplifica a criação e o uso do aplicativo.

O procedimento a seguir demonstra como configurar e usar o aplicativo do RTSP de demonstração.

**Topics**
+ [Vídeos de tutorial](#rtsp-video)
+ [Pré-requisitos](#examples-rtsp-prerequisites)
+ [Criar a imagem do Docker](#examples-rtsp-build)
+ [Execute o aplicativo de exemplo RTSP](#examples-rtsp-procedure)

## Vídeos de tutorial
<a name="rtsp-video"></a>

Este vídeo mostra como configurar um Raspberry Pi para enviar feeds RTSP para a AWS nuvem e para o Amazon Kinesis Video Streams. Isso é uma end-to-end demonstração. 

[![AWS Videos](http://img.youtube.com/vi/YoOYTCD_v3Q?si=ajdNXZpRhNnpAOKk/0.jpg)](http://www.youtube.com/watch?v=YoOYTCD_v3Q?si=ajdNXZpRhNnpAOKk)


Este vídeo demonstra como capturar imagens de um feed para usar a visão computacional e o Amazon Rekognition para processar as imagens e enviar alertas.




## Pré-requisitos
<a name="examples-rtsp-prerequisites"></a>

Para executar o aplicativo de exemplo RTSP do Kinesis Video Streams, você deve ter o seguinte:
+ **Docker:** para obter informações sobre como instalar e usar o Docker, consulte os links a seguir:
  + [Instruções para download do Docker](https://docs.docker.com/desktop/)
  + [Conceitos básicos do Docker](https://docs.docker.com/guides/getting-started/)
+ **Fonte de câmera de rede RTSP:** para obter mais informações sobre as câmeras recomendadas, consulte [Requisitos do sistema](system-requirements.md).

## Criar a imagem do Docker
<a name="examples-rtsp-build"></a>

Primeiro, crie a imagem do Docker na qual o aplicativo de demonstração será executado.

1. Clone o repositório de demonstrações do Amazon Kinesis Video Streams.

   ```
   git clone https://github.com/aws-samples/amazon-kinesis-video-streams-demos.git
   ```

1. Mude para o diretório que contém o Dockerfile. Nesse caso, é o diretório [docker-rtsp](https://github.com/aws-samples/amazon-kinesis-video-streams-demos/blob/master/producer-cpp/docker-rtsp/).

   ```
   cd amazon-kinesis-video-streams-demos/producer-cpp/docker-rtsp/
   ```

1. Use o comando a seguir para criar a imagem do Docker. Esse comando cria a imagem e a marca como rtspdockertest.

   ```
   docker build -t rtspdockertest .
   ```

1. Execute `docker images` e pesquise o ID da imagem marcado com`rtspdockertest`.

   Por exemplo, no exemplo de saída abaixo, `IMAGE ID` é`54f0d65f69b2`.

   ```
   REPOSITORY        TAG       IMAGE ID        CREATED           PLATFORM       SIZE         BLOB SIZE
   rtspdockertest    latest    54f0d65f69b2    10 minutes ago    linux/arm64    653.1 MiB    292.4 MiB
   ```

   Você precisará disso em uma etapa posterior.

## Execute o aplicativo de exemplo RTSP
<a name="examples-rtsp-procedure"></a>

Você pode executar o aplicativo de exemplo RTSP de dentro ou de fora do contêiner Docker. Siga as instruções apropriadas abaixo.

**Topics**
+ [Dentro do contêiner Docker](#examples-rtsp-within)
+ [Fora do contêiner Docker](#examples-rtsp-outside)

### Dentro do contêiner Docker
<a name="examples-rtsp-within"></a>

**Execute o aplicativo de exemplo RTSP**

1. Inicie o contêiner Docker do Amazon Kinesis Video Streams usando o seguinte comando:

   ```
   docker run -it {{YourImageId}} /bin/bash
   ```

1. Para iniciar o aplicativo de amostra, forneça suas AWS credenciais, o nome do stream de vídeo do Amazon Kinesis e a URL da câmera de rede RTSP.
**Importante**  
Se você estiver usando credenciais temporárias, você também precisará fornecer suas`AWS_SESSION_TOKEN`. Veja o segundo exemplo abaixo. 

   ```
   export AWS_ACCESS_KEY_ID={{YourAccessKeyId}}
   export AWS_SECRET_ACCESS_KEY={{YourSecretKeyId}}
   export AWS_DEFAULT_REGION={{YourAWSRegion}}
   ./kvs_gstreamer_sample {{YourStreamName}} {{YourRtspUrl}}
   ```

   **Credenciais temporárias:**

   ```
   export AWS_ACCESS_KEY_ID={{YourAccessKeyId}}
   export AWS_SECRET_ACCESS_KEY={{YourSecretKeyId}}
   export AWS_SESSION_TOKEN={{YourSessionToken}}
   export AWS_DEFAULT_REGION={{YourAWSRegion}}
   ./kvs_gstreamer_sample {{YourStreamName}} {{YourRtspUrl}}
   ```

1. Faça login Console de gerenciamento da AWS e abra o console do [Kinesis Video Streams](https://console.aws.amazon.com//kinesisvideo/home/).

   Veja o stream.

1. Para sair do contêiner Docker, feche a janela do terminal ou digite`exit`.



### Fora do contêiner Docker
<a name="examples-rtsp-outside"></a>

De **fora** do contêiner do Docker, use o seguinte comando:

```
docker run -it {{YourImageId}} /bin/bash -c "export AWS_ACCESS_KEY_ID={{YourAccessKeyId}}; export AWS_SECRET_ACCESS_KEY={{YourSecretKeyId}}; export AWS_SESSION_TOKEN={{YourSessionToken}}; export AWS_DEFAULT_REGION={{Your AWS Region}}; ./kvs_gstreamer_sample {{YourStreamName}} {{YourRtspUrl}}"
```