serenada-core/app.serenada.core/CallState

CallState

data class CallState(val phase: CallPhase = CallPhase.Idle, val roomId: String? = null, val localCid: String? = null, val isHost: Boolean = false, val participantCount: Int = 0, val callStartedAtMs: Long? = null, val localAudioEnabled: Boolean = true, val localVideoEnabled: Boolean = true, val localCameraEnabled: Boolean = true, val localContent: ParticipantContent? = null, val localDisplayName: String? = null, val localAudioLevel: Float = 0.0f, val remoteParticipants: List<RemoteParticipant> = emptyList(), val connectionStatus: ConnectionStatus = ConnectionStatus.Connected, val signalingState: SignalingState = SignalingState.Connected, val localCameraMode: LocalCameraMode = LocalCameraMode.SELFIE, val availableCameraModes: List<LocalCameraMode> = DEFAULT_CAMERA_MODES, val error: CallError? = null, val requiredPermissions: List<MediaCapability> = emptyList())

SDK-native call state. This is the primary observable state for SDK consumers. Does not include host-app concerns (saved rooms, settings, etc.).

Constructors

CallState

constructor(phase: CallPhase = CallPhase.Idle, roomId: String? = null, localCid: String? = null, isHost: Boolean = false, participantCount: Int = 0, callStartedAtMs: Long? = null, localAudioEnabled: Boolean = true, localVideoEnabled: Boolean = true, localCameraEnabled: Boolean = true, localContent: ParticipantContent? = null, localDisplayName: String? = null, localAudioLevel: Float = 0.0f, remoteParticipants: List<RemoteParticipant> = emptyList(), connectionStatus: ConnectionStatus = ConnectionStatus.Connected, signalingState: SignalingState = SignalingState.Connected, localCameraMode: LocalCameraMode = LocalCameraMode.SELFIE, availableCameraModes: List<LocalCameraMode> = DEFAULT_CAMERA_MODES, error: CallError? = null, requiredPermissions: List<MediaCapability> = emptyList())

Properties

availableCameraModes

val availableCameraModes: List<LocalCameraMode>

Camera modes the user can cycle through, in preference order. Derived from SerenadaConfig.cameraModes minus modes unsupported on this device. Empty means camera video is unavailable — call UIs should hide the camera video toggle.

callStartedAtMs

val callStartedAtMs: Long? = null

Wall-clock timestamp in milliseconds when the local participant joined this call.

connectionStatus

val connectionStatus: ConnectionStatus

Network connection status.

error

val error: CallError? = null

Current error, if any.

isHost

val isHost: Boolean = false

Whether the local user created this room.

localAudioEnabled

val localAudioEnabled: Boolean = true

Whether local audio is currently enabled.

localAudioLevel

val localAudioLevel: Float = 0.0f

Smoothed voice activity level (0..1) for the locally captured mic. Updated at ~10 Hz while the call is active; intended to drive UI activity indicators. Always 0 when localAudioEnabled is false.

localCameraEnabled

val localCameraEnabled: Boolean = true

Whether the local camera video specifically is enabled. In the current (flag-off) build this mirrors localVideoEnabled; once independent content video ships it tracks camera-active independently from screen share.

localCameraMode

val localCameraMode: LocalCameraMode

Current camera mode (selfie, world, or composite).

localCid

val localCid: String? = null

Local client identifier assigned by the server.

localContent

val localContent: ParticipantContent? = null

Local content (screen share) presentation state. Null when the local user is not sharing content.

localDisplayName

val localDisplayName: String? = null

Local participant display name, if set.