Skip to Content
LYNKORIADocs

Group meetings

Size, moderate and lay out multi-party calls, and control how many devices a user can join with.

A group meeting is a call with type: 'group'. Everything in calls applies; this page covers what changes when more people join.

Size the room

const call = await lynkoria.calls.create({
  productCallId: `standup-${teamId}-${today}`,
  type: 'group',
  maxParticipants: 25,
});

maxParticipants is capped by the environment’s Max room size quota (2–1000, set in the console). The environment’s Concurrent rooms quota limits how many calls can be active at once. Exceeding either returns quota_exceeded.

Roles

Every participant in a group or one_to_one call joins with the default participant role and can publish audio, video and screen share. The host, speaker and viewer roles apply to livestreams only; requesting them for a group call returns bad_request. Decide in your own app which participants see organizer controls, and enforce those actions on your backend.

Moderation

Moderate from your backend, after checking that the requester is allowed to:

await lynkoria.calls.removeParticipant(call.id, identity); // identity = "project:user:device"
await lynkoria.calls.end(call.id); // end for everyone
await lynkoria.users.suspend(userId); // block the user across this environment

Removing a participant disconnects them, but a join token issued in the last 5 minutes could still be used to rejoin. For a hard ban, stop issuing tokens to that user (your authorization), and end and recreate the room if necessary.

One device per user

Turn on Single-device calls for the environment to make a new join remove the same user’s other devices from the room. Without it, a user can join from a laptop and a phone at once, each with its own identity. Two devices joining at the same moment with tokens minted earlier can still overlap briefly.

Layout tips

  • Use LiveKit’s GridLayout with useTracks([{ source: Track.Source.Camera, withPlaceholder: true }, { source: Track.Source.ScreenShare, withPlaceholder: false }]) to show everyone, including people with their camera off.
  • adaptiveStream and dynacast are enabled by default: hidden or small tiles receive lower-resolution video automatically.
  • useParticipants() and useIsSpeaking(participant) drive participant lists and active-speaker highlights.

Capacity targets (for example, very large meetings) have not been load-tested on production infrastructure. See platform status.

On this page