Skip to content

Latest commit

 

History

History

examples

uvgRTP example codes

This directory contains a collection of commented and functioning examples that demonstrate the usage of uvgRTP.

Building the examples

Compile the library according to instructions in BUILDING.md. Follow either Visual Studio or Linux compilation instructions below:

Visual Studio compilation

Navigate to uvgRTP/build/examples and open the uvgrtp_examples.sln with Visual Studio, through which you can build the individual example programs. When building, select the Release x64 version. The built executable files will be found in uvgRTP/build/examples/Release

Linux and MinGW compilation

Navigate to uvgRTP/build/examples and compile the programs with the make command.

Basic RTP examples

How to create a simple RTP sender (Pair with one of the receiver examples)

How to create a simple RTP receiver (hooking)

NOTE: The hook should not be used for extensive media processing. It is meant to be used as an interface between application and library where uvgRTP hands off the RTP frames to an application thread.

How to create a simple RTP receiver (polling)

Visual Volumetric Video-based Coding (V3C) streaming

To demonstrate V3C streaming, uvgRTP comes with example V3C sender and V3C receiver programs, found in uvgRTP/build/examples. Below are simple step-by-step instructions to run these programs:

  1. Build the library according to instructions in BUILDING.md. Crypto++ is not needed.
  2. Build the v3c_sender and v3c_receiver applications according to building instructions on the top of this page.
  3. Download a test sequence from here.
  4. Place the test sequence in uvgRTP/build/examples/Release
  5. Start the v3c_receiver program with ./v3c_receiver uvgRTP_example_sequence_longdress.vpcc. If you have changed the filename, modify the command accordingly.
  6. Start the v3c_sender program with ./v3c_sender uvgRTP_example_sequence_longdress.vpcc. The program will parse the test sequence for transmission and send it to the receiver.
  7. The v3c_receiver will print information on the reception and reconstruction of the V3C bitstream. It will also check the received sequence for any differences to the original one.

RTCP example

How to use RTCP instance (hooking)

Encryption examples

Make sure you have checked the build instructions if you want to build the encryption examples with Visual Studio.

How to use SRTP with ZRTP

How to use multi-stream SRTP with ZRTP

How to use SRTP with user-managed keys

Advanced RTP examples

How to modify uvgRTP behavior

How to fragment generic media types

How to enable UDP hole punching

How to use custom timestamps correctly