livekit-compose-components/io.livekit.android.compose.local

Package-level declarations

Composition locals to aid in development of Livekit features.

Properties

ParticipantLocal

val ParticipantLocal: ProvidableCompositionLocal<Participant>

Not to be confused with LocalParticipant.

RoomLocal

val RoomLocal: ProvidableCompositionLocal<Room>

TrackReferenceLocal

val TrackReferenceLocal: ProvidableCompositionLocal<TrackReference>

Functions

ForEachParticipant

@Composable

fun ForEachParticipant(participants: List<Participant>, content: @Composable (Participant) -> Unit)

A simple way to loop over participants that creates a ParticipantScope for each participant and calls content.

ForEachTrack

@Composable

fun ForEachTrack(tracks: List<TrackReference>, content: @Composable (TrackReference) -> Unit)

A simple way to loop over tracks that creates a TrackReferenceScope for each track and calls content.

HandleRoomState

@Composable

fun HandleRoomState(state: Room.State, passedRoom: Room? = null, vararg keys: Any, onState: suspend CoroutineScope.(Room, Room.State) -> Unit?)

@Composable

fun HandleRoomState(states: List<Room.State> = emptyList(), passedRoom: Room? = null, vararg keys: Any, onState: suspend CoroutineScope.(Room, Room.State) -> Unit?)

A simple handler for listening to room state changes.

ParticipantScope

@Composable

fun ParticipantScope(participant: Participant, content: @Composable () -> Unit)

rememberLiveKitRoom

@Composable

fun rememberLiveKitRoom(url: String? = null, token: String? = null, audio: Boolean = false, video: Boolean = false, connect: Boolean = true, roomOptions: RoomOptions? = null, liveKitOverrides: LiveKitOverrides? = null, connectOptions: ConnectOptions? = null, onConnected: suspend CoroutineScope.(Room) -> Unit? = null, onDisconnected: suspend CoroutineScope.(Room) -> Unit? = null, onError: (Room, Exception?) -> Unit? = null, passedRoom: Room? = null): Room

Remembers a new Room object.

requireParticipant

@Composable

fun requireParticipant(passedParticipant: Participant? = null): Participant

Returns the passedParticipant or the currently provided ParticipantLocal.

requireRoom

@Composable

fun requireRoom(passedRoom: Room? = null): Room

Returns the passedRoom or the currently provided RoomLocal.

requireTrack

@Composable

fun requireTrack(passedTrack: TrackReference? = null): TrackReference

Returns the passedTrack or the currently provided TrackReferenceLocal.

RoomScope

@Composable

fun RoomScope(url: String? = null, token: String? = null, audio: Boolean = false, video: Boolean = false, connect: Boolean = true, roomOptions: RoomOptions? = null, liveKitOverrides: LiveKitOverrides? = null, connectOptions: ConnectOptions? = null, onConnected: suspend CoroutineScope.(Room) -> Unit? = null, onDisconnected: suspend CoroutineScope.(Room) -> Unit? = null, onError: (Room, Exception?) -> Unit? = null, passedRoom: Room? = null, content: @Composable (room: Room) -> Unit)

Establishes a room scope which remembers a Room object which can be accessed through the RoomLocal composition local.

TrackReferenceScope

@Composable

fun TrackReferenceScope(trackRef: TrackReference, content: @Composable () -> Unit)

Binds trackRef to the TrackReferenceLocal for the scope of content.