LiveKit: Native SDK

:: Warning ::

This SDK is currently in developer preview and is not ready for production use. There will be bugs and the APIs may change during this period.

All feedback and contributions are appreciated. You can create issues or discuss with us on the #rust-developer-preview channel in our Slack

Features

• Receiving tracks ( VP8, Software decoder only )
• Cross-platform ( currently tested on Windows & MacOS )
• Publishing tracks
• Adaptive Streaming
• Dynacast
• Simulcast
• Hardware video enc/dec
  • NvEnc for Windows
  • VideoToolbox for MacOS/iOS

Crates

• livekit-core: LiveKit protocol implementation
• livekit-utils: Shared utilities between our crates
• livekit-ffi: Bindings for other languages. use livekit-core.
• livekit-webrtc: Safe Rust bindings to libwebrtc
• webrtc-sys: Unsafe bindings to libwebrtc

Motivation and Design Goals

At LiveKit, we've developed a number of client SDKs for different platforms. This is necessary to our goal of providing an end-to-end WebRTC stack that works everywhere. However, we've encountered a few challenges during this process:

• There's significant of business/control logic with our signaling protocol and WebRTC. Currently they are re-written for each platform that we support.
• Interactions with media devices and encoding/decoding are platform and framework specific.
• Doing both of the above for multi-platform frameworks (like Unity, Flutter, and React-Native) proved to be extremely painful.

We would like this SDK to:

• Encapsulate all of the business logic and platform-specific APIs into a clean set of abstractions
• Be a standalone cross-platform, native SDK for Rust and C/C++
• Serve as a common core for other platform-specific SDKs (i.e. Unity, iOS, Android)

Getting started

Tokio is required to use the SDK, we have plan to make the async executor agnostic

Connecting to a Room and listen to events:

#[tokio::main]
async fn main() -> Result<()> {
   let (room, room_events) = Room::connect(&url, &token).await?;

   while let Some(event) = room_events.recv().await {
      match event {
         RoomEvent::TrackSubscribed { track, publication, participant } => {
            // ...
         }
         _ => {}
      }
   }

   Ok(())
}

Receive video frames of a subscribed track

match event {
   RoomEvent::TrackSubscribed { track, publication, participant } => {
      if let RemoteTrackHandle::Video(video_track) => {
          let rtc_track = video_track.rtc_track();
          rtc_track.on_frame(Box::new(move |frame, buffer| {
              // Just received a video frame!
              // The buffer is YuvEncoded, you can decode it to ABGR by using our yuv_helper
              // See the simple_room example for the conversion
          });
      } else {
          // Audio Track..
      }
   }
   _ => {}
}

Examples

We made simple room demo using all features of the SDK. We render videos using wgpu and egui.