Release notes for the v2 version of the iOS SDK can be found [here](🔗).

## 3.44.2

**Fixed**

• Potential crash in `ConsoleLogger` in case there are unexpected `String` formatting specifiers in the log message

## 3.44.1

Released: 2023-09-04

**Fixed**

• Unexpected caching of the `FairplayConfig` if it was updated through the `SourceConfig` on subsequent calls to `OfflineManager.getOfflineContentManager(for:)`

## 3.44.0

Released: 2023-08-28

**Added**

• `AdSource.vastLoadTimeout` which can be used to change the timeout for VAST ad manifest downloads

**Changed**

• Update Google Cast SDK to latest stable version (4.8.0)

## 3.43.1

Released: 2023-08-24

**Fixed**

• Inconsistent version number for the `BitmovinPlayerAnalytics` framework

## 3.43.0

Released: 2023-08-16

**Added**

• `TweaksConfig.discardAdsWhileCasting` to control behavior when casting with advertisements scheduled

**Fixed**

• Settings Panel not closing on first touch on the close button

• `PlaybackFinishedEvent` emitted unnecessarily while casting. `CastPlaybackFinishedEvent` was already emitted for this.

**Changed**

• Updated Bitmovin Player Web UI to v3.50.0

**Known Issues**

• Due to an inconsistency in the `MARKETING_VERSION` field, it's not possible to submit an App to Apple's Review process with this version. This is fixed in version `3.43.1`.

## 3.42.0

Released: 2023-08-01

**Added**

• Bitmovin Analytics support. Initially, version `3.0.0` of `BitmovinAnalytics` collector library is used, but it can be updated independently from the `Player` to newer versions. If you are currently using the standalone `BitmovinAnalytics` framework you can remove it and use the built-in dependency and APIs instead. See our [migration guide](🔗) for details.

• The following APIs are available:

  • `PlayerFactory.create(analyticsConfig:)` to allow enabling and configuring Analytics

  • `SourceFactory.create(from:sourceMetadata:)` to allow configuring Analytics metadata

  • `Player.analytics` namespace to control Analytics related features. See `PlayerAnalyticsApi` for available APIs.

  • `Source.analytics` namespace to control Analytics related features. See `SourceAnalyticsApi` for available APIs.

  • `PlayerAnalyticsApiAccessor` to allow access to the `PlayerAnalyticsApi` from Obj-C

  • `SourceAnalyticsApiAccessor` to allow access to the `SourceAnalyticsApi` from Obj-C

**Fixed**

• Duplicated `onFullscreenEnabled` events when attaching new `FullscreenHandler` instance to `PlayerView`

• Missing `onFullscreenEnter`/`onFullscreenExit` events when attaching new `FullscreenHandler` instance to `PlayerView` with different fullscreen state

**Known Issues**

• Due to an inconsistency in the `MARKETING_VERSION` field, it's not possible to submit an App to Apple's Review process with this version. This is fixed in version `3.43.1`.

## 3.41.2

Released: 2023-07-24

**Fixed**

• `DownloadConfig.minimumBitrate` not respected in case it contains a floating point value

## 3.41.1

Released: 2023-07-17

**Fixed**

• Playback pauses on an AirPlay receiver after putting app back in foreground on iOS 16 and above

## 3.36.1

Released: 2023-07-11

**Fixed**

• Advertisements playing on sender when casting to a Chromecast device

• `PlaybackFinishedEvent` emitted unnecessarily while casting. `CastPlaybackFinishedEvent` was already emitted for this.

## 3.41.0

Released: 2023-06-26

**Added**

• `TimelineMarker` API to represent a timeline marker that can be visualised in the player UI

  • `InterstitialMarker` to mark time range of an interstitial for asset when presented in tvOS system UI

  • `SourceConfig.markers` to add a list of `TimelineMarker`s of type `InterstitialMarker`

  • `Source.markers` to add a list of `TimelineMarker`s of type `InterstitialMarker`

  • `TimelineMarkerEnterEvent` and `TimelineMarkerExitEvent`

  • `SystemUserInterfaceConfig.timeToSeekAfterUserSeeked` which is called when the user seeks or timeshifts when using tvOS system UI. It can be used to override the target time of the seek or timeshift operation.

## 3.40.0

Released: 2023-06-12

**Added**

• `BitmovinPlayerCore` framework to lay the groundwork for modularization. See `Changed` section for more details.

• A modern way to subscribe to `Player`, `Source` and `PlayerView` events using combine:

  • `Player.events`, `Source.events` and `PlayerView.events` namespaces for accessing event publishers

  • `PlayerEventsApi.on` for subscribing to `PlayerEvent`s or `SourceEvent`s on `Player` using Combine framework

  • `SourceEventsApi.on` for subscribing to `SourceEvent`s on `Source` using Combine framework

  • `PlayerViewEventsApi.on` for subscribing to `PlayerViewEvent`s on `PlayerView` using Combine framework

• `FairplayLicenseAcquiredEvent` with `PlayerListener.onFairplayLicenseAcquired` and `SourceListener.onFairplayLicenseAcquired` listeners to get notified when a FairPlay license is successfully acquired

• The possibility of renewing an expiring FairPlay license:

  • `SourceDrmFairplayApi.renewExpiringLicense` for renewing an expiring FairPlay license

  • `Source.drm` namespace for access DRM specific APIs on a source

  • `Source.drm.fairplay` namespace for access FairPlay DRM specific APIs on a source

  • `SourceDrmApi.fairPlay` namespace for access FairPlay DRM specific APIs on a source

• SwiftUI support:

  • `VideoPlayerView` for built-in SwiftUI support

• Allow custom Bitmovin Player Web UI to access current source's `metadata`

**Changed**

• From `3.40.0` onwards, the `BitmovinPlayer` framework is a collection of multiple frameworks which defines the final `Player` product. For now, the only dependency is the `BitmovinPlayerCore` framework. This dependency will always have an exact version match. This means it is not possible to mix incompatible versions together.

• For ObjC users only:

  • The import for the `Player` changes from `<BitmovinPlayer/BitmovinPlayer.h>` to `<BitmovinPlayerCore/BitmovinPlayerCore.h>`.

**Removed**

• Bitcode support. As Apple deprecated bitcode since Xcode 14, we are now also disabling this configuration.

## 3.39.0

Released: 2023-05-30

**Removed**

• Deprecated methods and properties from `OfflineManager`:

  • `offlineState(for:)`

  • `deleteOfflineData(for:)`

  • `fetchAvailableTracks(for:)`

  • `download(sourceConfig:)`

  • `download(sourceConfig:, downloadConfig:)`

  • `download(sourceConfig:, tracks:, downloadConfig:)`

  • `cancelDownload(for:)`

  • `suspendDownload(for:)`

  • `resumeDownload(for:)`

  • `syncOfflineDrmLicenseInformation(for:)`

  • `offlineDrmLicenseInformation(for:)`

  • `renewOfflineLicense(for:)`

  • `createOfflineSourceConfig(for:, restrictedToAssetCache:)`

  • `add(listener:, for:)`

  • `remove(listener:, for:)`

  • `isPlayableOffline(sourceConfig:)`

  • `usedStorage(for:)`

• Deprecated `OfflineManagerListener`

**Fixed**

• Missing types from API documentation

## 3.38.0

Released: 2023-05-15

**Changed**

• `FullscreenEnterEvent`, `FullscreenExitEvent`, `FullscreenEnabledEvent`, `FullscreenDisabledEvent`, `ControlsShowEvent`, `ControlsHideEvent`, `PictureInPictureEnterEvent`, `PictureInPictureEnteredEvent`, `PictureInPictureExitEvent`, `PictureInPictureExitedEvent` and `ScalingModeChangedEvent` are now conforming to `PlayerViewEvent` instead of `PlayerEvent`

**Fixed**

• `SourceConfig.options.startOffset` not being respected when using Chromecast

## 3.37.2

Released: 2023-04-24

**Fixed**

• Stalling when a progressive source is loaded into a `Player` instance that has a source loaded already with autoplay enabled

## 3.37.1

Released: 2023-04-11

**Fixed**

• Ads are covered by main content after exiting Picture-in-Picture playback when another UI is used that is not Bitmovin Player UI

## 3.37.0

Released: 2023-04-03

**Added**

• `Logger` and related components `LogLevel`, `LogSender` and `LogEntry` for the logging facility

• `LoggingConfig` to provide logging related configuration options

• `DebugConfig.logging` to configure logging in the SDK

• `BitmovinUserInterfaceConfig.forceSubtitlesIntoViewContainer` to provide access to the `UIConfig.forceSubtitlesIntoViewContainer` of our Bitmovin Player Web UI

• `TweaksConfig.delayInitialSubtitleSelection` which can be enabled to prevent race conditions with `AVPlayer`'s internal subtitle selection logic. When this race condition occurs, it can have unexpected side effects, like playback starting at the beginning of the DVR window instead of at the live-edge for live streams with growing DVR window.

**Changed**

• Increased minimum required versions to iOS 14.0 and to tvOS 14.0

• Updated Bitmovin Player Web UI to version `3.46.0`

**Fixed**

• Out-of-view-port caption rendering on iOS 16 by setting `UIConfig.forceSubtitlesIntoViewContainer` to `true` per default in our Bitmovin Player Web UI

**Deprecated**

• `PlayerWarningEvent`, `SourceWarningEvent`, `PlayerListener.onPlayerWarning` and `SourceListener.onSourceWarning`. Warnings are now communicated through logs with level `.warning`.

## 3.36.0

Released: 2023-03-20

**Changed**

• Updated Bitmovin Player Web UI to version `3.45.0`

**Fixed**

• Potential crashes when `Player` gets deallocated or destroyed

## 3.35.1

Released: 2023-03-06

**Fixed**

• Buffer level indicator exceeding right edge of seek bar when seeking close to the end in Bitmovin Web UI

• A memory leak of our internal retry handler

• Crash during casting when time shifting before a source was loaded

## 3.35.0

Released: 2023-02-12

**Changed**

• `Xcode 14.1` or newer is required to integrate the SDK

**Fixed**

• `SourceUnloadEvent` and `SourceUnloadedEvent` are now emitted correctly after (and not before) the `PlayerErrorEvent` when a player error occurs

• `DestroyEvent` is now emitted correctly after (and not before) the `PlayerErrorEvent` when a licensing error occurs

## 3.34.1

Released: 2023-01-30

**Changed**

• Removed main-thread assertion leading to runtime crashes when accessing video-quality related API from a background thread

**Fixed**

• `Player.timeShift` returning `0` after time-shifting when the System UI is used.

• `TimeShiftEvent.timeShift` returning `0` when the System UI is used for time-shifting.

• Missing `PausedEvent` during group playback when pausing right after seeking

## 3.34.0

Released: 2023-01-19

**Added**

• `PlayerView.pictureInPicture` API namespace to group picture in picture related APIs together going forward

• `PictureInPictureApi.showSkipControls` to dynamically specify if skip-backward and skip-forward buttons are visible when Picture in Picture is active on iOS

• `PictureInPictureConfig.restoreUserInterfaceHandler` to provide the possibility to restore the user interface before Picture in Picture stops

## 3.33.0

Released: 2023-01-17

**Added**

• `BitmovinCastManagerOptions.deviceDiscoveryMode` to specify when cast devices discovery should start

**Changed**

• Update Google IMA SDK for iOS to latest stable version (3.18.4)

• Update Google IMA SDK for tvOS to latest stable version (4.8.2)

**Fixed**

• Potential crash when using `TweaksConfig.isCustomHlsLoadingEnabled` with value `true`

• Missing `PausedEvent` when a participant is doing stall recovery during group playback and the group pauses while the stalling participant is suspended

• Potential memory leak when using the Bitmovin Player UI

## 3.32.0

Released: 2022-12-20

**Added**

• `PlayerViewConfig` to configure `PlayerView` behavior

• `PictureInPictureConfig` to group configurations for Picture in Picture playback

  • `showSkipControls` to specify if skip-backward and skip-forward buttons are visible when Picture in Picture is active on iOS

  • `shouldEnterOnBackground` to specify if Picture in Picture playback should start automatically when the App enters background

• `PlayerView(player:,frame:,playerViewConfig:)` initializer to the `PlayerView` to allow setting the new `PlayerViewConfig`

• `.dSYM` and `.bcsymbolmap` files to XCFramework product in order to support crash report symbolication

**Deprecated**

• `PlaybackConfig.isPictureInPictureEnabled` in favor of `PictureInPictureConfig.isEnabled`

**Removed**

• Deprecated `RenderFirstFrameEvent` event data object and `onRenderFirstFrame` event listener from `PlayerListener`

## 3.31.0

Released: 2022-12-06

**Added**

• `Player.sharePlay` namespace to control SharePlay related features. SharePlay allows synchronized group playback between participants that are on a FaceTime call together. A SharePlay sample application can be found in our [sample repository](🔗). The `Player.sharePlay` namespace offers the following APIs:

  • `coordinate(with groupSession:)` lets the player join the `groupSession` to allow group playback

  • `isInGroupSession` describes whether the player is currently participating in group playback

  • `beginSuspension(for suspensionReason:)` starts a suspension. The player is not participating in group playback while the suspension is active

  • `endSuspension(_ suspension:)` and `endSuspension(_ suspension:, proposingNewTime newTime:)` ends the suspension and optionally proposes a new time that every participant should seek to

  • `isSuspended` describes whether the player is currently suspended and not able to participate in group playback

  • `suspensionReasons` describes why the player is currently not able to participate in group playback

• `NetworkConfig.retryHttpRequest` callback that can be used to implement a custom retry logic for failed HLS playlist requests

**Fixed**

• Potential crash when hitting play on the System UI when no `Source` is currently loaded

**Known Issues**

Missing features and known limitations for the SharePlay feature:

• Trick play (slow/fast-forward and rewind) is not supported

• Synchronized ad playback and ad break management is not supported

• Casting is not supported

• Playlists are not supported

• Scrubbing suspensions when using Bitmovin UI are not supported

• System UI is not supported

• AirPlay and Picture in Picture (PiP) are not fully supported. Playback changes done with the AirPlay receiver or PiP mini player are not synchronized with the group. Playback changes done on the AirPlay sender device are working as expected

## 3.30.0

Released: 2022-11-22

**Changed**

• `PlayerConfig` from `open` to `final` to restrict subclassing

**Removed**

• `NSCopying` conformance for `Config`

• `Config` as super type from all configs

**Fixed**

• Endless stalling after seeking on iOS 16.1 when `TweaksConfig.unstallingBehaviour` is set to `.aggressive` for HLS assets

• Bad structure of `TweaksConfig.isCustomHlsLoadingEnabled` documentation

## 3.29.0

Released: 2022-11-08

**Added**

• `ImaSettings` type to improve usability when Google IMA SDK is used

• `ImaAdsManager` type to improve usability when Google IMA SDK is used

• `VideoPlaybackQualityChangedEvent` which is emitted when the playback video quality changes

**Changed**

• Improved documentation on `AdBreak.ads` to state limitations

• `AdvertisingConfig.beforeInitialization` property now uses our own `ImaSettings` type instead of Google IMA SDK to improve usability

• `AdvertisingConfig.onAdsManagerAvailable` property now uses our own `ImaAdsManager` type instead of Google IMA SDK to improve usability

**Removed**

• `autoPlayAdBreaks` property when using `IMASettings` from `AdvertisingConfig.beforeInitialization`, as using this property has no effect on ad playback

• `playerType` property when using `IMASettings` from `AdvertisingConfig.beforeInitialization`, as using this property has no effect on ad playback

• `enableDebugMode` property when using `IMASettings` from `AdvertisingConfig.beforeInitialization`, as using this property has no effect on ad playback

• `delegate` property when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as using this caused undefined behavior, potentially breaking playback

• `adPlaybackInfo` property when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as all of this information is available via `Player` API during ad playback

• `volume` property when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as this is available via `Player.volume` API during ad playback

• `delegate` property when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as using this caused undefined behavior

• `initialize(with:)` when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as this had no effect

• `start()` method when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as ads are starting automatically when scheduled if playing, or can be started using via `Player.play()`

• `pause()` method when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as this is available via `Player.pause()` API during ad playback

• `resume()` method when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as this is available via `Player.play()` API during ad playback

• `skip()` method when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as this is available via `Player.skipAd()` API during ad playback

• `clicked()` when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as this API had no effect when used

• `destroy()` when using `IMAAdsManager` from `AdvertisingConfig.onAdsManagerAvailable`, as using this caused undefined behavior, potentially breaking playback

**Fixed**

• `Seek`/`TimeShift` and `Seeked`/`TimeShifted` event emitting when multiple seek or timeShift operations are done after each other

• Missing `onVideoDownloadQualityChanged` listener method in `SourceListener`

## 3.28.0

Released: 2022-09-27

**Added**

• `player.isOutputObscured` property that returns whether visual output is obscured due to insufficient external protection for the content.

• `OutputObscuredEvent` and `OutputUnobscuredEvent` which are emitted when `player.isOutputObscured` changes its value

**Deprecated**

• `TweaksConfig.disableSubtitleTracksWhileSeeking` without replacement

## 3.27.0

Released: 2022-09-13

**Added**

• `SystemUiApi.customInfoViewControllers` which allows adding custom info view controllers that are presented as content tabs on tvOS 15 and above

• Event emitting for `Seek`/`TimeShift` and `Seeked`/`TimeShifted` events during casting

**Fixed**

• Playback on cast receiver not continuing when destroying the local player

• Outdated and incomplete documentation for `NetworkConfig`

• Performance issues when running on iOS or tvOS simulator

• Horizontal positioning for cues in WebVTT subtitle tracks on iOS and tvOS 16

## 3.26.0

Released: 2022-08-30

**Added**

• Possibility to remove faulty `Source`s from a `SourceErrorEvent`. See [`onSourceError`](🔗) for details.

## 3.25.0

Released: 2022-08-16

**Changed**

• Change `TimeMode` to a `@frozen` enum

• `SourceConfig.metadata` in Swift now uses `[String: Any]` type

**Removed**

• Deprecated APIs from `SourceConfig`:

  • `HlsSource`

  • `DashSource`

  • `ProgressiveSource`

  • `SourceConfig` initializers:

    • `init(adaptiveSource:)`

    • `init(HlsSource)`

    • `initWithDASHSource:`

    • `initWithProgressiveSource:`

  • `SourceConfig` properties and methods:

    • `urlForType:`

    • `hasSourceOfType:`

    • `addSource:error:`

    • `addAdaptiveSource:error:`

    • `addProgressiveSource:error:`

• `AdaptiveSource`, `DASHSource`, `HLSSource`, `ProgressiveSource`, `MediaSource` classes

**Fixed**

• `CueExitEvent`s firing continuously when external subtitles are added to `SourceConfig`

• Incorrect playback position when using an UNIX timestamp for time-shifting using `player.timeShift`

## 3.24.0

Released: 2022-08-02

**Added**

• `SystemUiApi.infoViewActions` which allows dynamically changing info view actions on tvOS 15 and above

## 3.23.1

Released: 2022-07-19

**Fixed**

• Google IMA SDK overlay not respecting safe area layout of the `PlayerView`

• Compilation error when BitmovinPlayer is used within an Objective-C++ (`.mm`) file

• Broken `PlayerView` subclassing for a custom view implementation

## 3.23.0

Released: 2022-07-05

**Added**

• `PlayerFactory.sdkVersion` to retrieve the current version of the BitmovinPlayer SDK

• `SystemUserInterfaceConfig.transportBarCustomMenuItems` to configure custom transport bar items on tvOS 15 and above

• `PlayerView.systemUi` API namespace of type `SystemUiApi` for interactions regarding the system UI

• `SystemUiApi.transportBarCustomMenuItems` which allows dynamically changing custom transport bar items on tvOS 15 and above

• `AdvertisingConfig.ima` property and `ImaAdvertisingConfig` type to customize Google IMA SDK

• `ImaAdvertisingConfig.adAttributionUiMode` to customize Ad attribution appearance when using Google IMA SDK

**Fixed**

• Setting `PlayerView.scalingMode` having no effect when Subtitle UI is used

## 3.22.0

Released: 2022-06-21

**Added**

• Picture In Picture support on tvOS 14 and above

• `AdBreakStartedEvent.adBreak.totalNumberOfAds` and `AdBreakFinishedEvent.adBreak.totalNumberOfAds` properties to provide the number of ads in an ad break

**Fixed**

• Incorrect handling when the application enters background on tvOS, resulting in restarted streams when the application enters foreground again

• `UserInterfaceType.subtitle` not properly respected on tvOS resulting in displaying the system UI

• `AdStartedEvent.indexInQueue` always returned `0` instead of the proper value

## 3.21.0

Released: 2022-06-07

**Added**

• Ads support on tvOS

  • Google IMA tvOS SDK `4.6.1` and higher

  • Progressive ads

• `player.playlist.add(source:at:)` to dynamically add `Source`s into the playlist

• `player.playlist.add(source:)` to dynamically add `Source`s at the end of the playlist

• `SourceRemovedEvent` to notify about a `Sources` removed from the playlist

• `player.playlist.remove(sourceAt:)` to dynamically remove `Source`s from the playlist

• `SourceAddedEvent` to notify about new Sources added into the playlist

• `SourceRemovedEvent` to notify about Sources removed from the playlist

**Fixed**

• No replay overlay visible on the sender when playback finished during casting

• Inconsistent player state and event emitting during loading a new `Source` while casting

• UI seekbar flickering when loading a live-stream while casting

## 3.20.0

Released: 2022-05-24

**Added**

• Support for `PreprocessHttpRequestDelegate` of the `NetworkConfig` for HLS Playlist requests

**Fixed**

• Incorrect `onCastTimeUpdated` event fired after pausing the player while casting

• During casting, after pausing playback and seeing the expected `onCastPaused` event, an incorrect event sequence of `onCastPlaying`, `onCastTimeUpdated` and `onCastPaused` is seen

## 3.19.0

Released: 2022-05-10

**Added**

• `cea` to `SubtitleFormat` to represent closed captions

**Changed**

• Type of `position` from `String?` to `CuePosition?` in `CueEvent`, `CueEnterEvent`, `CueExitEvent` and `CueParsedEvent`

**Fixed**

• Positioning information not available on `CueEnterEvent` and `CueExitEvent` for closed caption tracks

• `hideFirstFrame` not working when using `UserInterfaceType.system`

## 3.18.0

Released: 2022-04-12

**Removed**

• `AudioQuality` as it was unused

**Fixed**

• Player getting stuck when new source is loaded directly from `onSourceError` listener

• `SourceErrorEvent` emitted twice when new source is loaded directly from `onSourceError` listener

• Missing `AdErrorEvent` event for ads with non-supported file types within VMAP manifests

• Thumbnails not showing on the Bitmovin Player UI

• Absolute-path relative references not resolved correctly for WebVTT `ThumbnailTrack`

## 3.17.0

Released: 2022-03-29

**Added**

• `replayMode` property to the `PlaylistOptions` to make playlist replay behavior configurable

**Removed**

• Support for [Bitmovin Player Web U](🔗)I below version `3.19.0`

**Fixed**

• `offlineDrmLicenseInformation.isDrmLicenseExpired` is always showing as expired for FPS protected content

• Background Playback not working when `uiEnabled` is false

**Changed**

• `OfflineContentManager.offlineDrmLicenseInformation` to return optional value in order to always represent the correct state

• `OfflineManager.offlineDrmLicenseInformationForSourceConfig:` to return optional value in order to always represent the correct state

**Deprecated**

• `OfflineContentManager.isDrmLicenseExpired` in favor of optional `OfflineContentManager.offlineDrmLicenseInformation` value

## 3.16.0

Released: 2022-03-15

**Added**

• Swift Package Manager support. To use our SDK with the Swift Package Manager we created [this](🔗) repository including all releases starting from 3.0.0

• `SubtitleRemovedEvent`, `SubtitleChangedEvent`, `SubtitleAddedEvent` and `CueParsedEvent` to be emitted for inactive sources in a playlist

**Fixed**

• Incorrect SCTE tag timing when the initial variant playlist has a `EXT-X-MEDIA-SEQUENCE` of 0

• `CueEnter.text` property containing `<br>` as new-line representation instead of `\n`

• `CueEnter.html` property containing `\n` as new-line representation instead of `<br>` for external `SubtitleTrack`s

• `CueEnter.html` is empty for `SubtitleTrack`s that are present in the manifest

**Changed**

• `SubtitleRemovedEvent`, `SubtitleChangedEvent`, `SubtitleAddedEvent` and `CueParsedEvent` are now conforming to `SourceEvent` instead of `PlayerEvent`

• `CueEvent` is now a protocol instead of a class conforming to `PlayerEvent`

## 3.15.0

Released: 2022-03-01

**Added**

• `isCastEnabled` property to the `RemoteControlConfig` to enable or disable casting functionality for a player instance

• Support for `ID` and `CLASS` properties for `EXT-X-DATERANGE` metadata

**Fixed**

• Some internal events are emitted through the `onEvent` listener method

## 3.14.0

Released: 2022-02-16

**Added**

• `MetadataParsedEvent` to be emitted for inactive sources in a playlist when SCTE metadata is parsed for HLS content

• `MetadataParsedEvent` to be emitted for inactive sources in a playlist when Id3 metadata is parsed for HLS content

• Allow seeking and time shifting as soon as `PlayerActiveEvent` is seen. Before, it was required to wait until the `ReadyEvent` is received.

• Support for negative values for `player.playbackSpeed` to allow reverse playback

• `Player.canPlayAtPlaybackSpeed` API to check if given `playbackSpeed` value is supported by the currently loaded source

**Fixed**

• Missing `TimeShiftEvent` and `TimeShiftedEvent` on tvOS when live stream contains `EXT-X-PROGRAM-DATE-TIME`

• Playback via AirPlay for HLS streams hosted on Akamai using Token Authentication

• Unnecessary caching of HLS playlist requests

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

## 3.13.0

Released: 2022-02-01

**Added**

• Automatic retries for HLS playlist requests when the previous request failed with an non-2xx HTTP status code

**Fixed**

• Time shifting not always working properly when being connected to AirPlay on iOS versions lower than iOS 14.7

• Potential runtime crash when using Google IMA SDK

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

## 3.12.0

Released: 2022-01-18

**Added**

• `HttpRequestType` enum when used from Swift

• `DownloadFinishedEvent.requestType` to make use of the new `HttpRequestType` enum

**Changed**

• Updated Google Cast SDK to latest stable version (4.7.0)

**Removed**

• Underscored methods and properties from documentation

**Fixed**

• Partially downloaded offline data getting discarded when upgrading from version 2.64.2 or below

• Resuming offline downloads after upgrading from version 2.64.2 or below

• Crash during seeking while connecting to Google Cast device

• `PlayEvent` is fired too late when `PlaybackConfiguration.isAutoplayEnabled` is set to `true`

• Documentation generation for various types

• Missing documentation for tvOS only properties

**Deprecated**

• `HttpRequestType`s constants when used from Swift in favour of the new `HttpRequestType` enum

• `DownloadFinishedEvent.downloadType` in favour of the new properly typed `requestType` property

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

## 3.11.0

Released: 2021-12-21

**Changed**

• Updated Google IMA SDK to latest stable version (3.14.5)

**Fixed**

• Missing `PlayingEvent` when `SourceOptions.startOffset` is configured and `PlaybackConfiguration.isAutoplayEnabled` is set to `true`

• Deprecation message pointing to non-existing API for `OfflineManager.isPlayableOffline`

• Content being paused on Google Cast receiver when sender device gets locked

• Content being reloaded unnecessarily on Google Cast receiver when sender application is brought back to foreground

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

• Already partially downloaded data for offline playback will be lost and has to be re-downloaded after updating from below `2.64.2` to this version

## 3.10.0

Released: 2021-12-07

**Added**

• `OfflineContentManager` to manage all offline content and offline DRM related tasks for a single `SourceConfig`

• `OfflineContentManagerListener` to receive updates regarding offline content and offline DRM related tasks

• `OfflineManager.offlineContentManager(for:)` to retrieve a `OfflineContentManager` instance for a certain `SourceConfig`

• `OfflineEvent` as parent type for all other events emitted by an `OfflineContentManager`

• `AvailableTracksFetchedEvent` to get notified when the available tracks were fetched

• `OfflineContentLicenseExpiredEvent` to get notified when the stored license is expired

• `OfflineContentLicenseRenewedEvent` to get notified when the license was renewed

• `ContentDownloadCanceledEvent` to get notified when the content download was cancelled

• `ContentDownloadResumedEvent` to get notified when the content download was resumed

• `ContentDownloadProgressChangedEvent` to get notified for every progress change during the content download

• `ContentDownloadSuspendedEvent` to get notified when the content download was suspended

• `ContentDownloadFinishedEvent` to get notified when the content download finished successfully

• `OfflineErrorEvent` to get notified about any error that happened

• `offlineContentManager(for:id:)` to `OfflineManager` to define a custom unique identifier for `OfflineContentManager`

• `OfflineContentManager.tweaks` namespace to control tweaks for offline content downloads

• `OfflineContentManagerTweaksApi.migrateDownload(remoteAssetUrl:resourceIdentifierCallback:)` to enable updating download URL for offline content downloads

**Changed**

• `AudioAddedEvent`, `AudioChangedEvent` and `AudioRemovedEvent` are now conforming to `SourceEvent` instead of `PlayerEvent`

• Improved documentation of consequences when enabling/disabling `TweaksConfig.isCustomHlsLoadingEnabled` and `TweaksConfig.isNativeHlsParsingEnabled`

**Removed**

• Internal types from public documentation

**Fixed**

• Downloading ClearKey (AES-128) protected content when `SourceConfig.title` is not set

• Calling `player.audio` or `player.setAudio(trackIdentifier:)` before the source finishes loading blocks the main thread

**Deprecated**

• All methods on the `OfflineManager` which are `SourceConfig` related. From now on the `OfflineContentManager` should be used

• `OfflineManagerListener` and all its methods. From now on the `OfflineContentManagerListener` should be used

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

• Already partially downloaded data for offline playback will be lost and has to be re-downloaded after updating from below `2.64.2` to this version

## 3.9.2

Released: 2021-11-23

**Fixed**

• Performance issues on iOS 15 when preloading a playlist with many sources

• A potential crash on iOS 15 when preloading a playlist with many sources

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

• Already partially downloaded data for offline playback will be lost and has to be re-downloaded after updating from below `2.64.2` to this version

## 3.9.1

Released: 2021-11-11

**Fixed**

• Broken playback of downloaded FairPlay protected content when upgrading from SDK version 2.64.2 or below to v3 or from 3.3.0 or below to v3

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

• Already partially downloaded data for offline playback will be lost and has to be re-downloaded after updating from below `2.64.2` to this version

## 3.9.0

Released: 2021-10-12

**Added**

• `thumbnail(forTime:)` API to `Source` to retrieve thumbnails for non-active sources.

**Fixed**

• A memory leak inside a `Source` object after it was loaded into a player, which lead to never releasing it

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

• Already partially downloaded data for offline playback will be lost and has to be re-downloaded after updating from below `2.64.2` to this version

• When upgrading to this version, FairPlay protected streams that were downloaded with a version before `2.64.2` for v2 to v3 upgrade or before `3.3.0` for a v3 to v3 upgrade (using `OfflineManager`) are not playable anymore when the device is offline

## 3.8.0

Released: 2021-09-28

**Added**

• `showTitleInSeekBar` property in the `SystemUserInterfaceConfig` to control the visibility of the title above the seek bar on tvOS 15 and above

**Fixed**

• Crash when stopping the cast session after a `SourceConfig` was used for loading an asset

**Changed**

• The documentation for `showSeekBar` and `showInfoViews` on the `SystemUserInterfaceConfiguration` to properly reflect it's behaviour on tvOS 15

**Known Issues**

• Picture in Picture mode is not working on iOS 14.0 and iOS 14.1

• Playback gets stuck when playing a Progressive Ad that results in an `AdError`

• Loading a new \`Source from a PlayerErrorEvent or a SourceErrorEvent does not work

• Loading a new `Source` from a `PlaybackFinishedEvent` sometimes does not start playback automatically when `PlaybackConfig.isAutoPlayEnabled` is set to `true`

• When our default Bitmovin Player Web UI is used it can happen that the label of an `AudioTrack` keeps the value of the previous source

• Already partially downloaded data for offline playback will be lost and has to be re-downloaded after updating from below `2.64.2` to this version

• When upgrading to this version, FairPlay protected streams that were downloaded with a version before `2.64.2` for v2 to v3 upgrade or before `3.3.0` for a v3 to v3 upgrade (using `OfflineManager`) are not playable anymore when the device is offline

## 3.7.0

Released: 2021-09-14

**Added**

• `movpkg` to `SourceType` to support playback of local MOVPKG files

• `provideLicenseData` and `persistLicenseData` to `FairplayConfig` for advanced use-cases and external FairPlay license handling

**Fixed**

• Seeking backwards within a playlist is never finished on iOS 15

• `isPlaying` occasionally returned `false` inside an `onPlaylistTransition` listener method

• Bitmovin Player Web UI occasionally stays visible after a transition to a subsequent source

• `AirPlayToggleButton` not updating to active state when AirPlay is active

**Changed**

• The `ad` parameter of the `init` function in the `AdStartedEvent` from Optional to non-Optional

• `FairplayConfig.certificateUrl` changed from type `URL` to `URL?` to enable advanced FairPlay license handling

## 3.6.1

Released: 2021-08-31

**Fixed**

• AirPlay playback session is paused when iOS device gets locked

• Subsequent `Source`s within a playlist don't finish preloading before transitioning on iOS 12

**Changed**

• Making several `Events` open for extending and changed their initializers to public for better integration support

## 3.6.0

Released: 2021-08-19

**Added**

• `BitmovinCastManagerOptions` to specify `applicationId`, `namespace` and `enableBackgroundSessions` when initializing `BitmovinCastManager`

• `BitmovinCastManagerOptions.enableBackgroundSessions` to keep Google Cast sessions active when the app is in background

• `OfflineConfig` to configure the offline functionality

• `OfflineConfig.restrictMediaDownloadsToWiFi` to specify if an active WiFi connection is required for downloading media for offline playback

• `OfflineManager.initializeOfflineManagerWithOfflineConfig` to set the `OfflineConfig`

• `OfflineManager.isOfflineManagerInitialized` to check if the shared instance is already initialized

• `restrictMediaDownloadsToWiFi` property on `OfflineManager` to specify if an active WiFi connection is required for downloading media for offline playback

• `OfflineManagerDelegate` which will act as the delegate for `OfflineManager`

• `areSuspendedDownloadsRestored` property on `OfflineManager` to specify if the `OfflineManager` has finished restoring suspended downloads