iOS experimental releases

We are happy to introduce our new Experimental Release stage. It lets you be a part of the early stages of testing new features and help us improve functionality and polish developer experience.

4.2.1-experimental.2025041101 (2025-04-11)

iOS 12 compatible version: 4.2.1-experimental.2025041101-ios12

API Docs

This version is based on the previously released 4.2.1.

New features

Added the new renderer ContinuousScrollRenderer that shows all documents in a single vertical scrolling view.

4.0.0-experimental.3 (2024-01-16)

API Docs

Bugfixes

Fixed an issue related to pre-release versioning in experimental releases. This prevented apps from being uploaded to the App Store.

4.0.0-experimental.2 (2023-11-02)

API Docs

Overview

We are pleased to finally invite you to try out our new native Audiobook support.

New in the Experimental 2 release is the ability to open EPUB3 with MO as audio only, with the option to synchronize with the ReaderView at any time if you wish.

For now we support playing from a LPF package, which is just a zipped up Audiobook. Support for HTTP streaming of "un-packaged" Audiobooks is coming in a future release. Support for additional formats will be added in upcoming releases.

Includes all changes and fixes introduced in framework version 3.8.0.

Breaking changes

Changed minimum iOS version to 12
ColibrioView has been deprecated, please use ColibrioReadingSystemView instead.
ReaderView.visiblePages now returns [VisiblePage] instead of [VisiblePageData].
ReaderView.fetchRectsForVisibleContent(visiblePage:locator:options:) has been removed. Please use VisiblePage.fetchRectsForVisibleContent(locator:options:) instead.
ContentLocation.fetchNavigationItemReferences(options:completion:) callback is now called with FetchNavigationItemReferencesResult instead of FetchNavigationItemReferencesResultData. Properties in FetchNavigationItemReferencesResult return [ReaderPublicationNavigationItemReference] instead of [ReaderPublicationNavigationItemReferenceData].

Bugfixes

Fixed an issue where publicationHashSignature was calculated differently compared to the Web framework.
Fixed several issues where the playback state was not synced correctly when creating a SyncMediaPlayer from a ColibrioAudioPlayer for synchronization with a ReaderView.
Fixed several issues where the playback state was not synced correctly when destroying a SyncMediaPlayer that was synchronized with a ReaderView.
Fixed an issue where ColibrioAudioPlayer.approximateElapsedTimeMs did not update immediately when seeking.

New features

Added ColibrioAudioPlayer.buffering which is equivalent to calling !ColibrioAudioPlayer.ready && !ColibrioAudioPlayer.waitingForReaderViewSynchronization

4.0.0-experimental.1

API Docs

Overview

In this first experimental release we are very proud to let you play around with the our native Audiobook player!

The new ColibrioAudioPlayer is based on SyncMediaPlayer API that you already know. It moves the responsibility for all audio playback to the respective native platform.

A fully working demo application source is available in a public Bitbucket repository.

Check out the API documentation for ColibrioMediaService for how to configure your app to allow background audio playback.

Major new features

New native ColibrioAudioPlayer class that handles playback of audio using the AVFoundation library.
Support for audio playback of LPF packaged W3C Audiobooks and EPUB with Media Overlays.
Background audio playback support.
Integration with MPRemoteCommandCenter and MPNowPlayingInfoCenter. This means that the user can control playback using the Notification Center and Now Playing on connected devices.

Upcoming features

Synchronisation with the Colibrio ReaderView . This feature will automatically synchronise the Audiobook player with the ReaderView whenever you wish to both read and listen.
Support for additional, common audiobook formats. We want your feedback on this.