Livestreaming
Let hosts and speakers broadcast to a large audience of viewers who can watch but not publish.
A livestream is a call with type: 'livestream'. Hosts and speakers publish audio and video; viewers subscribe only. Enable both Calls and Livestreaming for the environment in the console.
Start a stream
const stream = await lynkoria.calls.create({
productCallId: `live-${eventId}`,
type: 'livestream',
maxParticipants: 500, // hosts, speakers and viewers together
});
// The broadcaster
const hostToken = await lynkoria.calls.joinToken({
callId: stream.id,
userId: host.id,
deviceId,
displayName: host.name,
role: 'host',
});
// Everyone watching
const viewerToken = await lynkoria.calls.joinToken({
callId: stream.id,
userId: viewer.id,
deviceId,
displayName: viewer.name,
role: 'viewer',
});On the client, join exactly like a normal call. Viewer tokens cannot publish: calling setMicrophoneEnabled(true) or setCameraEnabled(true) as a viewer is rejected by the media server, so hide those controls for viewers.
Bring a viewer on stage
Only your backend can change roles. After your own checks (for example, the host approved a raised hand):
await lynkoria.calls.setRole(stream.id, viewerIdentity, 'speaker'); // can now publish
await lynkoria.calls.setRole(stream.id, viewerIdentity, 'viewer'); // back to the audienceThe participant keeps their connection; their permissions update in place.
Show only the people on stage
Render tracks without placeholders so the audience does not appear as empty tiles:
import { useTracks } from '@livekit/components-react';
import { Track } from 'livekit-client';
const tracks = useTracks(
[
{ source: Track.Source.Camera, withPlaceholder: false },
{ source: Track.Source.ScreenShare, withPlaceholder: false },
],
{ onlySubscribed: false },
);Show a waiting state while tracks is empty.
Live chat and reactions
LiveKit data messages are disabled. For stream chat, create a Lynkoria conversation for the event and add viewers as members from your backend; see messaging.
Limits
- Viewers and publishers both count toward the room size.
- There is no recording, HLS or CDN delivery in v1: every viewer is a realtime WebRTC participant.
- Large audiences (hundreds of viewers) are a staging benchmark target, not a measured guarantee. See platform status.