livekit_bridge: An ergonomic interface into the Livekit C++ SDK

[stephen-derosa]

Overview

An ergonomic library providing simple usage of the C++ SDK.

Building

This library is attached to the build system of the core C++ SDK library. Use build.sh as is.

Testing

The bridge/examples/ directory has simulated human and robot tests. There are 4 files:

• robot.cpp: publishes video and audio from a webcam and microphone. This requires a webcam and microphone to be available.
• robot_stub.cpp: publishes stubbed audio and video. This exists to exemplify simplicity.
• human.cpp: receives and renders video to the screen, receives and plays audio through the speaker.
• human_stub.cpp: receives video and audio and prints that it was received. This exists to exemplify simplicity.

These have been tested manually.

Unit tests

1. CallbackKey hashing/equality,
2. BridgeAudioTrack/BridgeVideoTrack state management, and
3. LiveKitBridge pre-connection behaviour (callback registration, error handling).

Limitations

The bridge is designed for simplicity and currently only supports limited audio and video features. It does not expose:

• E2EE configuration
• RPC / data channels / data tracks
• Simulcast tuning
• Video format selection (RGBA is the default; no format option yet)
• Custom RoomOptions or TrackPublishOptions

For advanced use cases, use the full client-sdk-cpp API directly, or expand the bridge to support your use case.

TODOs before merge

• multiple video/audio streams
• ❓ what other tests should we require here to ensure we have a good infrastructure moving forward?
• ❓ Other general LiveKit reqs?

[CLAassistant]

All committers have signed the CLA.

[xianshijing-lk]

Good work, that is a large PR, I will need more time to review it.

some initial questions to get a clearer picture on the design.

[xianshijing-lk]

Great work!

LGTM with some suggestions offline.