Limitations and Known Issues
This sections lists any limitations and known issues in the current package version.
Platform support
THEOplayer Flutter SDK is capable of running on
- iOS 13 and above
- Android 5 and above
- Mainstream web browsers (Firefox 120+, Chrome 119+, Safari 17+, Microsoft Edge 119+)
However, it is not optimized for those devices.
For the best experience, we suggest to target
- iOS 14 and above
- Android 10 and above
In a later phase, we will optimize the SDKs for lower operating system versions as much as possible.
Smart TV support
THEOplayer Flutter SDK officially doesn't support Smart TVs. However, if your application is compiled for WEB, it should be able to run on modern Smart TVs (like Tizen 7+ and WebOS 23+) with smaller modifications on how the webapp loads the Flutter library.
Supporting Smart TVs is not a priority for the THEOplayer Flutter SDK (yet).
Platform differences
The underlying native platform SDKs have different feature set. First check the Dart documentation if you see behaviour differences on certain platforms. We try to keep the documentation in sync as much as possible. If you see no difference mentioned in behaviour, please consult with the native SDK documentations.
Live latency configuration
TypedSource.latencyConfiguration configures live playback when the source is loaded. All offsets are expressed in seconds.
| Option | Android | iOS | Web |
|---|---|---|---|
targetOffset | Supported | Supported | Supported |
minimumOffset, maximumOffset, forceSeekOffset | Supported | Ignored | Supported |
minimumPlaybackRate, maximumPlaybackRate | Supported | Ignored | Supported |
lowLatency | Ignored | Ignored | Supported |
On iOS, targetOffset is passed to AVPlayer as its configured time offset from live. AVPlayer will not use a configured offset below its recommended time offset, so very small targets might not be reached.
On iOS, latencyConfiguration is applied when setting a source, but is null in source getters and source-change event payloads for regular sources. OptiView Live sources retain their target latency in these readbacks.
The lowLatency option enables the player's low-latency mode on Web and is required for Low-Latency CMAF with ABR. It is not required to play Low-Latency HLS.
Version limitations
THEOplayer Flutter SDK only compatible with THEOplayer 6.x and above.
UI
Currently, THEOplayer Flutter SDK is completely chromeless, the UI needs to be implemented on top of the public APIs on the Flutter level.
The example project within the SDK package contains a sample UI.
Missing features
THEOplayer Flutter SDK is not in feature parity yet with the native SDKs, new features will be added continuously.
For the current feature list, please visit the README page.