applooma_rtc_core library

Classes

ActiveSpeakersChangedEvent
Active speakers changed. List of speakers are ordered by their audio level. loudest speakers first. This will include the LocalParticipant too.
AdaptiveStreamPixelDensity
Controls how a video view's logical size is scaled to physical pixels when computing adaptive-stream dimensions. Mirrors the JS SDK's pixelDensity option (number | 'screen').
Agent
Represents a LiveKit Agent.
AgentAttributes
AgentTranscript
A transcript emitted by the agent.
AndroidAudioSessionConfiguration
Experimental: this API may change in a future release.
AppleAudioSessionConfiguration
Experimental: this API may change in a future release.
AudioCaptureOptions
Options used when creating a LocalAudioTrack.
AudioEncoding
A type that represents audio encoding information.
AudioEngineAvailability
Whether the WebRTC audio engine is allowed to run, per direction.
AudioEngineState
Snapshot of the WebRTC audio engine's playout/recording state.
AudioFrame
A single frame of raw PCM audio data.
AudioManager
Controls LiveKit's process-wide platform audio behavior.
AudioOutputOptions
AudioPlaybackStatusChanged
AudioProcessingComponentRequest
The caller's request for one audio processing component: enabled flag plus implementation mode.
AudioProcessingComponentState
Diagnostic state of one audio processing component (echo cancellation, noise suppression, auto gain control or high-pass filter), observed at three stages of one pipeline: requested (caller intent) -> resolved (the engine's per-path decision) -> active (live truth), with effective as the merged verdict.
AudioProcessingOptions
Runtime voice-processing options for a LocalAudioTrack.
AudioProcessingState
Diagnostic snapshot of the resolved audio processing state for the shared audio processing module.
AudioProcessorOptions
AudioPublishOptions
Options used when publishing audio.
AudioReceiverStatsEvent
AudioRendererOptions
Options for configuring audio frame capture format.
AudioSenderStatsEvent
AudioSessionOptions
Experimental: this API may change in a future release.
AudioVisualizer
AudioVisualizerEvent
AudioVisualizerOptions
BackupVideoCodec
BaseKeyProvider
BaseStreamInfo
BaseStreamReader<T extends BaseStreamInfo, U>
BaseStreamWriter<T, InfoType extends BaseStreamInfo>
BrowserVersion
ByteStreamInfo
ByteStreamReader
ByteStreamWriter
CachingTokenSource
A token source that caches credentials from any TokenSourceConfigurable using a configurable store.
CameraCaptureOptions
Options used when creating a LocalVideoTrack that captures the camera.
CertificateBytes
Certificate bytes with an explicit PEM or DER encoding.
CertificatePinningOptions
Certificate pinning configuration for SDK-owned native TLS connections.
CertificatePinningRule
A set of accepted certificate checks for one or more host patterns.
ChatMessage
Checker
Base class for a single connection diagnostic, a Dart port of the Checker class from client-sdk-js' ConnectionCheck utility.
CheckerOptions
Options shared by all Checkers of a ConnectionCheck run.
CheckerUpdateEvent
Emitted by a Checker whenever its state changes (status change or a new log entry).
CheckInfo
A snapshot of a Checker's state.
CheckLog
A single log line produced while a Checker runs.
ConnectionCheck
Utility to diagnose connection issues with a LiveKit server, a Dart port of the ConnectionCheck helper from client-sdk-js.
ConnectionCheckUpdateEvent
Emitted by ConnectionCheck whenever the state of one of its checks changes (status change or a new log entry).
ConnectOptions
Options used when connecting to the server.
CustomTokenSource
A custom token source that executes provided logic to fetch credentials.
DataReceivedEvent
Data received from RemoteParticipant. Data packets provides the ability to use LiveKit to send/receive arbitrary payloads. Emitted by Room and RemoteParticipant.
DataStreamController<T extends DataStream_Chunk>
DevelopmentTokenSource
A token source that queries LiveKit's development token server for development and testing.
E2EEManager
E2EEOptions
EndpointTokenSource
A token source that fetches credentials via HTTP requests from a custom backend.
EventsEmitter<T>
EventsListenable<T>
EventsListener<T>
FastConnectOptions
This will enable the local participant to publish tracks on connect, instead of having to explicitly publish them. Defaults to false for all three tracks: microphone, camera, and screen. You can also create LocalAudio/VideoTrack on your PreJoin page (preview camera or select audio device), Automatically publish these tracks after the room is connected.
Hardware
InMemoryTokenStore
A simple in-memory store implementation for token caching.
KeyInfo
KeyProvider
LiteralTokenSource
A token source that provides a fixed set of credentials without dynamic fetching.
LiveKitClient Room
Main entry point to connect to a room.
LiveKitJwtPayload
Parsed payload for a LiveKit-issued JWT.
LiveKitVideoGrant
LiveKit-specific video grants embedded within a JWT.
LocalAudioTrack
LocalParticipant
Represents the current participant in the room. Instance of LocalParticipant is automatically created after successfully connecting to a Room and will be accessible from Room.localParticipant.
LocalTrack
Base class for LocalAudioTrack and LocalVideoTrack.
LocalTrackOptions
Base class for track options.
LocalTrackPublication<T extends LocalTrack>
A TrackPublication which belongs to the LocalParticipant.
LocalTrackPublishedEvent
When the local participant publishes a new Track to the room. Emitted by Room and LocalParticipant.
LocalTrackSubscribedEvent
LocalTrackUnpublishedEvent
The local participant has unpublished one of their Track. Emitted by Room and LocalParticipant.
LocalVideoTrack
A video track from the local device. Use static methods in this class to create video tracks.
MediaDevice
MessageReceiver
Receives messages produced by the agent.
MessageSender
Sends messages to the agent.
NetworkOptions
Options for SDK-owned network requests.
Participant<T extends TrackPublication<Track>>
Represents a Participant in the room, notifies changes via delegates as well as ChangeNotifier/providers. A change notification is triggered when
ParticipantAttributesChanged
Participant's attributes have changed. Emitted by Room.
ParticipantConnectedEvent
When a new RemoteParticipant joins after the current participant has connected It will not fire for participants that are already in the room Emitted by Room.
ParticipantConnectionQualityUpdatedEvent
Pariticpant's ConnectionQuality has updated. Emitted by Room and Participant.
ParticipantDisconnectedEvent
When a RemoteParticipant leaves the room Emitted by Room.
ParticipantMetadataUpdatedEvent
Participant metadata is a simple way for app-specific state to be pushed to all users. When RoomService.UpdateParticipantMetadata is called to change a Participant's state, all Participants in the room will fire this event. Emitted by Room and Participant.
ParticipantNameUpdatedEvent
ParticipantPermissions
ParticipantPermissionsUpdatedEvent
The ParticipantPermissions updated for the Participant. Currently, only for LocalParticipant. Emitted by Room and LocalParticipant.
ParticipantStateUpdatedEvent
ParticipantTrackPermission
PerformRpcParams
PreConnectAudioBuffer
Captures and buffers microphone audio before a room connection completes.
PreConnectAudioBufferStartedEvent
Pre-connect audio buffer has started recording. Emitted by Room.
PreConnectAudioBufferStoppedEvent
Pre-connect audio buffer has stopped recording. Emitted by Room.
ProcessorOptions<T extends TrackType>
ProtocolStats
Aggregated upstream statistics gathered while publishing over a single connection protocol.
PublishOptions
ReceivedMessage
A message received from the agent.
ReceivedMessageContent
Base class for message content types that can be received from the agent.
RegionStats
Connection statistics for a single LiveKit Cloud region.
RemoteAudioTrack
RemoteParticipant
Represents other participant in the Room.
RemoteTrack
RemoteTrackPublication<T extends RemoteTrack>
Represents a track publication from a RemoteParticipant. Provides methods to control if we should subscribe to the track, and its quality (for video).
RemoteVideoTrack
Room Room
Room is the primary construct for LiveKit conferences. It contains a group of Participants, each publishing and subscribing to Tracks. Notifies changes to its state via two ways, by assigning a delegate, or using it as a provider. Room will trigger a change notification update when
RoomAgentDispatch
Configuration for dispatching an agent to a room.
RoomAttemptReconnectEvent
report the number of attempts to reconnect to the room.
RoomConfiguration
Configuration for a LiveKit room.
RoomConnectedEvent
RoomDisconnectedEvent
Disconnected from the room Emitted by Room.
RoomMetadataChangedEvent
Room metadata has changed. Emitted by Room.
RoomMovedEvent
Fired when the participant has been moved to a different room by the server. Emitted by Room.
RoomOptions Room
Options used to modify the behavior of the Room.
RoomReconnectedEvent
Connection to room is re-established. All existing state is preserved. Emitted by Room.
RoomReconnectingEvent
When the connection to the server has been interrupted and it's attempting a full reconnect (peer connections are reset, media is interrupted). Emitted by Room.
RoomRecordingStatusChanged
Room recording status has changed. Emitted by Room.
RoomResumingEvent
When the signal connection has been interrupted and it's attempting to resume. Peer connections remain active during this type of reconnect. Emitted by Room.
RpcInvocationData
RTCConfiguration
RTCIceServer
SandboxTokenSource
A token source that queries LiveKit's sandbox token server for development and testing.
ScreenSelectDialog
ScreenShareCaptureOptions
Options used when creating a LocalVideoTrack that captures the screen.
SendFileOptions
SendTextOptions
SentMessage
A message sent to the agent.
SentMessageContent
Base class for message content types that can be sent to the agent.
SentUserInput
User-provided text input.
Session
A Session represents a connection to a LiveKit Room that can contain an agent.
SessionError
Represents an error that occurred during a Session.
SessionOptions
Options for creating a Session.
SimulcastTrackInfo
SpeakingChangedEvent
The participant's isSpeaking property has changed Emitted by Participant.
StreamBytesOptions
StreamTextOptions
StreamWriter<T>
TextMessageSender
Sends text messages to the agent and emits a loopback message so the UI can reflect the user's input immediately.
TextStreamInfo
TextStreamReader
TextStreamWriter
ThumbnailWidget
ThumbnailWidgetState
Timeouts
TokenRequestOptions
Request parameters for generating connection credentials.
TokenSourceConfigurable
A token source that provides configurable options for room, participant, and agent parameters.
TokenSourceFixed
A token source that returns a fixed set of credentials without configurable options.
TokenSourceRequest
The JSON serializable format of the request sent to standard LiveKit token servers.
TokenSourceResponse
Response containing the credentials needed to connect to a LiveKit room.
TokenStore
Protocol for storing and retrieving cached token credentials.
TokenStoreItem
A tuple containing the request options and response that were cached.
Track
Wrapper around a MediaStreamTrack with additional metadata. Base for AudioTrack and VideoTrack, can not be instantiated directly.
TrackE2EEStateEvent
The E2EEState on the track. Emitted by E2EEManager.
TrackMutedEvent
A Participant has muted one of the tracks. Emitted by RemoteParticipant and LocalParticipant.
TrackOption<E extends Object, T extends Object>
TrackProcessor<T extends ProcessorOptions<TrackType>>
TrackProcessorUpdateEvent
TrackPublication<T extends Track>
Represents a track that's published to the server. This class contains metadata associated with tracks.
TrackPublishedEvent
When a new Track is published to Room after the current participant has joined. It will not fire for tracks that are already published. Emitted by Room and RemoteParticipant.
TrackStreamStateUpdatedEvent
The StreamState on the RemoteTrackPublication has updated by the server. See RemoteTrackPublication.streamState for more information. Emitted by Room and RemoteParticipant.
TrackSubscribedEvent
LocalParticipant has subscribed to a new track published by a RemoteParticipant. Emitted by Room and RemoteParticipant.
TrackSubscriptionExceptionEvent
An error has occurred during track subscription. Emitted by Room and RemoteParticipant.
TrackSubscriptionPermissionChangedEvent
One of subscribed tracks have changed its permissions for the current participant. If permission was revoked, then the track will no longer be subscribed. If permission was granted, a TrackSubscribed event will be emitted.
TrackUnmutedEvent
This participant has unmuted one of their tracks Emitted by RemoteParticipant and LocalParticipant.
TrackUnpublishedEvent
The participant has unpublished one of their Track. Emitted by Room and RemoteParticipant.
TrackUnsubscribedEvent
The LocalParticipant has unsubscribed from a track published by a RemoteParticipant. This event is fired when the track was unpublished. Emitted by Room and RemoteParticipant.
TranscriptionAttributes
TranscriptionEvent
Transcription event received from the server.
TranscriptionSegment
TranscriptionStreamReceiver
Converts LiveKit transcription text streams into ReceivedMessages.
UserInput
A message that originated from user input (loopback).
UserTranscript
A transcript emitted for the user (e.g., speech-to-text).
ValueOrAbsent<T>
Distinguishes an omitted copy value from an explicit replacement value.
VideoCaptureOptions
Base class for options when creating a LocalVideoTrack.
VideoDimensions
A simple class that represents dimensions of video.
VideoEncoding
A type that represents video encoding information.
VideoParameters
VideoProcessorOptions
VideoPublishOptions
Options used when publishing video.
VideoReceiverStatsEvent
VideoSenderStatsEvent
VideoTrackRenderer
Widget that renders a VideoTrack.
WritableStream<T>

Enums

AgentFailure
Describes why an Agent failed to connect.
AgentInput
AgentOutput
AgentState
AndroidAudioAttributesContentType
Experimental: this API may change in a future release.
AndroidAudioAttributesUsageType
Experimental: this API may change in a future release.
AndroidAudioFocusMode
Experimental: this API may change in a future release.
AndroidAudioMode
Experimental: this API may change in a future release.
AndroidAudioStreamType
Experimental: this API may change in a future release.
AppleAudioCategory
Experimental: this API may change in a future release.
AppleAudioCategoryOption
Experimental: this API may change in a future release.
AppleAudioMode
Experimental: this API may change in a future release.
AudioFormat
PCM sample format for audio frame capture.
AudioProcessingFailureReason
Reason that applying AudioProcessingOptions failed.
AudioProcessingImplementation
The implementation in effect for an audio processing component.
AudioProcessingMode
Selects whether a voice-processing component uses platform or software processing.
AudioSessionManagementMode
Experimental: this API may change in a future release.
BrowserType
CameraExposureMode
CameraFocusMode
CameraPosition
A type that represents front or back of the camera.
CertificateBytesEncoding
Encoding for certificate bytes used by certificate pinning rules.
CheckLogLevel
Severity of a single CheckLog entry.
CheckProtocol
Connection protocols compared by the connection protocol check.
CheckStatus
Status of a Checker.
ClientProtocolVersion
Client-to-client protocol version advertised in ParticipantInfo.clientProtocol and the client_protocol join URL query parameter. Governs peer-to-peer feature negotiation; distinct from ProtocolVersion, which tracks the signaling protocol.
ConnectionErrorReason
ConnectionQuality
Connection quality between the Participant and server.
ConnectionState
Connection state type used throughout the SDK.
DegradationPreference
DisconnectReason
The reason a participant was disconnected from the room.
E2EEState
EncryptionType
LoggerLevel
MicrophoneMuteMode
Strategy used to mute microphone input on iOS/macOS.
ParticipantKind
The type of participant.
ParticipantState
Represents the state of a participant in the room.
PlatformType
Priority
Priority levels for RTP encoding parameters.
ProtocolVersion
Protocol version to use when connecting to server. Usually it's not recommended to change this.
Reliability
Reliability used for publishing data through data channel.
RTCIceTransportPolicy
The iceTransportPolicy used for RTCConfiguration. See https://developer.mozilla.org/en-US/docs/Web/API/RTCPeerConnection/RTCPeerConnection
SessionErrorKind
StreamState
The state of track data stream. This is controlled by server to optimize bandwidth.
TextStreamOperationType
Operation types for text streams
TrackSource
TrackSubscribeFailReason
The reason why a track failed to publish.
TrackSubscriptionState
TrackType
The type of track.
VideoQuality
Video quality used for publishing video tracks.
VideoRenderMode
VideoViewFit
VideoViewMirrorMode

Mixins

AudioTrack
Used to group LocalAudioTrack and RemoteAudioTrack.
CheckerEvent
Base type for events emitted by a Checker.
ConnectionCheckEvent
Base type for events emitted by ConnectionCheck.
EngineEvent
Base type for all Engine events.
EventsEmittable<T>
InternalEvent
Base type for internal-only events.
LiveKitEvent
Base type for all LiveKit events.
ParticipantEvent
Base type for all Participant events.
ReconnectingEvent
Base type for reconnecting events. Listen for this type to handle both full reconnects and signal-only reconnects.
RoomEvent
Base type for all Room events.
SignalEvent
Base type for all SignalClient events.
TrackEvent
Base type for all Track events.
VideoTrack
Used to group LocalVideoTrack and RemoteVideoTrack.

Constants

defaultDiscardFrameWhenCryptorNotReady → const bool
defaultFailureTolerance → const int
defaultKeyRingSize → const int
defaultMagicBytes → const String
defaultRatchetSalt → const String
defaultRatchetWindowSize → const int
kRpcAttrMethod → const String
kRpcAttrRequestId → const String
Attribute keys used on RPC v2 request streams.
kRpcAttrResponseTimeoutMs → const String
kRpcAttrVersion → const String
kRpcRequestTopic → const String
Data stream topic for RPC v2 requests.
kRpcRequestVersionV2 → const String
Value sent in the kRpcAttrVersion attribute for v2 requests.
kRpcResponseTopic → const String
Data stream topic for RPC v2 success responses.
kStreamChunkSize → const int

Properties

backupCodecs → List<String>
final
kRpcMaxPayloadBytes → int
Maximum payload size for RPC v1 requests and responses. When the remote participant supports RPC v2 (ClientProtocolVersion.v1 or higher), payloads of any size are allowed because they are transported over data streams.
final
kRpcVersion → int
RPC v1 wire version, sent in the RpcRequest.version packet field.
final
kRpcVesion → int
Misspelled alias for kRpcVersion. Kept for backwards compatibility with code that referenced the original typo.
final
logger → Logger
final
videoCodecs → List<String>
final

Functions

agentAttributesFromJson(String source) → AgentAttributes
agentAttributesToJson(AgentAttributes value) → String
createVisualizer(AudioTrack track, {AudioVisualizerOptions? options}) → AudioVisualizer
disableLogging() → void
disable logging
getDefaultDegradationPreference(TrackSource source) → DegradationPreference
Returns the degradation preference to use for a video track published under source, when the application did not set one explicitly.
getLoggingLevel() → Level
get the current logging level
isBackupCodec(String codec) → bool
isChrome129OrLater() → bool
isResponseExpired(TokenSourceResponse response, {Duration tolerance = const Duration(seconds: 60), DateTime? currentTime}) → bool
Validates whether the JWT token in the response is expired or invalid.
lkBrowser() → BrowserType
lkBrowserVersion() → BrowserVersion
lkPlatform() → PlatformType
lkPlatformIs(PlatformType type) → bool
lkPlatformIsApple() → bool
lkPlatformIsDesktop() → bool
lkPlatformIsMobile() → bool
lkPlatformIsTest() → bool
lkPlatformIsWebMobile() → bool
lkPlatformSupportsE2EE() → bool
lkPlatformSupportsExplicitAudioRecordingStart() → bool
setLoggingLevel(LoggerLevel level) → void
set the logging level
skipStopForTrackMute() → bool
skips stop/replaceTrack for the following platforms and only toggles track.enabled.
transcriptionAttributesFromJson(String source) → TranscriptionAttributes
transcriptionAttributesToJson(TranscriptionAttributes value) → String

Typedefs

AudioFrameCallback = void Function(AudioFrame frame)
Callback for receiving audio frames.
ByteStreamHandler = void Function(ByteStreamReader reader, String participantIdentity)
CancelListenFunc = Future<void> Function()
CustomTokenFunction = Future<TokenSourceResponse> Function(TokenRequestOptions options)
Function signature for custom token generation logic.
PreConnectOnError = void Function(Object error)
RpcRequestHandler = Future<String> Function(RpcInvocationData data)
TextStreamHandler = dynamic Function(TextStreamReader reader, String participantIdentity)
TokenValidator = bool Function(TokenRequestOptions options, TokenSourceResponse response)
A validator function that determines if cached credentials are still valid.

Exceptions / Errors

AudioProcessingException
Thrown when AudioProcessingOptions cannot be applied.
AudioSessionException
The platform audio session could not be configured for, or does not permit, the requested audio operation (iOS; macOS has no audio session, so engine failures there keep their generic error codes). Common reasons:
CertificatePinningException
Certificate pinning validation failed for an SDK-owned TLS connection.
CheckException
Exception thrown when a check cannot complete.
ConnectException
An exception occurred while attempting to connect. Common reasons:
DataPublishException
Failed to publish data. Common reasons:
LiveKitE2EEException
An exception for End to End Encryption.
LiveKitException
Base class for Exceptions thrown by the LiveKit SDK
MediaConnectException
An exception occurred while attempting to disconnect. Common reasons:
NegotiationError
Exception thrown when pc negotiation fails.
RpcError
TimeoutException
A certain time has passed while attempting to execute an operation.
TokenSourceHttpException
Error thrown when the token server responds with a non-success HTTP status code.
TrackCreateException
Failed to create a local track. Common reasons:
TrackPublishException
Failed to publish a local track. Common reasons:
UnexpectedConnectionState
UnexpectedStateException
An internal state of the SDK is not correct and can not continue to execute. This should not occur frequently.