- Print
Android Changelog
- Print
v1.8.14 (2026-08-31)
Distribution
The SDK is no longer published to mavenCentral. It is now distributed from the Shoplive Maven repository (https://sdk.shoplive.cloud/maven-repo).
These POMs carry no transitive dependencies, so declare each artifact you use. shoplive-exoplayer and shoplive-media3 are alternative player backends — pick ONE of the two.
See the Step1. Installing the SDK guide for a full dependency example.
Common
A campaign list API has been added (ShopLiveCampaigns.getCampaigns). Broadcast status can be checked with an access key alone.
Player
Fixed an issue where replay playback stalled just before the end while the play/pause button toggled on its own.
Preview
Fixed an issue where the close listener was not called when a preview was dismissed by swiping.
Fixed an issue where the close button called onClosed twice.
setOnCloseActionListener has been added to receive the close reason.
PIP
ShopLiveHandler.onClose has been added to receive both IN_APP_PIP(Preview) and OS-PIP close events in one place.
Fixed an issue where the close callback and PIP transition events fired twice on Android 8.0-10.
Fixed an issue where the close notification was missing when the screen was replaced by play() during OS-PIP.
We recommend verifying the overall Preview/PIP close notification behavior.
v1.8.13 (2026-07-30)
Preview
Restored delivery of the State.STATE_IDLE state on Preview release().
We recommend verifying overall Preview behavior.
v1.8.12 (2026-07-28)
Preview
Removed an unnecessary gradient that appeared during PreviewPlayer/IN_APP_PIP(Preview) video playback.
Preview PlaybackEvent has been added.
Fixed onRended to guarantee that isPlaying() returns true.
Fixed an issue where the broadcast image did not appear in certain environments.
We recommend verifying overall Preview behavior.
v1.8.11 (2026-07-09)
Preview
PreviewPlayer/IN_APP_PIP(Preview) now shows the background image during a broadcast.
Strengthened error handling (9101/9102) for cases where video cannot be played while watching a broadcast.
Player
Strengthened error handling (9101/9102) for cases where video cannot be played while watching a broadcast.
v1.8.10 (2026-07-06)
Preview
ShopLive.close() now also closes IN_APP_PIP(Preview).
v1.8.9 (2026-07-03)
Preview
showPreviewPopup no longer recreates the preview when the same campaignKey is used.
You can now determine that a preview closed because the broadcast ended.
The CLOSING state has been added to onCampaignListener for a broadcast ending in five minutes.
v1.8.8 (2026-06-18)
target SDK 36 has been applied.
Preview
A listener for close-button clicks has been added to IN_APP_PIP(Preview).
Player
A listener for OS-PIP close has been added.
v1.8.7.1 (2026-05-28)
Preview
Removed the main-thread restriction when querying playback state information on Preview.
v1.8.7 (2026-05-27)
Preview
An interface for querying playback state information has been added to Preview.
v1.8.6 (2026-04-28)
Preview
Fixed an issue where listeners conflicted when customAction was overridden on Preview.
Player
Fixed an issue where the video aspect ratio was displayed incorrectly when switching to OS-PIP right after the draw-over-other-apps permission was granted.
ShopLive.startPictureInPicture(true) has been added; we recommend verifying PIP transition behavior right after that permission is granted.
The InAppPIPMode feature has been removed.
We recommend verifying overall Preview behavior.
Private mode has been applied.
Theme / Dependency
The theme value has been reverted to its previous behavior, and setSystemBarColor has been fixed to work correctly.
Please check the colors of the status bar and navigation bar and whether your theme is applied.
v1.8.4 (2026-02-19)
Preview
Fixed an issue where a preview intermittently disappeared on double tap.
Player
Fixed an issue where the share button did not work.
If you override handleShare, we recommend verifying that sharing works correctly.
Fixed an issue where handleNavigation was not called on a product click while in the ActionType.CLOSE state.
If you use that type, we recommend verifying the flow of your handleNavigation override.
Addressed the deprecation of the onBackPressed API.
If you depend on androidx.activity:activity-compose, we recommend verifying that ShopLive.setEnterPipModeOnBackPressed(true) works correctly.
v1.8.3 (2026-01-15)
Player
Some bugs have been fixed and stability has been improved.
v1.8.2 (2025-12-11)
Preview
Some bugs have been fixed and stability has been improved.
v1.8.1 (2025-11-27)
Preview
The offset, blur, color, and shadow options of the close button can now be customized.
Player
Improved the top back-button click so that PIP transition is also possible for broadcasts that are ending or being prepared.
PIP
In addition to OS PIP, a customizable PIP that persists for the lifetime of the app has been added.
Permission
ShopLivePermissionManager has been added to make it easy to use the overlay permission required to avoid BAL issues.
v1.8.0 (2025-10-30)
Preview
A custom PIP feature has been added.
A LIVE badge, bottom marketing text, and similar elements can be inserted into the LIVE Preview/PIP.
Player
Fixed an issue where the bottom navigation appeared overlapped on emulators.
Fixed an issue where a destroy warning appeared when moving from Player to WebView.
v1.7.9 (2025-10-02)
Preview
A broadcast status check has been added to the preview popup (in-app PIP).
v1.7.8 (2025-09-18)
Shortform
Fixed an issue where the Player did not load when entering the player from a preview.
The file provider path has been changed.
A feature for querying a collection with only a ShortsId has been added.
Common
The proguard / consumer rule set has been changed.
v1.7.7 (2025-09-04)
inAppPip allocation has been optimized.
Fixed an issue where the bottom navigation overlapped in the Shortform Player edge-to-edge theme.
v1.7.6 (2025-08-21)
Preview/Player features have been improved.
Fixed a memory leak in the preview popup.
v1.7.5 (2025-08-06)
Preview/Player features have been improved.
Added an interface for setting the Preview background color, and fixed the background color showing through.
Fixed an issue where the Player navigation bar transparency setting was lost on screen rotation.
Fixed the status bar and navigation bar overlapping the WebView.
Shortform Video Editor
Android JNI page size 16 KB has been applied so that video processing is faster on those devices.
Common
Android page size 16 KB.
v1.7.4 (2025-07-28)
Preview/Player features have been improved.
Fixed an issue where full-screen playback did not work after watching a replay video while a ShopLivePreview click action was being handled.
A ShopLivePreview instance is now provided when showPreviewPopup is called.
The PIP transition button click event can now be customized.
Fixed an issue where the bottom navigation icons became translucent when expanding from preview to full screen with a light app theme.
Fixed the preview initial position overlapping the soft navigation bar when target SDK 35 is set.
Fixed an issue where ExoPlayer could not be resized with ConstraintLayout 2.2.x.
Common
The ConstraintLayout and core library versions have been updated.
v1.7.1.1 (2025-06-20)
Preview features have been improved.
The keepWindowStateOnPlayExecuted value is now applied in the Preview state.
v1.7.1 (2025-06-11)
target SDK 35 has been applied (the edge-to-edge theme is applied by default).
v1.7.0 (2025-05-25)
The FFMPEG dependency has been removed.
v1.6.7 (2025-03-25)
Exoplayer & Media3
Performance improvements with Exoplayer & Media3 v10.
Editor
The performance of the Video Editor has been improved.
v1.6.6 (2025-02-21)
Live player
Live player performance has been improved.
Editor
The performance of the Video Editor has been improved.
v1.6.5.1 (2025-02-12)
Short-form
Short-form performance has been improved.
Editor
The performance of the Video Editor has been improved.
v1.6.5 (2025-01-22)
Live player
Live player performance has been improved.
Short-form
A function has been added for bi-directional pagination to the Shortform Detailed List configuration with a specific Shortform ID.
You can set the short-form to mute or not. (ShopLiveShortformCollectionData, ShopLiveShortformDetailTypeView API)
Editor
The performance of the Video Editor has been improved.
v1.6.4.1 (2024-12-20)
Shortform
Short-form performance has been improved.
ShopLiveShortformDetailTypeView is also an issue in the Compose environment.
Exoplayer & Media3
Performance improvements with Exoplayer & Media3 v9.
v1.6.4 (2024-12-18)
Editor
The performance of the Video Editor has been improved.
The Customize feature has been added.
v1.6.3 (2024-12-12)
Short-form
Short-form performance has been improved.
Editor
The performance of the Video Editor has been improved.
v1.6.2 (2024-12-06)
Short-form
Short-form performance has been improved.
The CollectionView feature has been fixed.
Scroll Control
You can see the event when you reach the last Shortform.
Editor
The performance of the Video Editor has been improved.
Customize function has been added.
v1.6.1 (2024-11-29)
Short-form
Short-form performance has been improved.
The interface of ShopLiveShortformHandler has changed.
CollectionView feature has been added.
Removing a specific short-form
Scroll Control
Added DetailView feature.
Set the value of a UI component padding
Editor
The performance of the Video Editor has been improved.
The field in ShopLiveEditorResultData has changed.
Click eventTrace.
v1.6.0.2 (2024-11-22)
Live player
The preview is also available in the Compose environment.
Editor
Video Editor resolution 960p is also supported.
The interface of the ShopLiveCoverPickerHandler has changed.
v1.6.0.1 (2024-11-18)
Short-form
Short-form performance has been improved.
v1.6.0 (2024-11-18)
Live player
Player functionality has been improved.
You can hide the end image of the preview.
Short-form
Short-form performance has been improved.
You can use the Short-form Detail View.
Handler's onShortsAttched() and onShortsDetached() functions have been added.
Handler can be applied to each Component.
Editor
The Editor feature has been released.
v1.5.16 (2024-10-14)
Live player
You can set the resolution of the preview. PreviewResolution
v1.5.15.1 (2024-09-19)
Live player
Preview has been improved.
v1.5.15 (2024-09-13)
Live player
Preview feature has been added. You can now configure the Preview list on the screen.
v1.5.14 (2024-08-12)
Live player
Player performance has been improved.
v1.5.13 (2024-06-19)
Live player
Player performance has been improved.
v1.5.12 (2024-06-12)
Live player
Player performance has been improved.
v1.5.11 (2024-05-30)
Live player
Player performance has been improved.
ShopLive.setKeepAspectOnTabletPortrait is no longer valid.
Short-form
Short-form performance has been improved.
v1.5.10 (2024-05-27)
Live player
It can maintain the aspect ratio of the video.
Added the ability to unmute based on the Preview device volume.
ShopLiveHandler.log(data: ShopLiveLog.Data) changed to ShopLiveHandler.onEvent(context: Context, data: ShopLiveLog.Data).
Short-form
Short-form performance has been improved.
It can maintain the aspect ratio of the video.
Added the ability to unmute based on the Preview device volume.
v1.5.9 (2024-05-13)
Live player
Player performance has been improved.
Depending on the device volume, the mute icon will change.
Short-form
Short-form performance has been improved.
Depending on the device volume, the mute icon will change.
v1.5.8 (2024-05-01)
Live player
Added a Preview mute option.
Video mute status event has been added. (video_muted, video_unmuted)
Short-form
Added features from Preview.
When clicking Preview to enter full screen, the detail screen has been changed to continue playback while maintaining the playback time.
Migration guide
ShopLive.sendCommandMessage(command: String?, payload: Map<String, Any?>)
v1.5.7 (2024-04-08)
Live player
ShopLive.setUser(user: ShopLiveCommonUser).
Short-form
Short-form performance has been improved.
Groups feature has been added.
ShopLiveShortformReceiveHandler and ShopLiveShortformDetailHandler have been renamed ShopLiveShortformHandler.
Migration guide
ShopLive.setUser(user: ShopLiveCommonUser).
v1.5.5 (2024-02-06)
Common
Live player
Performance improvement
Short-form
Performance improvement
Migration guide
v1.5.4 (2024-01-19)
Live player
Short-form
Short-form performance improvement
Migration guide
v1.5.3.1 (2024-01-15)
Live player
The performance of the player has been improved.
Short-form
The performance of Short-form player has been imporoved
v1.5.3 (2024-01-09)
Live player
The performance of the player has been improved.
Preview destroy feature has been added
Preview close event added
Migration guide
Shortform.setNativeHandler() interface has been changed as below
v1.5.2 (2023-12-04)
Live player
The performance of the player has been improved.
a feature to hide the StatusBar has been added
Preview click custom feature has been added
ShopLive Java code has been migrated to Kotlin code
ShopLiveHandler has been migrated from interface to abstract class
Short-form
Mute control is now persistant
Migration guide
ShopLive.play() interface has been changed
ShopLive.showPreviewPopup() interface has been changed
ShopLive.intentPlay() interface has been changed
ShopLive.setLoadingProgressColor() interface has been changed
ShopLive.setStatusBarTransparent() interface has been changed
ShopLive.init() is no longer required
Migration to MaveCentral (2023-11-20)
Migration to repository
You no longer need to add a separate maven repository.
v1.5.1 (2023-11-02)
Live player
The performance of the player has been improved.
You can check user statistics using UTM Source, UTM Medium, UTM Campaign, UTM Content
‘setAdId’ has been deprecated
The Preview feature, which required permission to draw over other apps, has been removed.
v1.5.0 (2023-10-19)
Live player
Preview the movement has been smoothed.
v1.4.9 (2023-10-12)
Live player
Improved player first loading performance.
We've improved the first loading performance of the Preview.
We've added a feature that lets you know if the Preview is playing or not.
Short-form
Added a tutorial feature.
build.gradle
cloud.shoplive:shoplive-networkChanged to mandatory Dependency.
v1.4.8.1 (2023-09-25)
Live player
Improved preview performance.
v1.4.8 (2023-09-15)
Live player
Improved preview performance.
Short-form
Improved detail screen playback performance.
v1.4.7 (2023-08-09)
Common
Short-form
Improved the design of the list.
v1.4.6 (2023-08-04)
Short-form
Added native list functionality.
Ability to hide views
Brand Area Hiding Function
Title hiding function
Product number hiding function
Description hiding function
Ability to set cornerRadius in a list
Card type0 has been added.
Improved scrolling functionality in lists.
v1.4.5 (2023-07-27)
Live player
Improved preview performance.
Short-form
v1.4.4 (2023-07-25)
Short-form
v1.4.3 (2023-07-04)
Improved player playback performance.
v1.4.2 (2023-06-16)
Improved player playback performance.
v1.4.1 (2023-06-05)
Improved player playback performance.
v1.4.0 (2023-05-15)
Added an interface that allows you to set whether or not to swipe Preview to exit.
Modularized preview interface.
Drawing on top of other existing apps has been deprecated.
v1.3.4 (2023-04-13)
Added an interface to set the ad ID for ad tracking.
Added an interface that allows you to set up custom data before launching the player.
We've added a pop-up In App Preview that doesn't require permissions.
v1.3.3.1 (2023-03-09)
In Preview, I changed the close button to Android style.
Improved stability in some environments.
v1.3.3 (2023-02-23)
Added a parameter to measure entry path statistics.
You can now enable the close button in Preview.
Improved player playback performance.
You can now control your audio without receiving Bluetooth permission.
v1.3.2 (2022-11-30)
Improved the picture-in-picture switching interface (startPictureInPicture, stopPictureInPicture) to work only once, even if it is called multiple times at the same time.
If the URL is not set when the share button is clicked, the error code will be forwarded to the onError Handler.
Fixed an issue that could impact the lifecycle of a customer's app when switching to picture-in-picture after launching Shoplive Player with deep links.
Animations have been applied to make the chat input box appear more naturally.
Fixed an issue where the chat input box could hide chats.
v1.3.1 (2022-10-18)
You can now use animated images for broadcast background images (broadcast announcements, in progress, and after the broadcast). (GIF, APNG, WEBP, etc.)
v1.3.0 (2022-09-22)
Updated to support landscape mode broadcasting. If you would like to use landscape broadcasting, please contact your Shoplive representative.
We provide a ShopLivePreview (or ShopLiveSwipeView) so that customers can implement the preview themselves.
The setUiMessage interface has been added to allow you to apply custom messages.
A setStatusBarTransparent interface has been added to zoom in on the status bar area.
The setSoundFocusHandling interface has been added to handle audio focus.
A log interface has been added to forward the event log of the Shoplive Player.
Added a "CLOSING" event to the onChangedPlayerStatus callback.
The 'android.permission.BLUETOOTH' permission has been changed to only apply up to targetSDkVersion 30.
v1.2.7.1 (2022-07-01)
Improved the logic for checking the status of PIP.
Fixed a UI issue that occurred when clicking the chat input button on some devices.
v1.2.7 (2022-05-26)
Fixed an issue where when the user's credentials are updated while the Shoplive player is running in picture-in-picture mode (e.g., non-login -> login), the player changes to full-screen mode. If your credentials change, you can still stay in picture-in-picture mode.
v1.2.6 (2022-05-19)
Fixed a UI issue in Galaxy Fold tablet mode.
v1.2.5 (2022-05-12)
Fixed UI issues on certain devices.
Fixed an issue where the image ratio (e.g., broadcast preview image, broadcast image, etc.) was not reflected even if the ratio was set to 9:16 on the tablet.
Changed the default aspect ratio for video on tablets to 9:16. If you want to use it as a full screen, you need to set ShopLive.setKeepAspectOnTabletPortrait(false).
Improved some features related to PIP.
v1.2.4 (2022-04-15)
Added the ability to drag the preview area to exit.
Added the ability to start with mute.
Added the ability to open deep links. (If you'd like to add this feature, contact your Shoplive representative.)
We've added a feature that allows the Shoplive Android SDK to handle display permission request messages on top of other apps.
Added a sendCommandMessage interface that passes commands and payloads to the server.
Added a setAppVersion interface to set the app version.
v1.2.3 (2022-03-30)
Exoplayer Library version 2.13.0 updated to version 2.16.0.
Fixed an issue where chat input was hidden from the keyboard. (Occurs on some devices only)
v1.2.2 (2022-03-10)
Vibrations, sound effects, and other quiz functions have been improved to be linked.
Improved silent playback during preview.
We've added an API that allows users to select the next action to a feature that was forced into in-app PIP when a product or announcement was selected by the user.
Added an API that allows you to set an endpoint.
v1.2.1 (2022-01-13)
Fixed an issue when entering a live broadcast where video playback is not smooth intermittently depending on the network environment
v1.2.0 (2021-12-15)
ShopLive.getAuthToken() - Get JWT authentication key
ShopLive.isSuccessCampaignJoin() - Checks if the broadcast has been successfully entered
ShopLive.startPictureInPicture() - Enter picture-in-picture mode
ShopLive.stopPictureInPicture() - Disable picture-in-picture mode (return to FULL screen)
v1.1.2 (2021-11-15)
Add an onReceivedCommand handler function to pass command information received from the SDK's web
v1.1.1 (2021-11-08)
Add callbacks for coupon downloads and the success or failure of custom actions
Add a notification when setting or changing a username
Support for synchronizing video events
v1.0.15 (2021-11-03)
Add Image Animation Progress Interface
Added an option so that the broadcast does not end automatically when the root activity ends.
v1.0.13 (2021-10-14)
Preview (when using the Show on top of other apps) When the app switches between background/foreground during playback, it is automatically hid/showed.
Added ShopLive.hidePreview() interface to temporarily hide during preview (when using the Show on top of other app option) playback
Added ShopLive.resumePreview() interface so that when the preview is hidden for a short period of time during playback, it can be resumed again.
v1.0.11 (2021-09-30)
Added option to set aspect ratio in tablet mode (fill the video or match the aspect ratio)
Add userScore
Add onChangedPlayerStatus interface
v1.0.10 (2021-09-10)
When the onPause event is received, the chat input box and keyboard are hidden when the chat input box and keyboard are floating.
v1.0.9 (2021-09-08)
Loading progress output only on broadcast entry. After that, the buffer was changed so that loading progress would not output if it occurred.
v1.0.8 (2021-09-06)
On broadcast entry, loading progress output (color applied)
v1.0.7 (2021-09-01)
In picture-in-picture mode, the activity of the app that has been lowered to the background is brought up to the foreground while coming up to the full screen.
v1.0.6 (2021-08-31)
Add ShopLive.showPreview(campaignKey) (requires display permission on top of other apps)
Added ShopLive.showPreview(campaignKey, isOsPip = true) (switch to PIP after entering the broadcast)
Add handlePreview(context, campaignKey) interface
Error correction
v1.0.5 (2021-08-25)
Add handleDownloadCoupon(context, couponId, callback) interface
v1.0.3 (2021-08-18)
Added the ability to leave a stream you're watching
When you enter the broadcast, you will receive campaign information
When the campaign status changes, the status value is passed
In the event of an error, code/message delivery
When returning to video after ending a call, change the default from 'Video Stops' to 'Auto Play Video'
v1.0.2 (2021-08-09)
When earphones/headset are disconnected, a mute option has been added with continued playback
v1.0.1 (2021-08-05)
Custom Payload Delivery Support (CUSTOM_ACTION)
Chat input font setting support
v1.0.0 (2021-08-04)
Android SDK Launch