Shoplive Developers — What's New

[New] Flutter SDK 3.0.3 — streamer web page · drag PIP out to close

Tue, 20 Oct 2026 09:00:00 +0900

Built on Shoplive iOS and Android SDK 3.0.3. There is no Dart breaking change from 3.0.2; update all three packages to the same version
Use ShopliveStreamer.instance.start(campaignKey, webPageUrl: …) to attach a web page next to the broadcast screen. An invalid URL fails with INVALID_ARGUMENT
Use ShoplivePipOptions.isDragOutToCloseEnabled to set whether dragging the in-app PIP window off the screen closes it
Calling start again while a session is open now opens a new player with the new configuration. To change the campaign and keep the current settings, use play
If you omit alertType in a coupon or custom-action response, both platforms now use toast
ShopliveConfiguration.appVersion is ignored (the SDK reads the app version itself). ShopliveError.rawCode is now set on both platforms

[Breaking] Flutter SDK 1.9.0 — shortform API removed · iOS 15 minimum

Tue, 20 Oct 2026 09:00:00 +0900

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

[New] iOS SDK 3.0.3 — preview stream · web page on the broadcast screen

Fri, 16 Oct 2026 09:00:00 +0900

Set ShoplivePlayerConfiguration.type to .preview to play the campaign's low-resolution preview stream. The ShoplivePlayerConfiguration.preview preset now uses it
pip.isDragOutToCloseEnabled (default true) controls whether dragging the in-App PIP window off screen closes it. With false it snaps back, and only the close button or close() ends it
ShopliveStreamerViewController(campaignKey:webPageURL:) adds your own web page next to the broadcast screen
ShopliveError.rawCode returns the original numeric error code. Coupon and custom-action results now default status to .hide and alertType to .alert
Playback that starts muted no longer interrupts other apps' audio, and reload() during in-App PIP keeps the PIP window

[Breaking] Android SDK 3.0.3 — presets · web page on the broadcast screen

Fri, 16 Oct 2026 09:00:00 +0900

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

[Breaking] Flutter SDK 3.0.2 — rebuilt on Shoplive SDK 3.0.2

Thu, 15 Oct 2026 09:00:00 +0900

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

[Improved] Web live player — October update

Mon, 12 Oct 2026 09:00:00 +0900

Completing an attendance check (Streak) now shows a completion toast with an entrance effect
The default desktop size of live captions on landscape broadcasts is smaller (2× → 1.25×), so they cover less of the video

[Improved] Android SDK 1.9.0 (V1 · Shortform)

Thu, 08 Oct 2026 09:00:00 +0900

A popup preview now closes as soon as the broadcast ends, with ON_BROADCAST_ENDED as the reason — the same as iOS
The preview bottom margin is now measured from the top of the navigation bar on every device. If you added the status bar height to the margin, remove it
The shortform preview opens at 9:16 instead of square
Fixed your app coming back to the front with OS PIP when leaving with the Home button or gesture

[Fixed] Web shortform — October update

Tue, 06 Oct 2026 09:00:00 +0900

Fixed a flicker when opening a shortform detail for the first time in iOS and macOS Safari

[Improved] iOS SDK 3.0.2

Thu, 01 Oct 2026 09:00:00 +0900

Added ShoplivePlayerEvent.webCommand(name:payload:) for commands sent by the web overlay. If you switch over every case, add this one
In the WebView, SDK features work only on Shoplive pages (no code change)
A malformed access key is not used, and an error is logged
The screen stays awake while the broadcast screen is shown
Removed repeated stateChanged notifications, stop() now reports closed, and closing system PIP no longer leaves a black screen

[Breaking] Android SDK 3.0.2

Thu, 01 Oct 2026 09:00:00 +0900

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

[New] Web live player — September update

Wed, 30 Sep 2026 09:00:00 +0900

Co-hosted broadcasts: when several hosts broadcast together, the player marks who is speaking
Live Streak: viewers can check in for attendance during a broadcast
Broadcasts with live captions can show them as soon as the viewer enters (admin setting). Caption size on landscape broadcasts follows the screen orientation and device
The ready screen shows a countdown to the start of the broadcast
Where the browser has no PIP support, the player falls back to web PIP
Fixed banners not navigating in the Instagram in-app browser, the replay seek bar misbehaving, and the caption button showing on replays of broadcasts without captions

[New] Web shortform — September update

Wed, 23 Sep 2026 09:00:00 +0900

Story: new setShortformStory shows shortforms in an Instagram-style round tray. A story is marked as seen when its card is tapped
Shortform details now show the viewer count
Fixed a gray screen when returning to a collection preview, and showcases not attaching to products added later by "load more"

[Breaking] iOS SDK 1.9.0 (V1)

Mon, 14 Sep 2026 09:00:00 +0900

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

[Breaking] Android SDK 3.0.1 — in-app PIP · private broadcasts

Mon, 07 Sep 2026 09:00:00 +0900

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

[Breaking] Android SDK 1.8.14 (V1)

Mon, 31 Aug 2026 09:00:00 +0900

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

[New] Web live player — August update

Thu, 27 Aug 2026 09:00:00 +0900

Join notices: chat announces viewers as they join, and shows a notice when a prize draw starts
Winner results: anonymous winner totals, an option to hide the winner list, and winner name masking
Coupon popups can copy a code to the clipboard
Captions: two-line replay captions and SRT captions for recorded-video broadcasts, long captions split and paced in order, a "caption" icon instead of CC in the Korean UI, and captions shown automatically while muted (admin setting)
Switching product groups now scrolls the product list to the top, and fixed the resolution option missing on some replays

[New] iOS SDK 3.0.1 — start previews in in-app PIP

Wed, 26 Aug 2026 09:00:00 +0900

Set ShoplivePlayOptions.presentationStyle = .pip to open playback straight in the floating in-app PIP window. The preview presets (PIP start, muted, overlays hidden) replace the 2.x preview popup. .fullScreen stays the default
Swipe an in-app PIP window off screen to close it
The campaign's live badge is drawn over in-app PIP
Private broadcasts with an entrance code play on both HLS and WebRTC
Fixed a crash when the player's WebSocket was torn down while a message was being delivered

[Breaking] Android SDK 3.0.0 — first unified SDK release

Wed, 19 Aug 2026 09:00:00 +0900

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

[New] Flutter SDK 1.8.14

Fri, 14 Aug 2026 09:00:00 +0900

Added ShopLivePlayer.setResizeMode() to set how the live player fits the screen (auto · centerCrop · fit)
Updated the bundled Shoplive iOS and Android SDKs to 1.8.13

[Improved] Web shortform — August update

Tue, 11 Aug 2026 09:00:00 +0900

Added a URL mode that links showcases by product URL, with UX improvements
Initialization is refused for an expired access key

[Breaking] iOS SDK 3.0.0 — first unified SDK release

Fri, 07 Aug 2026 09:00:00 +0900

The 2.x public API is replaced, and the minimum iOS is 15.0. Declare only the Swift Package Manager products ShoplivePlayerSDK and/or ShopliveStreamerSDK.

Present ShoplivePlayerViewController or embed ShoplivePlayerView, configured with one ShoplivePlayerConfiguration
The delegate is down to two methods (didReceive for notifications, didRequest for requests), and the entry point is one Shoplive.initialize · setUser … surface (Swift only)
Errors arrive as ShopliveError with a ShopliveErrorCode
The streamer also broadcasts over RTMP and asks for camera and microphone permission when the broadcast screen opens

[New] Web live player — July update

Fri, 31 Jul 2026 09:00:00 +0900

Emoji button: viewers can react with emoji
URLs in popup text and in operator chat messages now open the linked page
New option to show live Q&A replies inside the chat list
Chats hidden by AI chat moderation can be restored, and image clicks in the winner-results replay sheet are reported as events
Winner announcements now work on every theme, with more languages
Fixed captions drifting after switching tabs, long captions without spaces overflowing, and the winner announcement misfiring for viewers who join mid-broadcast

[New] Web shortform — July update

Thu, 30 Jul 2026 09:00:00 +0900

Showcase: new embedded showcase player for product pages (setShortformShowcase)
Fixed collection details always playing the first video, and the cover thumbnail disappearing on collections with preview playback turned off

[Improved] Flutter SDK 1.8.13

Thu, 09 Jul 2026 09:00:00 +0900

Updated the bundled Shoplive iOS and Android SDKs to 1.8.11. No Dart API changes