iOS SDK - v2 Release Notes
StreamsPlaybackEncodingBitmovin Dashboard

iOS SDK - v2 Release Notes

⚠️ This page contains Release Notes for the V2 version (UNSUPPORTED) of the SDK. You can find the current, V3 release notes here.

2.67.4

Released: 2022-03-09

Fixed

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

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.67.3

Released: 2020-10-27

Added

  • PlayerFactory to create Player instances

Deprecated

  • Initializers in the BitmovinPlayer in favour of the newly introduced PlayerFactory

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.67.2

Released: 2020-09-28

Changed

  • Updated 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
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.67.1

Released: 2020-08-31

Fixed

  • AirPlay playback session is paused when iOS device gets locked

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.67.0

Released: 2020-08-19

Added

  • BitmovinCastManagerOptions to specify applicationId, namespace, castReceiverVersion and enableBackgroundSessions when initializing BitmovinCastManager
  • BitmovinCastManagerOptions.enableBackgroundSessions to keep Google Cast sessions active when the app is in background
  • OfflineManagerDelegate which will act as the delegate for OfflineManager
  • areSuspendedDownloadsRestored property on OfflineManager to specify if the OfflineManager has finished restoring suspended downloads

Deprecated

  • BitmovinCastManager.initializeCasting(castReceiverVersion:), BitmovinCastManager.initializeCasting(applicationId:messageNamespace:), BitmovinCastManager.initializeCasting(applicationId:castReceiverVersion:) and BitmovinCastManager.initializeCasting(applicationId:castReceiverVersion:messageNamespace:) in favor of BitmovinCastManager.initializeCasting(options:)

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.66.1

Released: 2020-08-03

Fixed

  • Different text size between single-line and multi-line subtitles when using Bitmovin Player Web UI

Changed

  • Make AdBreakEvent, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdErrorEvent, AdEvent, AdFinishedEvent, AdManifestLoadEvent, AdManifestLoadedEvent, AdSkippedEvent, AdStartedEvent and ErrorEvent open

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.66.0

Released: 2020-07-20

Added

  • showSeekBar and showInfoViews properties in SystemUserInterfaceConfiguration for tvOS to control UI elements' visibility

Fixed

  • Unexpected MetadataEvents for SCTE tags during seeking
  • Online playback occasionally not starting for AES-128 protected streams
  • Unexpected TimeChanged events when calling play right after the PlaybackFinished event

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.65.0

Released: 2021-07-06

Added

  • OfflineConfiguration to configure the offline functionality
  • OfflineConfiguration.restrictMediaDownloadsToWiFi to specify if an active WiFi connection is required for downloading media for offline playback
  • OfflineManager.initializeOfflineManagerWithOfflineConfiguration to set the OfflineConfiguration
  • 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

Fixed

  • No audio on playback when there is no default audio track defined in the asset

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.64.3

Released: 2021-06-22

Fixed

  • Removed internal extensions from public documentation
  • Offline playback of AES-128 encrypted HLS content when only a variant playlist is used

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.64.2

Released: 2021-06-08

Fixed

  • Issue that SourceItems that are not downloaded for offline playback were marked as already downloaded.

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • Already partially downloaded data for offline playback will be lost and has to be redownloaded 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 (using OfflineManager) are not playable anymore when the device is offline

2.64.1

Released: 2021-05-26

Fixed

  • Incorrect value of isPlaying and isPaused inside the Bitmovin Player Web UI when the PlaybackFinishedEvent is received

2.64.0

Released: 2021-04-27

Added

  • Support for side-loaded SubtitleTracks when casting to a v3 (CAF) receiver
  • UserInterfaceAPI.scalingMode to dynamically get or set BitmovinPlayerView's ScalingMode
  • ScalingModeChangedEvent to be emitted when BitmovinPlayerView.scalingMode changed
  • SystemUserInterfaceConfiguration#hideFirstFrame to prevent rendering of the first video frame before playback starts when the system UI is used

Fixed

  • Unexpected TimeChangedEvent is emitted between PlayEvent and PlayingEvent
  • Replay of progressive sources failing occasionally

2.63.0

Released: 2020-04-13

Added

  • TweaksConfiguration.playbackStartBehaviour to configure the player behaviour when Player.play is called
  • TweaksConfiguration.unstallingBehaviour to configure the player behaviour when stalling should be exited

Fixed

  • Local playback starts in addition to remote playback when joining an existing Google Cast session with PlaybackConfiguration.isAutoplayEnabled set to true

2.62.0

Released: 2021-03-30

Added

  • Properties sendManifestRequestsWithCredentials, sendSegmentRequestsWithCredentials and sendDrmLicenseRequestsWithCredentials to the RemoteControlConfiguration to control cookies and credentials on requests made on Chromecast CAF (v3) receivers

Changed

  • Type of AdSurvey.uri from URL to String (see the ### Fixed section for more details)

Fixed

  • Crash if an AdSurvey URL in VAST ad tag contains invalid characters.

2.61.1

Released: 2021-03-16

Fixed

  • Missing seekbar when joining an existing Google Cast session
  • Live stream starting at wrong playback position when casting
  • Current time is not updating when joining a cast session while remote playback is paused
  • Seek bar is jumping when seeking on the sender device while casting
  • Incorrect values on CastTimeUpdatedEvent when casting to a V2 receiver
  • isMuted returning wrong value when calling mute before load
  • Ad playback does not respect muted state of the player when changed before load

2.61.0

Released: 2021-03-02

Added

  • PlaybackConfiguration.isPictureInPictureEnabled to enable/disable Picture-In-Picture support
  • Picture-In-Picture support with BitmovinPlayer UI

Fixed

  • Missing events when casting to a V2 receiver
  • TimeChanged events before StartOffset is applied

2.60.1

Released: 2021-03-02

Fixed

  • Missing events when casting to a V2 receiver

2.60.0

Released: 2021-02-16

Added

  • Support for ControlsShow and ControlsHide events on tvOS when the system UI is used
  • LiveConfiguration to configure live-stream specific settings
  • LiveConfiguration#minTimeshiftBufferDepth to specify a threshold when timeShift should be possible

Changed

  • Exclude BitmovinPlayer SDK from arm64 simulator builds when integrated via CocoaPods.

Fixed

  • Missing payload values on Metadata and MetadataParsed events for SCTE tags containing a = sign

2.59.1

Released: 2021-03-02

Fixed

  • Missing events when casting to a V2 receiver

2.59.0

Released: 2021-01-19

Changed

  • metadata property from the SourceItem is automatically passed to CAF (v3) receivers whenever the source is loaded

Fixed

  • Duplicated Metadata and MetadataParsed events for SCTE tags
  • isBackgroundEnabled not respected for audio-only assets

Known issues

  • Picture in Picture mode (on System UI) is not working on iOS 14.0 and iOS 14.1

Removed

  • Internal type from online documentation

2.58.0

Released: 2020-12-22

Changed

  • Player.currentTime and Player.duration during ad playback now return current time and duration of the currently playing ad
  • onPause, onPlay, onPlaying and onTimeChanged events are now also emitted during IMA ad playback

Fixed

  • Stuck playback when loading an IMA Playlist or a VMAP containing an empty tag
  • Duplicated onPlay and onPlaying events when VMAP ads are started

2.57.1

Released: 2020-12-09

Fixed

  • Values returned via PlayerAPI.isPlaying and PlayerAPI.isPaused when the player is stalled
  • Missing onTimeChanged events when external playback (e.g. AirPlay) was started during playback
  • Scheduling ads into live-streams results in ads not being played

Removed

  • Internal type from online documentation

2.57.0

Released: 2020-11-24

Added

  • beforeInitialization callback to the AdvertisingConfiguration to allow customization of IMASettings
  • disableSubtitleTracksWhileSeeking property to the TweaksConfiguration for temporarily disabling selected subtitle track while seeking to avoid AVPlayer getting stalled permanently with assets having conflicting information about subtitle track duration

Fixed

  • Missing onPlaying event when play was called during stalling
  • Local UI getting reset when connecting or disconnecting to a Chromecast device
  • Crash if the license key was only configured via the PlayerConfiguration

Removed

  • Internal logging being exposed in release builds

2.56.0

Released: 2020-11-10

Added

  • Support for controlling audio tracks when using a CAF (v3) receiver

Fixed

  • Invalid URL generation for backup manifest URLs, leading to playback failures
  • Background playback on iOS 14.2+ devices

Removed

  • Internal types from online documentation

2.55.0

Released: 2020-10-27

Added

  • onAdsManagerAvailable callback to AdvertisingConfiguration to give access to the IMAAdsManager currently in use once it becomes available
  • Id3Metadata, now also holding startTime property
  • startTime to ScteMetadata
  • Support for subtitles loaded from manifest when using a CAF (v3) receiver

Fixed

  • Inconsistent and jumping timeShift values while playing back live-streams

2.54.1

Released: 2020-10-13

Fixed

  • Offline playback on iOS 12 and below did not work for certain streams

2.54.0

Released: 2020-10-13

Changed

  • Increased minimum deployment target to iOS 10 and tvOS 10

Fixed

  • Background playback on iOS 14
  • Stability of onPlay, onPlaying and onPause events by relying on AVPlayer.timeControlStatus instead of AVPlayer.rate

Removed

  • Support for building for iOS 9 and tvOS 9 in order to ensure stability of onPlay, onPlaying and onPause events

2.53.0

Released: 2020-09-29

Added

  • DrmDataParsedEvent which is fired when EXT-X-KEY information is found in a manifest for FairPlay protected streams. TweaksConfiguration.isNativeHlsParsingEnabled needs to be set to true to receive those events.
  • DrmRequest as subclass of HttpRequest in order to expose FairPlay key request data to the PreprocessHttpRequestDelegate

Changed

  • Improved HLS parsing performance when PlayerConfiguration.tweaksConfiguration.isNativeHlsParsingEnabled is enabled

Fixed

  • Crash when PlayerConfiguration.tweaksConfiguration.isNativeHlsParsingEnabled is enabled and EXT-X-KEY tags are present
  • Crash when PlayerConfiguration.tweaksConfiguration.isNativeHlsParsingEnabled is enabled and SCTE35 tags are present
  • Downloading an asset resulted in only main tracks being downloaded on iOS 14
  • Offline download did not resume after application gets killed before main tracks were downloaded

2.52.1

Released: 2020-09-17

Fixed

  • Invalid value reported for offline download progress on iOS 14 devices for some assets
  • Inconsistent offline download progress distribution when downloading only specific subtitle tracks
  • Crash when passing a SourceConfiguration without a SourceItem to the load call

2.52.0

Released: 2020-09-15

Added

  • CAF (v3) sender with basic media controls
  • Support for DRM protected content when casting to CAF (v3) receiver
  • BitmovinCastManager.send(metadata:) for sending custom metadata to the cast receiver
  • PlayerAPI.load(sourceItem:) to load a SourceItem directly

Changed

  • Update Google IMA SDK to latest stable version (3.12.1)

Deprecated

  • BitmovinCastManager.initializeCasting(applicationId:messageNamespace:) in favor of BitmovinCastManager.initializeCasting(applicationId:castReceiverVersion:messageNamespace:)
  • PlayerApi.load(sourceConfiguration:) in favor of PlayerAPI.load(sourceItem:)

Removed

  • Support for Google IMA SDK below version 3.12.1

2.51.1

Released: 2020-09-01

Changed

  • Make playerUiCss, supplementalPlayerUiCss and playerUiJs of BMPStyleConfiguration unavailable on tvOS

Fixed

  • Replaying a source while casting (after playback has finished) did not work

2.51.0

Released: 2020-08-18

Added

  • isDestroyed property to BMPBitmovinPlayer
  • Support for VTT positioning for subtitle tracks which are present in the manifest in combination with our v3 Web-UI (required version > v3.16.0)
  • BMPVttProperties to BMPCue and BMPCueEvent

Changed

  • Modernizing our SDK requires the type BitmovinPlayer being renamed to Player to avoid a known Swift limitation due to name collision with the module name. To handle the breaking change as smooth as possible we suggest defining a typealias (typealias BitmovinPlayer = Player) as a top level declaration in any Swift file in the affected target.
  • Xcode 11.4 or newer is required to integrate the SDK
  • Types prefixed with _ are subject to change and not intended to be used outside of the SDK

2.50.0

Released: 2020-08-05

Fixed

  • Main content (video and audio) occasionally being perceivable before a pre-roll ad when autoPlay was enabled even though hideFirstFrame was set to true in BMPBitmovinUserInterfaceConfiguration

Changed

  • Google IMA SDK does not need to be linked anymore to enable progressive ad playback

2.49.1

Released: 2020-08-04

Fixed

  • Possible incorrect event ordering in case a post-roll ad is configured

2.49.0

Released: 2020-07-21

Added

  • Picture In Picture support while background playback is enabled
  • Support for progressive video ads. They can be served from the network or from the device storage which enables basic offline ad support. To schedule progressive video ads, BMPAdSourceTypeProgressive should be used for the according BMPAdSource
  • BMPAdSourceTypeProgressive

Fixed

  • Replacing the player on the BitmovinPlayerView would result in inconsistent UI behaviour
  • Inconsistent subtitle styling in landscape if Bitmovin Player UI v3 was used
  • Missing onSubtitleChanged event when subtitles are switched via PlayerAPI.setSubtitle(trackIdentifier:) and via System UI consecutively
  • Disabling subtitles during casting does not work
  • Possible memory leak when scheduling Ads
  • Invalid progress calculation when downloading content for offline playback

[2.48.0]

Added

  • Support for configuring external playback mode while mirroring via AirPlay by setting usesExternalPlaybackWhileExternalScreenIsActive within RemoteControlConfiguration

[2.47.0]

Added

  • Possibility to select text tracks to be downloaded or ignored for offline playback

2.46.1

Released: 2020-06-09

Fixed

  • Missing onSubtitleChanged event when subtitles are switched via System UI
  • Empty thumbnail preview on tvOS when EXT-X-I-FRAME-STREAM-INF playlists are referenced with relative URLs
  • Missing metadata events for consecutively loaded sources
  • Missing metadata events on stream start-up due to race condition

2.46.0

Released: 20202-05-26

Added

  • BMPAdManifestLoadEvent, which is triggered when the download of an ad manifest starts
  • BMPDownloadConfiguration.tweaksConfiguration along with DownloadTweaksConfiguration.shouldInsertPlaylistTypeTagIfMissing to ensure offline playback of VOD content where the EXT-X-PLAYLIST-TYPE tag is missing

Fixed

  • Missing BMPMetadataEvents for live streams

Changed

  • Update Google IMA SDK to latest stable version (3.11.4)

Removed

  • Support for Google IMA SDK below version 3.11.1

2.45.0

Released: 2020-05-12

Added

  • BMPDownloadConfiguration along with BMPOfflineManager.download(sourceItem:downloadConfiguration:) to allow configuring content downloads for offline playback
  • Support for offline playback of AES-128 encrypted HLS content. Set BMPDownloadConfiguration.supportClearKeyContent to enable it when downloading AES-128 encrypted content
  • PlayerConfiguration.key to be able to overwrite the Bitmovin license key that is stated in the Info.plist. This enables using different player instances with different license keys.

Changed

  • Reduced time needed to parse huge M3U8 playlists

Deprecated

  • BMPOfflineManager.download(sourceItem:minimumBitrate:) in favor of BMPOfflineManager.download(sourceItem:downloadConfiguration:)

2.44.0

Released: 2020-04-14

Added

  • Support for Chapter Markers on tvOS. These can be set via BMPSourceItem.metadata by setting an array of AVNavigationMarkersGroup using the BMPMetadataIdentifierNavigationMarker identifier.

Fixed

  • HLS master playlist is no longer being downloaded twice

Changed

  • PlayerAPI.videoQuality now returns nil instead of a default quality with 0 values for variant playlist only sources
  • PlayerAPI.availableVideoQualities is now empty for variant playlist only sources

2.43.0

Released: 2020-03-31

Added

  • BMPImaAdData.traffickingParameters to provide trafficking parameters associated with an ad when using the IMA SDK

Fixed

  • Potential crash when delivering the BMPAdStartedEvent

2.42.0

Released: 2020-03-16

Added

  • Support for forced subtitles

Fixed

  • Potential missing initial SubtitleChanged event if no default or forced subtitle is present

2.41.0

Released: 2020-03-02

Added

  • BMPSourceItem.options to configure a custom startOffset

Changed

  • Live-streams without a EXT-X-START tag will no longer start at the live-edge. Per default it will start at the point in time where the stream was loaded into the player (this is the default behaviour of AVPlayer). To always start at the live-edge make sure to enable autoplay or make use of the new BMPSourceOptions.startOffset configuration.

Fixed

  • EXT-X-START was not respected correctly

2.40.0

Released: 2020-02-17

Added

  • BMPBitmovinUserInterfaceConfiguration#hideFirstFrame to prevent rendering of the first video frame before playback starts
  • AdBreakStarted and AdBreakFinished events now include information about the related AdBreak
  • AdStarted, AdFinished and AdSkipped events now include information about the related Ad
  • AdError event now includes the AdConfiguration that caused the error, if this information is available
  • AdManifestLoaded event after an ad manifest has finished downloading, which includes information about the download timing and the AdBreak, or the AdConfiguration for ad tags that do not result in an AdBreak like VMAP tags
  • AdQuartile event contains information about triggered quartile

Fixed

  • Seekbar position marker not updating while casting

Changed

  • The poster image now hides on playing instead of play

2.39.0

Released: 2020-02-03

Added

  • Support for side-loaded VTT subtitles in combination with our Bitmovin UI by providing them via BMPSubtitleTracks on the BMPSourceItem

2.38.0

Released: 2020-01-20

Added

  • customHlsLoadingEnabled property to the TweaksConfiguration to disable custom HLS playlist loading. I.e. if disabled, the playlists will be loaded by the AVFoundation framework instead of the Bitmovin Player

2.37.0

Released: 2019-12-18

Added

  • API call to get currentTime either as relative or absolute value in case of live-streams

2.36.1

Released: 2019-12-11

Fixed

  • No inband caption rendering if BMPBitmovinPlayerView is used with user interface type system

2.36.0

Released: 2019-12-09

Added

  • Warning if #EXT-X-PLAYLIST-TYPE tag is not present in a variant playlist

Fixed

  • Potential crash if the BMPBitmovinPlayerView is created for an active player

Changed

  • Documentation for OfflineManager#createSourceItemForSourceItem:restrictedToAssetCache: is now reflecting prerequisites if DRM protected content is used.

2.35.1

Released: 2019-11-20

Fixed

  • Wrong character encoding of Bitmovin Player UI
  • Live streams not starting on the live edge

2.35.0

Released: 2019-11-11

Added

  • Buffer API implementation to provide information about available buffer

Changed

  • Whenever an additional sender wants to connect to an already running cast session, the according receiver app gets restarted.

Fixed

2.34.0

Released: 2019-10-28

Fixed

  • Wrong timing of onControlsHide event
  • -12645 system error when trying to play offline content

Changed

  • The system's default subtitle selection is now respected if no default track is present in the manifest

2.33.0

Released: 2019-10-14

Fixed

  • Touching the live button (or duration label) results in UI staying visible

Changed

  • Update Bitmovin Player UI to version 2.22.1.

2.32.1

Released: 2019-10-09

Added

  • Support for parsing URL parameters of multiple #EXT-X-KEY tags

Fixed

  • Crash while parsing #EXT-X-KEY tag with METHOD=NONE

2.32.0

Released: 2019-09-30

Added

  • timeChangedInterval to BMPTweaksConfiguration to specify how frequent an TimeChangedEvent should be fired

2.31.0

Released: 2019-09-16

Added

  • Convenience method BitmovinCastManager.sendMessage for sending messages to the cast receiver

Fixed

  • No variant playlist parsing when the master manifest was redirected
  • ClearKey (AES-128) streams not playing

Changed

  • Timing of impression tracking

2.30.0

Released: 2019-09-02

Added

  • Send BMPDownloadFinishedEvent also for playlist downloads
  • Property lastRedirectLocation to the BMPDownloadFinishedEvent
  • Update Google Cast SDK to latest stable version (4.4.4)
  • Update Google IMA SDK to latest stable version (3.9.2)
  • Support to set custom artwork data when downloading assets to show up in "Review Downloaded Videos"
  • Include BMPSourceItem#metadata attribute when sending the source to the cast device

Fixed

  • Missing hour representation in Bitmovin Player UI v3
  • Unloading of currently playing ad when player is destroyed
  • Redirected master manifest requests are now handled properly

2.29.2

Released: 2019-08-19

Fixed

  • Possible runtime crash caused by incorrect thread handling
  • Download percentage calculation when app is terminated and restarted while downloads are running

2.29.1

Released: 2019-08-13

Fixed

  • Pass current timeshift value via source.options to the cast receiver app even when the cast source is configured via prepareSource

2.29.0

Released: 2019-08-05

Added

  • Error propagation when DRM license key could not be persisted
  • Pass current timeshift value via source.options to the cast receiver app when starting a cast session

Fixed

  • SubtitleSelectBox not updating in Web UI v3 when changing the subtitles via setSubtitle API method
  • AudioTrackSelectBox was missing when using the Bitmovin Web UI v3
  • Multiple MetadataParsed events for the same SCTE tag

2.28.3

Released: 2019-08-01

Added

  • Retry logic for failed requests when downloading thumbnail images for offline playback

Fixed

  • False error state when NSURLSession delegate has been called multiple times for the same asset download

2.28.2

Released: 2019-07-22

Fixed

  • Stuck background download tasks of thumbnails under certain circumstances

2.28.1

Released: 2019-07-11

Fixed

  • Background download of thumbnails
  • Display of thumbnails when WebVTT file doesn't include coordinates

2.28.0

Released: 2019-07-08

Added

  • BMPTweaksConfiguration to apply preset tweaks to the BitmovinPlayer
  • Possibility to communicate between a custom Bitmovin Player UI and the native environment by using a CustomMessageHandler which can be set on the BitmovinUserInterfaceConfiguration.
  • EXT-X-SCTE35 Tags Support

Fixed

  • Downloading a source with minimum bitrate also downloads the highest rendition for non-muxed streams

2.27.0

Released: 2019-06-11

Added

  • Possibility to synchronize expiration dates for an offline DRM license

Fixed

  • SourceError when trying to play back an offline asset after license has been renewed.

2.26.1

Released: 2019-05-16

Fixed

  • Downloading a SourceItem with provided minimum bitrate

2.26.0

Released: 2019-05-13

Fixed

  • (De-)Serialization of Widevine DRM headers
  • Offline thumbnail scrubbing for independent images

2.25.0

Released: 2019-05-02

Fixed

  • Notification handling if system storage runs out of space during download
  • BMPBitmovinPlayer returned wrong states for isPlaying, isPaused and isMuted if an ad was playing.
  • Resuming the download of an asset after the app was killed

2.24.0

Released: 2019-04-17

Added

  • AirPlay icon within the default Bitmovin UI

2.23.1

Released: 2019-04-12

Fixed

  • Set volume level and mute state also for the currently playing ad and not just for queued ads

2.23.0

Released: 2019-04-08

Added

  • API call to the BMPOfflineManager to renew an offline DRM license
  • Error in case an DRM certificate request fails

Fixed

  • Downloading a source after it was deleted previously

2.22.0

Released: 2019-04-03

Added

  • Codec property to the quality model classes (BMPVideoQuality, BMPAudioQuality)

2.21.0

Released: 2019-03-20

Added

  • prepareLicenseServerUrl callback to the BMPFairplayConfiguration to manipulate license request URIs.
  • API call currentVideoFrameRate to fetch the currently playing video frame rate from the player.
  • Ability to integrate frameworks via Carthage. Read more on how to get started with it here.
  • Bitmovin UI v3 support

Changed

  • For live streams, currentTime now returns the current playback time as a Unix timestamp.

2.20.0

Released: 2019-03-07

Added

  • ErrorEvent from the OfflineContentManager when the download fails due to insufficient storage
  • Chromecast button to Bitmovin UI
  • API call usedStorageForSourceItem: on BMPOfflineManager to check the used disk space for a specific offline source item

Fixed

  • TimeShift behavior when casting a live stream
  • Mutated while being enumerated exception when initializing BitmovinPlayerView

2.19.0

Released: 2019-02-20

Added

  • Support for timed onMetadata events for EXT-X-DATERANGE metadata contained in HLS manifests
  • Support for offline thumbnail scrubbing
  • Error event if player item fails to play to end

Fixed

  • Unmute via the UI did not unmute the player
  • Wrong seekTarget values in SeekEvent when using BMPUserInterfaceTypeSystem
  • Provide overall download progress for a single source item instead of reporting the progress of its sub-tasks.
  • Jumping scrubber in the Bitmovin Player UI for live streams when autoplay is enabled

2.18.0

Released: 2019-02-06

Added

  • setSubtitleStyles API call to BitmovinPlayerView to allow changing subtitle styles during playback
  • Explicit reporting of DRM license errors
  • A flag to the BMPSystemUserInterfaceConfiguration to enable/disable the 'Auto' subtitle option on tvOS.

Fixed

  • onSubtitleChanged event was never fired on tvOS

2.17.0

Released: 2018-01-24

Added

  • onPlaying event listener in combination with BMPPlayingEvent to BMPPlayerListener
  • onMetadataParsed with corresponding BMPMetadataParsedEvent
  • Support for EXT-X-DATERANGE tags in HLS manifests
  • onAirplayChanged event listener to get notified when an AirPlay session starts or ends
  • sourceMetadata API call to BitmovinPlayer to allow setting/changing source related metadata during playback

Fixed

  • Ad events not being fired if multiple ad breaks are scheduled at the same position
  • Support any metadata of type AVMetadataItem for the BMPSourceItem

2.16.0

Released: 2018-12-21

Added

  • Thumbnail support to the BitmovinPlayer
  • Support of local certificate URLs for FairPlay streaming
  • Property scalingMode to BMPStyleConfiguration to control scaling/stretching of video content
  • Property userInterfaceConfiguration to BMPStyleConfiguration to allow user-interface specific style configurations
  • Property metadata to BMPSourceItem to allow setting metadata on the source item

Fixed

  • Documentation of BMPSourceItem#progressiveSources
  • Broken local Web-UI when casting live streams

2.15.0

Released: 2018-11-29

Added

  • Official support for iOS Cast Sender SDK 4.3.3
  • BMPAdSourceTypeUnknown to BMPAdSourceType enum

Changed

  • Property clickThroughUrl is now optional when instantiating BMPAdStartedEvent

Fixed

  • BMPDestroyEvent does not get fired
  • Indirect retain-cycle between BitmovinPlayer and BitmovinPlayerView when IMA ad integration is used

2.14.0

Released: 2018-11-15

Added

  • Warning events are delivered to the onWarning event listener method in the PlayerListener protocol.

Fixed

  • Player continues playback after it was destroyed

2.13.3

Released: 2018-11-01

Fixed

  • Crash when using latest Google Cast sender library version 4.3.3 in production application

2.13.2

Released: 2018-10-25

Added

  • Missing documentation for configuration classes
  • Support for FairPlay Key Rotation

Fixed

  • Web UI is rendered in an incorrect state when a BitmovinPlayer instance is attached to a BitmovinPlayerView after playback has started

2.13.1

Released: 2018-10-10

Fixed

  • Web UI breaks after system picker view was shown on iOS 12 +

2.13.0

Released: 2018-10-09

Added

  • First version of CHANGELOG.md
  • Support for image subtitles in Bitmovin UI
  • Support for custom receiver configuration values (key/value pairs) within the RemoteControlConfiguration
  • DownloadFinishedEvent for DRM license request and DRM certificate requests
  • CircleCI Build and Test Integration

Changed

  • Updated to web UI version 2.19.0