Skip to content
Live Streaming

Configuration reference

The main VoxeraLiveRoomConfig fields.

VoxeraLiveRoom

ParameterRequiredDescription
appIdYesYour App ID
appKeyYesYour publishable App Key
userIdYesThe local user's identity
userNameYesThe local user's display name
roomIdYesThe room to join or create
roomOwnerIdYesThe owner's identity. Only the owner joins as host.
configNoA VoxeraLiveRoomConfig
controllerNoAn existing VoxeraRoomController
tokenProviderNoA function returning a prefetched token
tokenBaseUrl, engineBaseUrlNoOnly for a different deployment

adminIds is an older way to name moderators, which the owner promotes after they join. Use controller.assignAdmin instead. See Moderators.

VoxeraLiveRoomConfig

Stage and camera

FieldDefaultDescription
maxGuestTiles3How many co-publisher tiles to draw. It's a UI limit, and the stage itself is uncapped.
autoHostCamerafalsePublishes on connect, instead of showing a preview and Go Live
showGoLiveButtontrueShows the built-in button. Turn it off to call VoxeraMediaController.goLive yourself.
frontCameraOnJoinStarts on the front camera
mirrorLocalVideoMirrors the local preview
hostFit, guestFitHow video fits its tile
videoQualityhdSee Video quality
roomMusicModetrackSee Room music

PK

FieldDescription
pkConfigThe PK layout, start sheet and slot builders. null turns PK off. See PK battles.

Overrides

headerWidget, messagesWidget, controlsBarWidget, foregroundWidget, hostTileBuilder, guestTileBuilder, guestTileFooterBuilder and onStageTap each replace one part of the UI.