Wowza Flowplayer Apple SDK release notes


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.


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.

New features and functionality

April 2, 2024

Wowza Flowplayer Apple SDK v4.6.4

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 caused ArrayBuffer 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:

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 and AdScheduleRemote initializers to make them public. For more, see Advertisements .

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 the FlowplayerAPI 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 and FlowplayerView and AdService classes to include userInfo 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 was false and the player was in the pause 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.

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 the stop() 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 the stateList after the initial load.
  • Fixed the player so it reports a failure instead of an idle 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 certain mute , volume , and rate 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 Advertisements and tvOS Advertisements .
  • Fixed AdService to report the proper AdType during the load 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.