Wowza Flowplayer Apple SDK release notes
v4.7.1
The Wowza Flowplayer Apple SDK includes a native media player written entirely in Swift. The SDK provides an easy-to-use API that enables developers to create iOS and tvOS applications that use the Wowza Flowplayer to play audio and video locally and over the internet.
You can refer to this page for information about software updates, including new features and improved functionality.
info
We occasionally have internal releases that don't impact external audiences, so we don't publish release notes for internal changes. In these cases, the current version information on this page may not match the latest release note. For more information about release versions, see GitHub releases.
- See Wowza Flowplayer release notes for more.
- See Wowza Flowplayer Android SDK release notes for more.
New features and functionality
August 15, 2024
- Implemented code signing for our XCFrameworks to verify the origin and enhance the security of our Apple SDK. For steps to inspect the code signature, see Verifying the origin of your XCFrameworks . We provide the fingerprint for each release in our apple-sdk repository.
July 3, 2024
Wowza Flowplayer Apple SDK v4.7.0
We added Google Interactive Media Ads Dynamic Ad Insertion (IMA DAI) SDK support to the Wowza Flowplayer Apple SDK. With this update, you can use the IMA DAI SDK to inject server-side ads into your player and your iOS and tvOS applications. We support both Full service and Pod serving DAI solutions from Google.
info
DAI Pod Serving is a beta intended for Ad Manager publishers and video technology partners who either have an in-house manifest manipulation service or are currently using third-party manifest manipulation that's already integrated with DAI.
For more details about this feature and how to work with it, see the following articles:
- Load DAI media
- Server-side ad insertion for iOS
- Server-side ad insertion for tvOS
- Listen to events with the FlowplayerDAIDelegate
- Listen to events with DAI stream notifications
- Manage media playback > FlowplayerAPI methods
- Handle DAI stream errors with the AdError type
- Supported features > Bookmarking for iOS
- Supported features > Snapback for iOS
- Supported features > Bookmarking for tvOS
- Supported features > Snapback for tvOS
Additionally, our iOS demo application and tvOS demo application were updated with DAI VOD and live stream examples.
April 2, 2024
Wowza Flowplayer Apple SDK v4.6.4
- Updated the Google IMA SDK for iOS dependency to version 3.20.0. For more, see Client-side ad insertion for iOS .
- Updated the Google IMA SDK for tvOS dependency to version 4.11.1. For more, see Client-side ad insertion for tvOS .
February 16, 2024
Wowza Flowplayer Apple SDK v4.6.2
-
Fixed an issue related to the
WebViewControls
implementation that could affect memory and crash the SDK when too many events are emitted.
January 30, 2024
Wowza Flowplayer Apple SDK v4.6.1
-
Fixed an issue related to the
WebViewControls
implementation that causedArrayBuffer
overflow and runtime errors.
January 17, 2024
Wowza Flowplayer Apple SDK v4.6.0
- Overhauled how we report ad errors and improved debugging to better identify issues that cause ads not to be displayed.
-
Added a new
IMAMetadata
object that contains valuable metadata about the current Interactive Media Ads (IMA) instance responsible for showing the ads.
The following pages were updated due to changes in this release:
- FlowplayerAdDelegate
- Advertisement notifications
- iOS features > Client-side ad insertion
- tvOS features > Client-side ad insertion
- Error handling > IMAMetadata object
December 20, 2023
Wowza Flowplayer Apple SDK v4.5.0
-
Fixed an issue with WebView controls that prevented the mute button from reflecting the correct state when toggling the
isMuted
property. -
Fixed an issue with the
AdScheduleWaterfall
andAdScheduleRemote
initializers to make them public. For more, see Client-side ad insertion .
December 1, 2023
Wowza Flowplayer Apple SDK v4.4.0
-
Added
support for a new iOS and tvOS feature
that better handles multiple player instances when they're incorporated in the same view simultaneously. For more, learn how to work with
multiple players in your iOS
or
multiple players in your tvOS
applications. As part of this enhancement, the following changes were made to the Wowza Flowplayer Apple SDK:
- Fixed an issue with incorrect progress bar displays when multiple player instances exist in the same view.
- Improved the example application to include a demonstration of working with multiple player instances.
-
Added a new
id
property to theFlowplayerAPI
protocol that can be used to identify a specific instance of the player. For more, see Flowplayer API properties . -
Updated notification events sent from the
FlowplayerAPI
protocol andFlowplayerView
andAdService
classes to includeuserInfo
with player ID that triggered the notification.
-
Fixed an issue causing the player to resume playback automatically after it's paused and moved to the background. As part of these changes, we:
-
Added a new
background
playback state to better indicate the player's paused state. -
Disabled the player's previous behavior that automatically resumed playback when its
enableBackgroundPlayback
wasfalse
and the player was in thepause
state. -
Improved the example application to showcase this new behavior for the
background
playback state. -
Updated the
Background playback
page to include an example of how to listen to the new
background
playback state and resume video play when an app returns to the foreground.
-
Added a new
November 7, 2023
Wowza Flowplayer Apple SDK v4.3.2
This release contains internal changes and minor fixes that don't affect the public API. For more, see the changelog.
November 3, 2023
Wowza Flowplayer Apple SDK v4.3.1
-
Fixed an issue that cleared the player's state when it was forcefully stopped or halted. For more, read about the
stop()
method in the Flowplayer API Methods section.
October 30, 2023
Wowza Flowplayer Apple SDK v4.3.0
-
Added a new
halted
player state. This state is emitted when playback is forcefully aborted using thestop()
method. For more, see the FlowplayerAPI Methods section. -
Fixed a previous limitation so there's no longer a need to use the
stop()
method when destroying the player. The player now uses Swift's Automatic Reference Counting (ARC) to automatically destroy itself. -
Fixed the player so it doesn't discard the
idle
state from thestateList
after the initial load. -
Fixed the player so it reports a
failure
instead of anidle
state when playback is unsuccessful. - Fixed the internal logger which was creating a zombie object that could lead to memory leaks or unexpected behaviors.
October 19, 2023
Wowza Flowplayer Apple SDK v4.2.2
-
Fixed an issue with the
WebViewControls
class that caused controls to freeze when returning from the background to the foreground. - Fixed an issue with some player events that were not properly triggered on iOS 16 and iOS 17.
October 12, 2023
Wowza Flowplayer Apple SDK v4.2.1
-
Fixed an issue with
ControlsConfig.Builder.setMuteControl()
method since it did not respect the set value. -
Deprecated the
ControlsConfig.Builder.setVolumeControl()
method that toggles volume control visibility for the player's built-in controls.
October 3, 2023
Wowza Flowplayer Apple SDK v4.2.0
-
Added a new error case to capture when the player fails if used with
MediaOVP
. - Fixed an issue with a memory leak caused by an internal service.
September 28, 2023
Wowza Flowplayer Apple SDK v4.1.1
- Fixed an issue with the controls where the subtitles and audio picker didn't display.
-
Fixed an issue with
FlowplayerDelegate
not being called for certainmute
,volume
, andrate
events.
September 21, 2023
Wowza Flowplayer Apple SDK v4.1.0
- Updated the Apple SDK to be compatible with Xcode 15. For updates, see About the Apple SDK .
- Updated the Apple SDK to allow developers to use the Wowza Flowplayer while creating applications for iOS 17 and tvOS 17.
- Updated the Google IMA SDK for tvOS from version 4.8.2 to version 4.9.2. For updates, see iOS > Client-side ad insertion and tvOS > Client-side ad insertion .
-
Fixed AdService to report the proper
AdType
during theload
event.
August 23, 2023
Wowza Flowplayer Apple SDK v4.0.0
We released version 4.0 of our updated Wowza Flowplayer Apple SDK, which fully leverages Swift for seamless platform integration with your iOS and tvOS applications. The redesigned SDK architecture promises enhanced stability, fewer bugs, and improved maintainability while delivering an optimized user experience. Specific improvements include:
- Optimization and efficiency — New multi-platform architecture for more efficient code deployments and a reduction in our code base.
- Enhanced development experience — Improved clarity and quality of documentation, with out-of-the-box support for DocC reference documentation. Developers can also leverage a richer, more intuitive API, using a multi-faceted SDK setup.
- Flexibility and compatibility — Proper segregation of the core player and UI framework, with enhanced event observation.
- Integrated tools and support — Plug-and-play development setup with demo applications and integration of Swift Package Manager support.
To get started with the new Apple SDK, see About the Apple SDK.
May 8, 2023
Wowza Flowplayer iOS v3.5.0 and Flowplayer tvOS v1.2.0 SDK
- Improved the experience for iOS SDK users by better differentiating between a live stream and other types of media. As part of these enhancements, we fixed an issue with the iOS SDK that incorrectly displayed a progress bar with seeking ability when playing a live stream.
- Integrated the embed service API to work seamlessly with the iOS and tvOS SDKs. This change allows the SDK to accurately fetch player configurations. It also enables long-term stability for the SDK when relying on Wowza Video as the media source.