Example: Streaming from an RTSP Source
The C++ Producer Library contains a definition for a Docker container that connects to an RTSP (Real Time Streaming Protocol) network camera. Using Docker standardizes the operating environment for Kinesis Video Streams, which greatly simplifies building and executing the application.
To use the RTSP demo application, first install and build the C++ Producer Library.
The following procedure demonstrates how to set up and use the RTSP demo application.
Prerequisites
To run the Kinesis Video Streams RTSP example application, you must have the following:
-
Docker: For information about installing and using Docker, see the following links:
-
RTSP network camera source: For information about recommended cameras, see System Requirements.
Build the Docker Image
First, you build the Docker image that the demo application will run inside.
-
Create a new directory and copy the following files from the
docker_native_scriptsdirectory to the new directory:-
Dockerfile -
start_rtsp_in_docker.sh
-
-
Change to the directory that you created in the previous step.
-
Build the Docker image using the following command. This command creates the image and tags it as
rtspdockertest.docker build -t rtspdockertest . -
Record the image ID that was returned in the previous step (for example,
54f0d65f69b2).
Run the RTSP Example Application
Start the Kinesis Video Streams Docker container using the following command. Provide the image ID from the previous step, your AWS credentials, the URL of your RTSP network camera, and the name of the Kinesis video stream to send the data.
$ docker run -it<IMAGE_ID><AWS_ACCESS_KEY_ID><AWS_SECRET_ACCESS_KEY><RTSP_URL><STREAM_NAME>
To customize the application, comment or remove the ENTRYPOINT
command in Dockerfile, and launch the container using the following
command:
docker run -it<IMAGE_ID>bash
You are then prompted inside the Docker container to customize the sample application and start streaming.
