Contact usRequest a demo

iOS mobile SDK release notes

This page contains the release notes for version 4 of the iOS mobile SDK. The release notes are broken down in sections to allow for easier consumption. Release notes are additive, which means that to cover all improvements between two defined release states, all individual release notes have to be considered.

The release notes of version 3 of the iOS mobile SDK are available in the documentation for Unblu 6.

The release notes of version 2 of the iOS mobile SDK are available in the documentation for Unblu 5.

You must update Unblu Spark before you update the Android mobile SDK. If you don’t, the SDK may not work properly.

The release notes for Unblu Spark and the Android mobile SDK are published separately.

iOS mobile SDK 4.11.0 release notes

Release date: 19 June 2025

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

New features and improvements

  • MSDKIOS#550 - Create document co-browsing module

iOS mobile SDK 4.10.1 release notes

Release date: 21 May 2025

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-543 - Add support for UnbluPreviewFileDownloadHandler in WebViewController and fix session delegation in executeTask

New features and improvements

  • MSDKIOS-542 - Use newly introduced track names for LiveKit publications

  • MSDKIOS-541 - Implement 2FA workflow by capturing and storing device ID from WKWebView cookies

iOS mobile SDK 4.10.0 release notes

Release date: 11 April 2025

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-539 - Support ICE server configuration when using LiveKit

New features and improvements

  • MSDKIOS-523 - Support 2FA in Unblu iOS mobile SDK

iOS mobile SDK 4.9.12 release notes

Release date: 21 March 2025

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-533 - Request visibility event not delegated if API uninitialized

  • MSDKIOS-534 - Audio calls mistakenly default to speaker

  • MSDKIOS-536 - Microphone initialization fails in LiveKit on iOS 15

New features and improvements

  • MSDKIOS-513 - Additional error types for when joining conversation fails

  • MSDKIOS-535 - Memory download handler with limited memory allocation

  • MSDKIOS-528 - Add in-memory download handler

iOS mobile SDK 4.9.9 release notes

Release date: 28 February 2025

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-525 - Bug coordinating video call handling on mobile and browser

New features and improvements

  • MSDKIOS-526 - Request audio & video permissions on demand

iOS mobile SDK 4.9.8 release notes

Release date: 21 January 2025

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Starting with version 4.9.8 of the iOS mobile SDK, WebRTC should be added using the Swift Package Manager (SwiftPM) instead of CocoaPods. Users relying on podfiles should migrate to SwiftPM.

Bugs

  • MSDKIOS-518 - Fix crash Symbol not found: swiftoverride_class_getSuperclass

  • MSDKIOS-519 - Floating audio/video active conversation indicator (ACI) appears after ending call

  • MSDKIOS-521 - Audio calls don’t connect after second attempt

New features and improvements

  • MSDKIOS-452 - Update to LiveKit v2

  • MSDKIOS-517 - Add function to pass authentication token to JavaScript

iOS mobile SDK 4.9.4 release notes

Release date: 05 December 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-511 - Front camera crashes on iPhones older than 6s

  • MSDKIOS-512 - iOS devices get hot during video calls

New features and improvements

  • MSDKIOS-508 - Increase min and max ratio constants

  • MSDKIOS-509 - Make Picture-in-Picture (PiP) video element border radius configurable

iOS mobile SDK 4.9.2 release notes

Release date: 07 November 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-504 - Assign dimensions to video container when no remote participant in call

  • MSDKIOS-506 - Own video stream displayed in Picture in Picture (PiP) mode when video UI open (Vonage Video API only)

New features and improvements

  • MSDKIOS-496 - Support targeted invitation & forwarding notifications

iOS mobile SDK 4.9.0 release notes

Release date: 17 October 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

New features and improvements

  • MSDKIOS-497 - add setvisitorData method

iOS mobile SDK 4.8.8 release notes

Release date: 30 September 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-495 - Incorrect display of dial-in status in local video zone

iOS mobile SDK 4.8.7 release notes

Release date: 04 September 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-490 - Profile picture not updated in Picture-in-Picture (PiP) mode after change

  • MSDKIOS-494 - Active conversation indicator (ACI) and swizzling in TouchEventProvider lead to crash

New features and improvements

  • MSDKIOS-491 - Make chevron size dependent on button size

  • MSDKIOS-492 - Integrate server-configured ACI and PiP element sizes in mobile SDK

iOS mobile SDK 4.8.6 release notes

Release date: 09 August 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

New features and improvements

  • MSDKIOS-489 - Don’t display initials on avatar when avatar image present

iOS mobile SDK 4.8.5 release notes

Release date: 24 July 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-486 - Changing avatar or badge removes shadow from ACI button

  • MSDKIOS-488 - Core API Stop function doesn’t work for agents

New features and improvements

  • MSDKIOS-487 - Sign LiveKit xcframeworks with new distribution certificate

iOS mobile SDK 4.8.4 release notes

Release date: 13 June 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-483 - Add support for authentication challenge handler to internal HTTP requests

New features and improvements

  • MSDKIOS-482 - Optimize video capture

  • MSDKIOS-484 - Close modal view when going back to conversation overview

iOS mobile SDK 4.8.3 release notes

Release date: 24 May 2024

Built with Xcode 15.3 (LiveKit module built with Xcode 14.2)

Bugs

  • MSDKIOS-478 - Back button doesn’t return after swiping down modal window

  • MSDKIOS-479 - Modal window layout breaks after camera UI is dismissed

  • MSDKIOS-481 - Sign all XCFrameworks with new distribution certificate

New features and improvements

  • MSDKIOS-356 - Improve small subscriber video view

  • MSDKIOS-436 - Increase area of capturing indicator frame

  • MSDKIOS-451 - Expose user-agent

  • MSDKIOS-475 - Adjust indicator placement for iOS keyboard overlap

  • MSDKIOS-353 - Picture-in-picture with multiple participants

  • MSDKIOS-472 - Deinitialize JavaScript before destroying WebView

iOS mobile SDK 4.8.0 release notes

Release date: 06 May 2024

Built with Xcode 15.3

Bugs

  • MSDKIOS-469 - Mobile co-browsing indicator stays on screen

New features and improvements

  • MSDKIOS-397 - Collapsed conversation indicator and custom Picture-in-Picture (PiP)

  • MSDKIOS-406 - New co-browsing button in accordance with new design guidelines

  • MSDKIOS-408 - Provide native Picture-in-Picture (PiP) capability

  • MSDKIOS-413 - Visualize dial-in state in call or mic volume if not dialed in

  • MSDKIOS-428 - Add a context menu to indicator

  • MSDKIOS-404 - Add possibility to go into modal presentation mode

  • MSDKIOS-424 - Use Collaboration Server configuration properties for mobile indicators

  • MSDKIOS-450 - Allow setting labels with Unblu iOS SDK

  • MSDKIOS-460 - Add API to retrieve list of conversations and events for it

  • MSDKIOS-461 - Add specific error types for PIN entry errors

  • MSDKIOS-470 - Provide additional protocol for mobile co-browsing indicator clicks

iOS mobile SDK 4.7.10 release notes

Release date: 09 February 2024

Built with Xcode 14.2

If you use the Unblu Swift packages with Xcode version 15.3, your app won’t pass verification in the Xcode cloud or the Swift packager manager (SPM). If possible, use Xcode 15.2 or older to build your app.

If you need a version of the Unblu Swift packages that can be verified with Xcode 15.3, contact the Unblu support team.

Bugs

  • MSDKIOS-380 - Call terminated in browser when call times out on mobile

  • MSDKIOS-448 - Audio and video stream not working correctly with LiveKit

New features and improvements

  • MSDKIOS-444 - Improve user agent version value

iOS mobile SDK 4.7.8 release notes

Release date: 05 December 2023

Built with Xcode 14.2

Bugs

  • MSDKIOS-442 - HTTP call reject request doesn’t work until API starts

New features and improvements

  • MSDKIOS-430 - Create client/server certificate authentication

iOS mobile SDK 4.7.7 release notes

Release date: 20 October 2023

Built with Xcode 14.2

Bug

  • MSDKIOS-437 - Dead area on screen due to hidden call UI

iOS mobile SDK 4.7.6 release notes

Release date: 18 September 2023

Built with Xcode 14.2

Bug

  • MSDKIOS-422 - LayerType for whiteboard missing

  • MSDKIOS-431 - Delegation of LiveKit participants only added for participants with a video track

iOS mobile SDK 4.7.5 release notes

Release date: 23 August 2023

Built with Xcode 14.2

New feature/improvement

  • MSDKIOS-400 - Fetch Unblu visitor PersonInfo without starting a conversation

  • MSDKIOS-411 - Webview not deallocated because of retain cycle

iOS mobile SDK 4.7.3 release notes

Release date: 27 July 2023

Built with Xcode 14.2

Bug

  • MSDKIOS-385 - Incomplete UI if WebView displayed before SDK initialization completed

  • MSDKIOS-398 - Private area duplicated and added/anchored to floating button

  • MSDKIOS-399 - "Stop co-browsing" alert window doesn’t use server text settings

New feature/improvement

  • MSDKIOS-394 - Debug option for iOS 16.4+

  • MSDKIOS-285 - iOS custom action API trigger

  • MSDKIOS-391 - Add show UI and decline call events to NotificationCenter

iOS mobile SDK 4.7.2 release notes

Release date: 12 July 2023

Built with Xcode 14.2

Bug

  • MSDKIOS-341 - Wrong event flow for visibility and call UI events in UnbluClientDelegate

  • MSDKIOS-348 - Remove and destroy call publisher and subscriber views on disconnect

  • MSDKIOS-393 - "Missed call" notification on locked screen disappears after less than 1 second if autostart webview turned off and on

  • MSDKIOS-396 - Confirmation dialog not showing when tapping on co-browsing button in SwiftUI apps

New feature/improvement

  • MSDKIOS-347 - Improved UI for video calls

iOS mobile SDK 4.7.1 release notes

Release date: 05 June 2023

Built with Xcode 13.3

Bug

  • MSDKIOS-266 - Participants who have denied access to camera aren’t shown in video calls

  • MSDKIOS-301 - Camera turned off when navigating to home screen during active call

  • MSDKIOS-335 - "Go to app" icon missing on button to open app after accepting call on locked screen

  • MSDKIOS-375 - Some internal fields of UnbluNotificationApi exposed in documentation

  • MSDKIOS-382 - Authorization header not on native HTTP requests

  • MSDKIOS-392 - Video stream of mobile user activated when navigating away and back to Unblu UI during active audio call

New feature/improvement

  • MSDKIOS-345 - Adapt audio level indication to web implementation

  • MSDKIOS-386 - Add service worker error handler

  • MSDKIOS-372 - Add authorization header support

  • MSDKIOS-378 - Add API events when user gets unauthenticated

iOS mobile SDK 4.6.1 release notes

Release date: 23 March 2023

Built with Xcode 14

Starting with Xcode 14, Apple no longer supports bitcode. As of iOS mobile SDK 4.6.1, the xcframework files provided by Unblu therefore no longer contain bitcode.

Bug

  • MSDKIOS-349 - Co-browsing indicator still displayed after iPhone is locked

New feature/improvement

  • MSDKIOS-342 - Provide possibility to check if a notification is from Unblu

  • MSDKIOS-360 - Add "connect" stage when connecting to a LiveKit room

  • MSDKIOS-361 - Including CallKit in coreSDK causes issues in Apple approval process when China is a required distribution region

  • MSDKIOS-367 - Move the implementation using CallKit to a separate module

  • MSDKIOS-338 - Integrate LiveKit native SDK

  • MSDKIOS-350 - Provide SDK via cocoapods and swift packages

  • MSDKIOS-368 - Picture-in-picture for VoIP calls

  • MSDKIOS-369 - Background blur for LiveKit VoIP video calls

Removed Feature

  • MSDKIOS-352 - Remove package generation with bitcode

iOS mobile SDK 4.5.5 release notes

Release date: 24 January 2023

Built with Xcode 13.3

New feature/improvement

  • MSDKIOS-275 - Enable Vonage IP whitelisting

iOS mobile SDK 4.5.4 release notes

Release date: 23 December 2022

Built with Xcode 13.3

Bug

  • MSDKIOS-344 - Co-browsing indicator stays in vertical position when the phone is in horizontal view

iOS mobile SDK 4.5.3 release notes

Release date: 08 December 2022

Built with Xcode 13.3

There is a known issue where the mobile co-browsing indicator doesn’t adapt if the visitor changes the orientation of their device from vertical to horizontal during a mobile co-browsing session.

The issue will be fixed in an upcoming release.

Bug

  • MSDKIOS-321 - Width of chat messages incorrect after locking and unlocking the device

  • MSDKIOS-340 - Co-browsing: on iPads, sometimes part of the frame isn’t drawn in split mode

New feature/improvement

  • MSDKIOS-299 - Mobile co-browsing indicator added

iOS mobile SDK 4.5.2 release notes

Release date: 16 November 2022

Built with Xcode 13.3

Bug

  • MSDKIOS-295 - Visitor and agent SDKs become unresponsive when a call starts

  • MSDKIOS-320 - Wrong call type displayed on inbound call dialog for incoming video calls when the app is open

  • MSDKIOS-326 - Webview report call arrives before the Pushkit report, potentially leading to a call without a report

  • MSDKIOS-332 - Source synchronization issue when the command to display the incoming call UI comes from two different sources

New feature/improvement

  • MSDKIOS-323 - Disable shared debug information in the UnbluCallModule static library

  • MSDKIOS-322 - Play audio message when CallKit is displayed to open app

  • MSDKIOS-327 - Make the resource name for the CallKit video button configurable

iOS mobile SDK 4.4.0 release notes

Release date: 27 October 2022

Built with Xcode 13.3

When using version 4.4.0 of the iOS mobile SDK with version 7.20.0, the Collaboration Server doesn’t send push notifications for new messages to agents.

The issue will be fixed in an upcoming release of the Collaboration Server.

Bug

  • MSDKIOS-312 - Messages aren’t marked as read when opening a conversation via push notification

  • MSDKIOS-318 - After accepting the call, if the phone is locked, the incoming call UI is closed unexpectedly after unlocking

New feature/improvement

  • MSDKIOS-135 - Access token authentication for iOS mobile SDK

  • MSDKIOS-317 - Customizable image for the CallKit video button

iOS mobile SDK 4.3.4 release notes

Release date: 22 September 2022

Built with Xcode 13.3

iOS mobile SDK 4.3.4 requires Unblu Collaboration Server 7.18.2. If you use an older version of the Collaboration Server with this version of the SDK, notifications don’t function at all.
If your app uses the CallKit and VoIP functions of the iOS mobile SDK, review the information about the App Store review process in the Unblu documentation^.

Bug

  • MSDKIOS-302 - Two push notifications delivered for one new message when the app is force closed

  • MSDKIOS-309 - Outgoing call doesn’t disconnect after being declined by the counterpart

  • MSDKIOS-310 - No notifications for new messages when the app is in the foreground but the conversation UI is closed

  • MSDKIOS-311 - Agent app: Outgoing call doesn’t disconnect after being declined by the counterpart

New feature/improvement

  • MSDKIOS-291 - Register push token with version and handle returned shared secret

iOS mobile SDK 4.2.3 release notes

Release date: 16 August 2022

Built with Xcode 13.3

Bug

  • MSDKIOS-300 - Crash when starting audio call in simulator with latest Tokbox version

iOS mobile SDK 4.2.2 release notes

Release date: 17 June 2022

Built with Xcode 13.3

Bug

  • MSDKIOS-287 - iOS SDK 4.1.2 - Memory leak identified

New feature/improvement

  • MSDKIOS-205 - Show loading UI while directly opening one conversation

  • MSDKIOS-290 - Implement activity callback on iOS mobile SDK API

iOS mobile SDK 4.2.1 release notes

Release date: 09 May 2022

Built with Xcode 13.3

Bug

  • MSDKIOS-280 - Agent test app: Push notifications for new message forwarded to the inbox

  • MSDKIOS-288 - Setting specific conversation recipient via IOS SDKs doesn’t work

New feature/improvement

  • MSDKIOS-277 - Add API for setting conversation recipient to an agent via the mobile SDKs

iOS mobile SDK 4.1.2 release notes

Release date: 30 March 2022

Bug

  • MSDKIOS-278 - Incoming call: The avatar of the other participant is not displayed correctly

New feature/improvement

  • MSDKIOS-273 - SDK compatibility with Swift version 5.5.2

iOS mobile SDK 4.0.5 release notes

Release date: 30 November 2021

New feature/improvement

  • MSDKIOS-259 - External link click handler should decide whether it shows a dialog on block

iOS mobile SDK 4.0.4 release notes

Release date: 16 November 2021

This version of the iOS mobile SDK is the same as version 4.0.3, but compiled with Xcode 12.5 rather than Xcode 13.

iOS mobile SDK 4.0.3 Release Notes

Release date: 14 October 2021

Bug

  • MSDKIOS-250 - WebView Logs content is swallowed

  • MSDKIOS-251 - Enable Library evolution support

  • MSDKIOS-254 - Mobile SDK: Naming issue, "API" should be removed

  • MSDKIOS-256 - SDK deinitialized after entering wrong PIN

  • MSDKIOS-257 - unread messages count not exposed and event never emits 0

New Feature / Improvement

  • MSDKIOS-248 - Provide iOS SDK builds with and without enabled bitcode

iOS mobile SDK 4.0.0-beta.1 Release Notes

Release date: 17 August 2021

Bug

  • MSDKIOS-238 - IOS SDK: Native notification not displayed after taking video snapshot

New Feature / Improvement

  • MSDKIOS-186 - Mobile SDK: Refactor internal event handling

  • MSDKIOS-225 - Update the way we read device orientation

  • MSDKIOS-227 - Add a dialog if an URL is blocked for security reasons