ogplayer_flutter 1.6.1

OGPlayer — a full-featured video player SDK for Flutter wrapping the native OGPlayer Android and iOS players: HLS/DASH, DRM, IMA ads, downloads, playlists, PiP, themeable UI.

1.6.1

Wraps OGPlayer Android 1.6.0 and OGPlayer iOS 1.6.0.

Changed

• Supports Flutter 3.29 / Dart 3.7 and newer, as documented.
• Android hosts build on Android Gradle Plugin 8 or 9; on AGP 8 the plugin applies the Kotlin Android plugin itself.

Drop-in for 1.6.0. No API changes.

1.6.0

Wraps OGPlayer Android 1.6.0 and OGPlayer iOS 1.6.0. Every word the player chrome shows or speaks can now be supplied from Dart: one OGStrings value, English by default, applied to the controls, the menus, the live chip, the ad bar, the error overlay and the vertical feed on both platforms.

Added

• OGStrings — a const class with every chrome string as an optional field (unset keys stay English) and OGStrings.fromMap(Map<String, String>) for a flat map shared with other platforms (unknown keys are ignored). Placeholders are {name} tokens ({seconds}, {title}, {n}, {code}, {device}, {speed}, {height}, {index}, {count}, {name}, {channels}).
• OGUIConfig.strings — the player chrome, including every spoken label.
• OGVerticalFeedConfig.strings — the feed's play label, "Sponsored", the error copy and Retry.
• OGUIConfig.locale — accepted for parity with the web SDK; the native players name tracks their own way.
• The existing options keep precedence: errorMessages over the generic error text, retryButtonLabel over the Retry label, upNextText over the up-next card.
• OGPlayerViewController.getLiveInfo() → Future<LiveInfo?> — the live stream's DVR window, live-edge state, distance behind the edge and the playhead's wall-clock time (playheadWallClockMs), so an app can show how far behind real time the viewer is watching; null for VOD.

Added — theming tokens

• OGUIConfig.colors (OGControlColors) and OGUIConfig.dimens (OGControlDimens) — the native chrome's colour and size tokens under the same names as in the native SDKs: 16 colours (#RRGGBB or #AARRGGBB) and 23 sizes (dp / pt), each documented with its default; unset tokens keep the SDK default. Ten of the sizes shape the embedded chrome; the players keep their own values in fullscreen. An invalid value is skipped, never fatal.

Accessibility

• Every control now carries a spoken label on both platforms (TalkBack and VoiceOver): play, pause and replay, the seek buttons with their step, volume, speed, quality, audio, subtitles and fullscreen; the scrub bar and the volume slider report their position; the LIVE chip announces "Go to live"; the volume button offers Mute / Unmute; the up-next card announces the next title.

Changed

• Playback speeds read 1.5×; an audio track that shares its name with another reads Name · 6ch.

Drop-in for 1.5.0: all additions are additive.

1.5.0

Wraps OGPlayer Android 1.5.0 and OGPlayer iOS 1.5.0. Maintenance release.

Drop-in for 1.4.1. No API changes.

1.4.1

Wraps OGPlayer Android 1.4.1 and OGPlayer iOS 1.4.1. Bug fixes.

1.4.0

Wraps OGPlayer Android 1.4.0 and OGPlayer iOS 1.4.0. Bug fixes and improvements.

Drop-in for 1.3.1. No API changes.

1.3.1

Wraps OGPlayer Android 1.3.1 and OGPlayer iOS 1.3.1.

Added

• A tap on a playing ad pauses it and brings up the play glyph; the glyph resumes the ad and leaves with it. Learn more (the ad's clickthrough) pauses the ad while the browser covers the app and resumes it when the viewer comes back. onAdEvent reports the click as type clicked.
• OGPlayerController.skipToPrevious() goes back one playlist item, the counterpart of skipToNext().

Changed

• Nothing is drawn over a playing ad: the play glyph appears only while the ad is paused.

Drop-in for 1.2.3. Additive; no existing API changes.

1.2.3

Wraps OGPlayer Android 1.2.2 and OGPlayer iOS 1.2.2.

Fixed

• iOS: the player now keeps a single view controller for its lifetime. Leaving fullscreen, or changing uiConfig, while a Google IMA ad is on screen keeps IMA's ad UI attached for the rest of the ad session and no longer terminates the app.

Drop-in for 1.2.2. No API changes.

1.2.2

Wraps OGPlayer Android 1.2.2 and OGPlayer iOS 1.2.2.

Changed

• Android engine updated to Media3 1.11.1 (renderer pre-warming, live timelines with server-side ads, audio offload, HLS end-of-stream retries).
• Player chrome on both platforms: an option button (speed, quality, audio, subtitles) is drawn white whenever it is shown; only a button with nothing to offer — one audio track, no text tracks, a single quality — is dimmed. The current selection is shown in the button's menu.

Drop-in for 1.2.0. No API changes.

1.2.0

Wraps OGPlayer Android 1.2.0 and OGPlayer iOS 1.2.0.

• PlaybackRecoveredEvent (reason, positionMs): the player reports the recoveries it performs on its own, so your analytics can count them. RecoveryReason says why. Android; on iOS these show as a BufferStart/BufferEnd pair.
• FairPlayConfig.renewalInterval: for license servers that lease FairPlay keys for a fixed time, set it a little under the lease and the key is renewed in the background through your token provider.
• Long DRM sessions on Android: a license that expires mid-stream is renewed and playback resumes at the same position; at most a PlaybackRecoveredEvent, never an error.
• Leaving a player screen no longer changes the orientation of the screen that follows it.

Additive — safe upgrade from 1.1.1.

1.1.1

• Example app: a real README (the 1.1.0 example shipped the Flutter template text).
• No code changes — safe upgrade from 1.1.0.

1.1.0

Initial release — wraps OGPlayer Android 1.1.0 and OGPlayer iOS 1.1.2.

• OGPlayerView widget + OGPlayerViewController: VOD/live/live-DVR, multi-DRM with a Dart tokenProvider, Google IMA ads, playlists with the "Up next" card, picture-in-picture, subtitles/audio/quality selection, fullscreen (button + rotate), watermark overlays, full chrome configuration down to headless.
• OGVerticalFeedView widget: the SDK's swipeable portrait video feed — pooled preloaded neighbours, split text/video layouts, sponsored items, host-owned rail actions — with OGVerticalFeedItem, OGVerticalFeedConfig, FeedRailAction, OGFeedContentFit, OGFeedTextPlacement and OGFeedSplitAudioSource.
• OGDownloads: offline downloads with offline DRM, license renewal, and a broadcast event stream.

iOS host requirements (see the README): forward application(_:supportedInterfaceOrientationsFor:) to OgplayerFlutterPlugin.interfaceOrientationMask for fullscreen/rotate, and application(_:handleEventsForBackgroundURLSession:completionHandler:) to OgplayerFlutterPlugin.handleDownloadBackgroundEvents so downloads that finish while the app is not running complete.