Skip to Content
LYNKORIADocs

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 audience

The 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.

On this page