WebRTC SDK in C for Embedded Devices - Kinesis Video Streams
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

WebRTC SDK in C for Embedded Devices

The following step-by-step instructions describe how to download, build, and run the Kinesis Video Streams with WebRTC SDK in C for embedded devices and its corresponding samples.

Download the Kinesis Video Streams with WebRTC SDK in C

To download the Kinesis Video Streams with WebRTC SDK in C for embedded devices, run the following command:

$ git clone --recursive https://github.com/awslabs/amazon-kinesis-video-streams-webrtc-sdk-c.git

Build the Kinesis Video Streams with WebRTC SDK in C


Before you complete these steps on a macOS and depending on the version of the macOS you have, you must run xcode-select --install to download the package with the command line tools and header. Then open /Library/Developer/CommandLineTools/Packages/macOS_SDK_headers_for_macOS_10.14.pkg and follow the intaller to install the command line tools and header. You only need to do this once and before invoking cmake. If you already have the command line tools and header installed, you do not need to run this command again.

Complete the following steps:

  1. Install cmake:

    • On macOS, run brew install cmake pkg-config srtp

    • on Ubuntu, run sudo apt-get install pkg-config cmake libcap2 libcap-dev

  2. Obtain the access key and the secret key of the Amazon Web Services account that you want to use for this demo.

  3. Run the following command to create a build directory in your downloaded WebRTC C SDK, and execute cmake from it:

    $ mkdir -p amazon-kinesis-video-streams-webrtc-sdk-c/build; cd amazon-kinesis-video-streams-webrtc-sdk-c/build; cmake ..
  4. Now that you're in the build directory you just created with the step above, run make to build the WebRTC C SDK and its provided samples.


    The kvsWebrtcClientMasterGstSample will NOT be built if the system doesn't have gstreamer installed. To make sure it is built (on macOS) you must run: brew install gstreamer gst-plugins-base gst-plugins-good

Run the Samples for the WebRTC SDK in C

After you complete the procedure above, you end up with the following sample applications in your build directory:

  • kvsWebrtcClientMaster - This application sends sample H264/Opus frames (path: /samples/h264SampleFrames and /samples/opusSampleFrames) via the signaling channel. It also accepts incoming audio, if enabled in the browser. When checked in the browser, it prints the metadata of the received audio packets in your terminal.

  • kvsWebrtcClientViewer - This application accepts sample H264/Opus frames and prints them out.

  • kvsWebrtcClientMasterGstSample - This application sends sample H264/Opus frames from a GStreamer pipeline.

To run any of these samples, complete the following steps:

  1. Setup your environment with your Amazon Web Services account credentials:

    export AWS_ACCESS_KEY_ID= Your Amazon Web Services account access key export AWS_SECRET_ACCESS_KEY= Amazon Web Services account secret key export AWS_KVS_CACERT_PATH= Full path of your cert.pem file. It is typically available in the certs directory inside Kinesis-video-webrtc-native-build/certs/cert.pm
  2. Run either of the sample applications by passing to it the name that you want to give to your signaling channel. The application creates the signaling channel using the name you provide. For example, to create a signaling channel called myChannel and to start sending sample H264/Opus frames via this channel, run the following command:

    ./kvsWebrtcClientMaster myChannel

    When the command line application prints Connection established, you can proceed to the next step.

  3. Now that your signaling channel is created and the connected master is streaming media to it, you can view this stream. For example, you can view this live stream in a web application. To do so, open the WebRTC SDK Test Page using the steps in Using the Kinesis Video Streams with WebRTC Test Page and set the following values using the same Amazon credentials and the same signaling channel that you specified for the master above:

    • Access key ID

    • Secret access key

    • Signaling channel name

    • Client ID (optional)

    Choose Start viewer to start live video streaming of the sample H264/Opus frames.