What's New

The shortform API (ShopLiveShortform) is removed, and the minimum iOS version is now 15.0. Remove your shortform code before you upgrade (or stay on 1.8.14), and set platform :ios, '15.0' in ios/Podfile.

• Updated the bundled Shoplive iOS and Android SDKs to 1.9.0
• On Android, the SDK now comes from https://sdk.shoplive.cloud/maven-repo. If your project declares repositories itself, add this repository
• This is a maintenance release of the 1.x line. For a new integration, use 3.0.3

ShopliveConfiguration.appVersion is removed, and ShopliveError and its error codes moved to the core package (cloud.shoplive.core.publicsurface). Delete the appVersion argument and update your imports. Recompile code built against 3.0.2.

• Added DEFAULT and PREVIEW presets to ShoplivePlayerConfiguration and ShoplivePlayOptions
• PipOptions.isDragOutToCloseEnabled (default true) controls whether dragging the in-App PIP window off screen closes it
• Pass webPageUrl to ShopliveStreamer.start to add your own web page next to the broadcast screen. The web player's user-action logs arrive as WebCommandReceived (EVENT_LOG)
• Coupon and custom-action results now default alertType to ALERT. Pass null to follow the web default
• The separate WebRTC, RTMP, ExoPlayer and media3 artifacts are no longer published, and ExoPlayer 2 is no longer supported

The 1.x Dart API is removed. Read the migration guide in the release notes before you upgrade.

• Split into three packages: shoplive_core · shoplive_player · shoplive_streamer (keep all three on the same version)
• Every method returns a Future, and failures arrive as a PlatformException with an error code
• Answer coupon and custom-action requests with respond
• Fixed playback stopping when the player switched to in-app PIP on Android
• Requirements: Flutter 3.22 · Dart 3.4 · iOS 15 · Android minSdk 23

ShopliveStreamer.intent(...) is removed. Switch to prepareIntent and start the Intent passed to its callback.

• Leaving the app no longer destroys the player — HLS pauses and resumes, WebRTC reconnects on return
• Volume-key and audio-focus options (sound.isVolumeKeyEnabled · sound.autoResumeOnFocusGained) now take effect
• Ending a broadcast stays on the same screen, and a fatal error offers retry or exit
• The WebView native bridge works only on Shoplive pages

The minimum iOS version is now 15.0 (was 11.0).

• Player and Common now ship from one repository (shoplive-sdk-ios). ios-sdk and common-ios stay at 1.8.15
• The Swift Package Manager product is renamed from ShopLive to ShopLiveSDK (the CocoaPods pod is still ShopLive)
• No API changes — on 1.8.11 or later, bumping the version is the whole migration
• Fixed custom-action SHOW and KEEP responses being ignored

In fullscreen, the back button now shrinks the player to in-app PIP instead of closing it. Set pip.isInAppPipEnabled = false to restore close-on-back.

• In-app PIP: playback continues in a draggable mini window over your screens. Start straight into it with ShoplivePlayOptions(presentationStyle = ShoplivePlayerPresentationStyle.PIP)
• Private broadcasts: playback and PIP stay blocked until the entry code is accepted
• AndroidX Media3 is now the default HLS engine (ExoPlayer 2 is still available — pick one)
• New error codes (9510–9514) tell you why OS PIP is unavailable
• Fixed appearance.allowScreenCapture = false not blocking screen capture, and navigation.actionOnNavigation having no effect

The SDK is distributed from the Shoplive Maven repository (https://sdk.shoplive.cloud/maven-repo), since 1.8.13. Add the repository, and declare each artifact you use because the POMs carry no transitive dependencies (shoplive-common, shoplive-network, shoplive-sdk-core, and so on).

• Added the campaign list API ShopLiveCampaigns.getCampaigns. Query campaigns and their progress state from the app with no server integration (status filter, pagination, sorting, cancellation) — use it for a live badge on your home screen
• A single onClose handler now receives both preview and OS PIP close events, with the reason, exactly once per screen
• Fixed playback stalling near the end of a replay, swipe-to-close not delivering the close callback, and the close callback firing twice

Artifact coordinates and the public API changed. Declare cloud.shoplive:shoplive-player-sdk and/or shoplive-streamer-sdk; everything else comes transitively.

• Player settings now go in one ShoplivePlayerConfiguration value instead of individual setters
• sound.mixWithOthers now defaults to false, so playback interrupts other apps' audio. Set it to true to keep mixing
• The streamer can broadcast over RTMP, chosen by the campaign configuration
• Fixed sound.muteOnStart being ignored and a black screen instead of the background image when a broadcast ended, among others