iOS Core SDK

2026-06-24

RealtimeKit iOS Core 3.0.0

Breaking changes

Plugins are no longer provided by the server. They must now be declared upfront on the client side by passing a plugins list to RtkMeetingInfo. Any plugin not declared at initialization will not be available in the meeting.

let meetingInfo = RtkMeetingInfo(
  authToken: authToken,
  plugins: [
    RtkClientPluginConfig(
      id: "whiteboard", // Must match the plugin ID used on Web for sync to work
      name: "Whiteboard",
      url: "https://example.com",
      icon: "https://example.com/logo.png",
      permissions: RtkClientPluginPermissions(canActivate: true, canDeactivate: false)
    )
  ]
)

Several internal properties have been removed from RtkPlugin: baseURL, config, description, isPrivate, and staggered. Use the new icon and permissions properties instead.
baseUrl in RtkMeetingInfo now has a default value and no longer needs to be passed explicitly.
The two-argument subscribe(key:listener:) and unsubscribe(key:listener:) overloads on RtkStore that passed both the key and value to the callback have been removed. Use the single-argument callback variants introduced in 2.1.0.

Features

AI Transcription — A new RtkAi class (exposed as client.ai) provides access to real-time transcripts. Implement RtkAiEventListener and register it with addAiEventListener(_:) to receive onTranscript(data:) callbacks. A transcriptionEnabled permission is available on MiscellaneousPermissions.
Connected Meetings (Breakout Rooms) — A new RtkConnectedMeetings class (exposed as client.connectedMeetings) enables breakout room workflows. Register an RtkConnectedMeetingsEventListener to handle room transitions and state updates. See the Breakout Rooms documentation for a full guide.
Chat: Edit and Delete — Messages can now be edited and deleted. New methods on RtkChat: editTextMessage(messageId:newText:onResult:), editImageMessage(messageId:newUri:onResult:), editFileMessage(messageId:newUri:onResult:), and deleteMessage(messageId:onResult:). RtkChatEventListener gains onMessageEdited(message:) and onMessageDeleted(messageId:) callbacks. ChatMessage now includes an isEdited flag.
Chat: Fetch and Pagination — New methods on RtkChat — fetchPublicMessages(beforeTimestamp:count:onlyPinned:onResult:), fetchPrivateMessages(userId:beforeTimestamp:count:onlyPinned:onResult:), fetchPinnedMessages(beforeTimestamp:count:onlyPinned:onResult:), and getMessages(timestamp:count:channelId:isPinned:onResult:) — allow fetching historical messages with cursor-based pagination via FetchMessagesResult(messages:hasMore:).
Client-Declared Plugins — Plugins are now configured entirely on the client via RtkClientPluginConfig and RtkClientPluginPermissions. RtkPlugin exposes the new icon and permissions properties accordingly.
Targeted Broadcast Messages — RtkParticipants.broadcastMessage(message:targetParticipantIds:payload:) sends a message to a specific subset of participants.
Nullable Store Values — RtkStore.set(key:value:broadcast:persist:) now accepts a nullable value: Any?, allowing keys to be cleared by setting them to nil.
Logging Control — RealtimeKitClient gains enableLogging(_:) and enableLogging(_:minSeverity:) to control SDK log output at runtime.
Result_ Utility Type — A new Result_<S, F> type with Success and Failure variants is used consistently across new async APIs. It is named Result_ to avoid collision with Swift's built-in Result type.

Fixes

Improved reconnection handling to ensure media recovers gracefully in more scenarios
Fixed potential UI hangs by dispatching audio route change observer off the main thread
Improved simulcast tiers to broadcast at a wider range of qualities on higher tiers
Fixed some races in media handling causing mute/unmute operations to rarely result in a crash
Optimized API calls in the room join flow to speed up first join durations
Fixed file and image uploads in chat failing under some conditions

2026-05-08

RealtimeKit iOS Core 2.1.0

Breaking changes

RtkParticipants.activeSpeaker → RtkParticipants.lastActiveSpeaker. The old activeSpeaker property is deprecated and will be removed in a future release.
RtkSelfParticipant.enableScreenShare() → enableScreenShare(onResult:). The old no-callback version is deprecated and will be removed in a future release.
RtkSelfParticipant.disableScreenShare() → disableScreenShare(onResult:). The old no-callback version is deprecated and will be removed in a future release.
RtkStore.subscribe(key, (key, value) → Unit) → subscribe(key, (value) → Unit). The old two-argument callback signature is deprecated but remains functional via a backward-compatible shim.
RtkStore.unsubscribe(key, (key, value) → Unit) → unsubscribe(key, (value) → Unit). The old two-argument callback signature is deprecated but remains functional via a backward-compatible shim.

Features

Added RtkChat.pin() and RtkChat.unpin() methods to pin and unpin chat messages
Added RtkChat.getMessagesByUser() to filter messages by sender and RtkChat.getMessagesByType() to filter messages by type
Added SelfPermissions.canPinMessage() to check whether the local participant has permission to pin messages

Fixes

Fixed recording state getting stuck as "recording" when stopping a recording that was started by another participant
Fixed "ghost" participants appearing on the grid when a user was on the setup screen but had not yet joined the socket room
Fixed webinar host being invisible to other participants when joining late
Fixed recording bots and other hidden participants incorrectly appearing on the participant grid
Fixed waitlisted participants appearing in the participant list before being admitted to the meeting

2026-04-20

RealtimeKit iOS Core 2.0.0

Breaking changes

Removed Hive SFU support. Only the Cloudflare SFU is supported going forward.
The default base URI is now realtime.cloudflare.com. Calling init() with a dyte.io base domain now fails immediately with MeetingError.InvalidBaseUrl

Fixes

Added compatibility with new backend plugins API field naming
Fixed a crash that could occur when accessing the socket controller before init() was called
Fixed auth token not being sent to the callstats collector endpoint
Removed custom ping-pong keepalive logic that was only required for the previous infrastructure

2026-02-06

RealtimeKit iOS Core 1.6.1

Fixes

Fixed media issues when connection took longer to establish

2026-01-14

RealtimeKit iOS Core 1.6.0

Fixes

Resolved crashes that occurred when uploading files
Improved grid transitions by activating consumers in batches for better performance
Moved consumer toggle requests off main thread to prevent UI blocking
Prevented race conditions by canceling reconnection attempts during initialization

2025-12-16

RealtimeKit iOS Core 1.5.7

Fixes

Fixed rare crash when toggling audio mute
Off-stage webinar hosts no longer show up on the grid

2025-12-12

RealtimeKit iOS Core 1.5.6

Fixes

Fixed deadlocks in webinar join and screenshare enable flows
Fixed an issue with camera not working when moving to settings screen and back
Fixed a rare crash in voice activity detection

2025-12-04

RealtimeKit iOS Core 1.5.5

Fixes

Fixed participant tiles not being removed properly when peers left the meeting
Resolved memory spikes when participants enable or toggle video
Improved video buffer management to prevent memory buildup
Enhanced iOS video rendering to match Android behavior

2025-11-06

RealtimeKit iOS Core 1.5.4

Fixes

Internal fixes to reduce telemetry verbosity
Fixed a minor memory leak

2025-10-23

RealtimeKit iOS Core 1.5.3

Fixes

Fixed a regression that caused self video to not render if meeting was joined with camera disabled

2025-10-23

RealtimeKit iOS Core 1.5.2

Fixes

Fixed unreliable grid behavior with improved refresh logic

2025-10-06

RealtimeKit iOS Core 1.5.1

Fixes

Internal fixes to resolve issues for Flutter platform

2025-09-23

RealtimeKit iOS Core 1.5.0

Features

Added RtkSelfEventListener#onAudioDeviceChanged method that is invoked when the current audio route is updated

Fixes

iOS no longer ignores audio device selection during initial join

2025-09-18

RealtimeKit iOS Core 1.4.1

Fixes

Speakerphone is now preferred over earpiece as the default audio output

2025-09-18

RealtimeKit iOS Core 1.4.0

Breaking changes

Updated RtkSelfEventListener#onAudioDevicesUpdated method to provide the list of available devices

Fixes

Fixed not being able to route audio to Bluetooth devices

2025-09-12

RealtimeKit iOS Core 1.3.4

Fixes

Fixed a rare crash during meeting joins in poor network scenarios

2025-09-12

RealtimeKit iOS Core 1.3.3

Fixes

Fixed pinned peers not being removed from the stage when kicked
Media consumers are now created in parallel, which significantly improved the speed of when users start seeing other people's audio/video after joining a meeting
Fixed "Ghost"/Invalid peers that would sometimes show up in long-running meetings
Fixed an issue in webinar meetings where the SDK would fail to produce media after being removed from the stage once

2025-08-13

RealtimeKit iOS Core 1.3.2

Enhancements

Fixed microphone not working when joining the stage in a webinar

2025-08-13

RealtimeKit iOS Core 1.3.1

Enhancements

Fixed a potential crash in poor network scenarios

2025-08-12

RealtimeKit iOS Core 1.3.0

Features

Added RtkSelfParticipant#canJoinStage and RtkSelfParticipant#canRequestToJoinStage APIs

Fixes

Fixed viewer unable to join stage in a Livestream
Fixed user unable to see existing pinned participant after joining meeting

2025-08-05

RealtimeKit iOS Core 1.2.0

Breaking changes

Renamed RtkLivestreamData.roomName to RtkLivestreamData.meetingId to match existing API convention
Removed obsolete WaitingRoomPermissions abstraction — all the relevant functionality here is available through HostPermissions
VideoDevice gained a cameraType: CameraType parameter
VideoDeviceType#displayName is now deprecated, and it's recommended to call VideoDevice#toString instead to get user-facing names for individual VideoDevice instances
Existing APIs related to middlewares were removed and replaced with equivalent counterparts from WebRTC: RtkSelfParticipant#addVideoMiddleware, RtkSelfParticipant#getVideoMiddlewares and RtkSelfParticipant#removeVideoMiddleware were removed. We do not support middlewares on iOS so these APIs were no-op and were incorrectly exposed.

Features

Reimplemented middlewares using WebRTC-native primitives to resolve intermittent crashes and other issues.
VideoDevice now properly labels multiple cameras based on their camera characteristics such as wide-angle and telephoto.

Fixes

Fixed screen share failing to start
Silenced log spam from our callstats library

2025-07-02

RealtimeKit iOS Core 1.1.0

Features

Active speakers support

Enhancements

Meeting initialization (meeting.init()) is now ~60% faster
Switched to an updated and RTK namespaced WebRTC

2025-06-20

RealtimeKit iOS Core 1.0.1

Breaking changes

Renamed RtkMessageType to ChatMessageType

Fixes

Silenced logspam from audio activity reporter
Improved speed of joining calls
Auth tokens now automatically trim invalid spaces and newlines

2025-05-26

RealtimeKit iOS Core 1.0.0

Breaking changes

Removed deprecated channelId field from TextMessage
Moved listener types to their respective feature package
Moved public listeners to their respective feature packages
Renamed plugin add-remove listener methods for RtkPluginsEventListener
Moved chat extensions to the chat package
Moved RtkParticipant to the root package
Moved RtkMeetingParticipant to the root package
Moved RtkPluginFile to the plugins package
Moved middlewares to their own package
Moved VideoScaleType to top level media package
Dropped Rtk prefix from audio and video device types
Moved device types to the top level media package
Dropped Rtk prefix from polls types
Replaced all LiveStream references with Livestream
Moved RtkMeetingParticipant to root package
Stripped Rtk prefix from RtkRecordingState
Stripped Rtk prefix from chat message types
Removed deprecated RtkLivestream#roomName field
Moved RtkMediaPermission to media package and renamed to MediaPermission
Redistributed feat package members
Moved StageStatus class to stage package
Renamed all event listeners to be of the singular *EventListener form

2025-05-16

RealtimeKit iOS Core 0.2.1

Fixes

Internal fixes to release pipeline

2025-05-16

RealtimeKit iOS Core 0.2.0

Fixes

Added audio activity detection for active speaker signaling

2025-05-14

RealtimeKit iOS Core 0.1.0

New APIs

Initial alpha release