utd_live_room_kit 1.3.0

LiveKit-based video live room for Flutter: host camera plus up to three guest tiles, go-live requests, host media control, chat, and minimize/PiP.

UTD Live Room Kit

A Flutter package for building video live-room experiences, powered by LiveKit and the UTD Stream Engine. It puts a host camera on stage with up to 3 guest video tiles, built on the same seat state machine as utd_audio_room_kit — give it the required data and you get a fully interactive live room with no extra UI code.

Features

• Drop-in live-room UI — host camera + up to 3 guest video tiles from required data alone.
• Go-live flow — host invites guests; audience requests to go live; host approves/rejects with a live request queue.
• Host force-control — host can mute/unmute or stop a guest's camera/mic.
• Seat management — take, leave, switch, lock, unlock, kick (shared seat state machine with the audio kit).
• Media controls — microphone & camera with reactive state (Bluetooth-preferring audio routing).
• Real-time chat — data-channel messages with batching and dedup.
• Reconnection — tiered: light sync (<15s), full sync (<60s), default force-exit (>60s).
• Minimize / PiP — minimize to a floating overlay; optional Android OS Picture-in-Picture.
• Video effects — pairs with utd_video_effects_kit via UTDLiveRoomConfig.buildVideoProcessor (a LiveKit TrackProcessor) for live filters & beauty effects.

Getting started

Add the dependency:

dependencies:
  utd_live_room_kit: ^1.0.0

Credentials — pass your appKey (no backend required)

Ship appId + appKey (the project's publishable app key, from the UTD console). The kit mints tokens directly from the engine with X-App-Key; the engine signs the returned per-user user_token with the project server_secret server-side, so the secret never ships in the app. The kit uses that user_token as the Authorization: Bearer for all in-room calls. No token server to stand up. appKey can't sign tokens or call the S2S API and rotates on its own.

import 'package:utd_live_room_kit/utd_live_room_kit.dart';

UTDLiveRoom(
  appId: '<utd-app-id>',
  appKey: '<utd-app-key>', // publishable; the kit mints tokens itself, no backend needed
  userId: 'user123',
  userName: 'Jane',
  roomId: 'room456',
  roomOwnerId: 'owner789',
  config: const UTDLiveRoomConfig(),
);

See the exported API in lib/utd_live_room_kit.dart — UTDLiveRoom, UTDRoomController, SeatController, MediaController, ChatController, and the room/seat/participant models.

Requirements

• A LiveKit server + UTD Stream Engine token endpoint.
• Camera & microphone runtime permissions (handled via permission_handler).