[object Object] Icon

Encoding
Learn how to create, start, manage and modify Encodings

[object Object] Icon

Player
Learn how to create, start, manage and modify Players

[object Object] Icon

Analytics
Learn how to create, start, manage and modify Analyticss

Docs Home
User shortcuts for search
Focus by pressing f
Hide results by pressing Esc
Navigate via   keys

Player iOS / tvOS Releases

Latest Releases

Date

Version

Stable

6/8/2021

3.2.0

Added

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 results in an AdError
  • Loading a new Source from a PlayerError or a SourceErrorEvent does not work
  • Loading a new Source from a PlaybackFinishedEvent sometimes does not start playback automatically when isAutoPlayEnabled is set to true
  • Unexpected TimeChanged event is emitted between the Play and PlayingEvent when a Source or a Playlist is replayed
  • When our default Bitmoivn Player Web UI is used it could happen that the label of an AudioTrack keeps the value of the previous source
  • Loading a SourceConfig via Player.load(sourceConfig:) leads to a crash when exiting casting (use Player.load(source:) instead)
  • 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

Stable

5/26/2021

3.1.0

Added

  • isAirPlayEnabled property in RemoteControlConfig to enable or disable the AirPlay functionality

Fixed

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

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 results in an AdError
  • Loading a new Source from a PlayerError or a SourceErrorEvent does not work
  • Loading a new Source from a PlaybackFinishedEvent sometimes does not start playback automatically when isAutoPlayEnabled is set to true
  • Unexpected TimeChanged event is emitted between the Play and PlayingEvent when a Source or a Playlist is replayed
  • When our default Bitmoivn Player Web UI is used it could happen that the label of an AudioTrack keeps the value of the previous source
  • Loading a SourceConfig via Player.load(sourceConfig:) leads to a crash when exiting casting (use Player.load(source:) instead)
  • 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

Stable

5/11/2021

3.0.1

Changed

  • A StallStartedEvent will now be emitted after a SeekedEvent and TimeShiftedEvent if the seek or timeShift results in stalling

Fixed

  • Crash when destroying player during ad playback
  • No stalling indicator visible when stalling is in progress when transitioning from one Source to another happens
  • Incorrect Source.loadingState when the following event listeners were called: SourceLoad / SourceLoaded / SourceUnload / SourceLoaded
  • Additional SourceLoaded events when a Source already finished preloading during playback of the previous Source
  • Player is returning data from the previous source inside the PlaylistTransitionEvent (e.g. Player.availableAudio, Player.availableSubtitles)

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 results in an AdError
  • Loading a new Source from a PlayerError or a SourceErrorEvent does not work
  • Loading a new Source from a PlaybackFinishedEvent sometimes does not start playback automatically when isAutoPlayEnabled is set to true
  • Unexpected TimeChanged event is emitted between the Play and PlayingEvent when a Source or a Playlist is replayed
  • When our default Bitmoivn Player Web UI is used it could 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

Stable

4/27/2021

3.0.0

V3 of the iOS Player SDK marks a new direction where the player itself and the sources it plays back become more decoupled. Check out the V2 -> V3 Migration Guide for a detailed description and migration steps.

Added

  • Native support for running the SDK on iOS/tvOS simulators on Apple Silicon
  • Player protocol, which replaces the BitmovinPlayer as the main player type
  • PlayerFactory to create Player instances
  • Source protocol as top-level type
  • SourceFactory to create Source instances
  • LoadingState indicating the current state of a Source
  • Player.source that returns the currently active source
  • Player.load(source:) to load a single Source
  • PlaylistConfig to configure playback of multiple sources
  • PlaylistOptions to customize additional playlist behaviour
  • Player.playlist namespace to control playback of multiple sources
  • Player.load(playlistConfig:) to load multiple Sources
  • Player.registerPlayerLayer for custom native UI support using an AVPlayerLayer
  • Player.registerPlayerViewController for custom native UI support using an AVPlayerViewController
  • Player.registerAdContainer for custom native UI support to register the container view which should be used for Ad rendering
  • TweaksConfiguration.seekToEndThreshold to configure the threshold when seeking to the end in seconds
  • The sender to the each PlayerListener method to distinguish which Player emitted an event
  • Events

Changed

  • The BitmovinPlayer framework is now shipped as XCFramework
  • All Configurations were renamed to Config
  • DurationChangedEvent is no longer fired initially
  • Renamed SourceItem to SourceConfig
  • Renamed SourceItem.itemTitle to SourceConfig.title
  • Renamed SourceItem.itemDescription to SourceConfig.sourceDescription
  • Removed SourceConfig.drmConfigs and introduced SourceConfig.drmConfig to only handle a single DrmConfig
  • Removed SourceConfig.progressiveSources and introduce SourceConfig.progressiveSource to only handle a single ProgressiveSource
  • SourceConfig.options is no longer an optional type
  • Renamed BitmovinPlayerView to PlayerView
  • Moved Player.sourceMetadata to Source.metadata
  • Removed BMP prefix from all public types used from Swift
  • Increased minimum required Google Cast SDK version to 4.4.1+
  • Renamed MediaSourceType to SourceType
  • Rewrote all abbreviations and acronyms to follow CamelCase style
  • Renamed RemoteControlAPI to RemoteControlApi
  • Renamed UserInterfaceAPI to UserInterfaceApi
  • CAF is now used as the default cast receiver
  • Bitmovin Player Web UI v3.25.0 is now used as the default UI

Removed

  • Player.setup - Pass the PlayerConfig to the PlayerFactory instead
  • PlayerConfig.sourceConfig - Loading a source from the PlayerConfig is no longer supported
  • ConfigurationUpdatedEvent
  • PlayerView - The BitmovinPlayerView from v2 became the new PlayerView
  • PlaybackType
  • SourceConfig.drmConfigs
  • SourceConfig.add(drmConfig:)
  • Player.streamType - Use SourceConfig.type instead
  • Jsonable implementation
  • All non is* boolean properties on the API when used from ObjC
  • Player.preload
  • iOS/tvOS 10 Support
  • iOS/tvOS 11 Support
  • Support for non CAF Cast Receivers
  • Support for Bitmoivn Player Web UI v2

Fixed

  • AdaptationConfig and NetworkConfig not extending Config
  • CloseButton of the SettingsPanel sliding out of Safe Area in Bitmovin Player Web UI v3
  • Subtitles are rendered very close to the bottom Safe Area in Bitmovin Player Web UI v3

Known Issues

  • Picture in Picture mode is not working on iOS 14.0 and iOS 14.1
  • No StallStartedEvent is emitted when subsequent Sources are not loaded yet when the playback of the previous source ends
  • Subtitles and Audio Tracks from previous Sources are present in the availableSubtilteTracks / availableAudioTracks in subsequent sources
  • Potential crash when the player gets unloaded during an Ad
  • Playback gets stuck when playing a Progressive Ad results in an AdError
  • Loading a new Source from a PlayerError or a SourceErrorEvent does not work
  • Loading a new Source from a PlaybackFinishedEvent sometimes does not start playback automatically when isAutoPlayEnabled is set to true
  • Unexpected TimeChanged event is emitted between the Play and PlayingEvent when a Source or a Playlist is replayed
  • Subtitles are not selectable when playing offline content
  • 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

Deprecated

  • MediaSource, AdaptiveSource, HlsSource, ProgressiveSource and DashSource. SourceConfig should instead be constructed using an url and the according SourceType

Stable

3/9/2022

2.67.4

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 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 (using OfflineManager) are not playable anymore when the device is offline

Stable

10/27/2021

2.67.3

Added

  • PlayerFactory to create Player instances

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 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 (using OfflineManager) are not playable anymore when the device is offline

Deprecated

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

Stable

8/31/2021

2.67.2

Changed

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 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 (using OfflineManager) are not playable anymore when the device is offline

Stable

8/31/2021

2.67.1

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 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 (using OfflineManager) are not playable anymore when the device is offline

Stable

8/19/2021

2.67.0

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
  • OfflineManager.areSuspendedDownloadsRestored property to specify if the OfflineManager has finished restoring suspended downloads

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 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 (using OfflineManager) are not playable anymore when the device is offline

Deprecated

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

Stable

8/3/2021

2.66.1

Changed

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

Fixed

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

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 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 (using OfflineManager) are not playable anymore when the device is offline

Latest Releases

Give us feedback