vesper_player_android 0.6.3

Android implementation for Vesper Player, requiring API 26+, arm64-v8a, and a 64-bit app process. 32-bit Android is unsupported.

Changelog

Unreleased

0.6.3 - 2026-09-20

• Check the Android ABI and process bitness before player JNI initialization, returning vesper_unsupported_architecture with runtime details instead of entering JNI class initialization on unsupported devices.
• Clarified that Android API 26+, arm64-v8a, and a 64-bit app process are required.

0.6.2 - 2026-09-18

0.6.1 - 2026-09-18

0.6.0 - 2026-09-17

• Added per-platform-view geometry channels and native media dimensions.

• Preferred video dimensions for PiP, refreshed automatic-entry parameters, fixed multi-session ownership, and clamped rational ratios inside OS limits.

• Preserved cleared command errors during native snapshot publication.

• Added native source/output generations and lifecycle invalidation for source, track, Surface, display, PiP and disposal changes; late observation results are rejected by player instance and generation.

• Reported HDR output as unknown with outputObservationUnavailable in snapshots; display and codec capabilities do not confirm active output.

0.5.6 - 2026-09-16

• Raised the minimum supported Flutter toolchain to 3.47.2 and compileSdk to 37 while retaining minSdk 26.

0.5.5 - 2026-09-16

• Updated the Android host kit to 0.5.5 with verified plugin registry handles and bounded EventHook shutdown; consumer Kotlin tooling now uses 2.4.20.

0.5.4 - 2026-09-09

• Updated the Android host-kit constraint to 0.5.4, whose AARs retain the Kotlin 2.2.10 compiler metadata baseline for AGP 9.1 consumers.

0.5.3 - 2026-09-09

• Prepared package metadata for the 0.5.3 release.

0.5.2 - 2026-09-03

• Prepared package metadata for the 0.5.2 release.

0.5.1 - 2026-09-01

• Prepared package metadata for the 0.5.1 release.

0.5.0 - 2026-08-29

• Prepared package metadata for the 0.5.0 release.

0.4.3-rc.1 - 2026-08-17

• Prepared package metadata for the 0.4.3-rc.1 release.

0.4.2 - 2026-08-16

• Prepared package metadata for the 0.4.2 release.

0.4.1 - 2026-08-14

Added

• Added MethodChannel mapping for external subtitle configurations and setSubtitleStyle, backed by the Android host-kit cue overlay.
• Added complete RTMP, RTSP, and HTTP-FLV protocol wire mapping.
• Added track support, catalog revision, playback-path, and structured fixed-track error mapping for the Android wire contract.

Breaking Changes

• The Android plugin package moved to io.github.umbrella22.vesper.player.flutter.android; its channels moved to io.github.umbrella22.vesper_player and related suffixes. No old package or channel aliases are registered.
• The Android Flutter implementation now requires Flutter 3.44.0 or newer.
• Subtitle MethodChannel calls now wait for the suspending Android host API and return vesper_subtitle_error details on failure.
• renderSurfaceKind: auto now selects SurfaceView. Pass textureView explicitly for overlay-heavy, scrolling, clipping, rounded-corner, or animation-heavy screens that need the previous composition behavior.

Changed

• Android build tooling now uses Kotlin 2.4.10, AndroidX Activity 1.13.0, and kotlinx.coroutines 1.11.0.
• Picture in Picture failures now emit PiP-specific events and method errors without publishing generic player errors.
• setAbrPolicy now forwards the optional expected catalog revision and keeps native fixed-track capability details in the returned platform error without misclassifying generic ABR command failures as fixed-track rejections.
• Android PiP state now follows Activity mode-change callbacks, with best-effort foreground restore for exitPictureInPicture.
• Subtitle snapshots now carry canonical catalog/selection state and requested/confirmed/effective selection fields.

Fixed

• Source and seek MethodChannel calls now await Android host-kit readiness or seek completion. Structured obsolete command failures are returned to Dart without publishing a player error for the current session.

0.3.0 - 2026-05-18

Changed

• Optional Android external playback is now provided by vesper-player-kit-external-playback instead of separate Cast, DLNA, and relay host-kit modules.

0.2.0 - 2026-05-13

Breaking Changes

• The Android Flutter implementation no longer imports Android host-kit Native*, bridge, or JNI implementation types. Runtime snapshots read backendFamily from the public VesperPlayerController.backendFamily API.
• renderSurfaceKind is decoded to the public VesperVideoSurfaceKind facade. Host integrations that referenced Android internal surface types must switch to VesperPlayerRenderSurfaceKind on Dart and VesperVideoSurfaceKind on Android.