API - Option

ShopLive.setUser

Setting user information for Shoplive.

fun setUser(user: ShopLiveUser)

enum ShopLiveUserGender

• Application guide

  Simple authentication user account linking

ShopLive.setAuthToken

This is the security authentication token (JWT) string of the authenticated user using Shoplive.
For user authentication, enter the authenticated user's security authentication token (JWT) string.

fun setAuthToken(authToken: String)

• Application guide

  Security authentication user account linking

ShopLive.getAuthToken

Returns the JWT token string for user authentication.

fun getAuthToken(): String

ShopLive.setPIPRatio

This is the default screen scale when starting PIP screen mode.
When you start PIP screen mode after playing for the first time, PIP screen mode starts with the specified screen scale.

fun setPIPRatio(ratio: ShopLivePIPRatio)

enumShopLivePIPRatio

• Application guide

  Switch to Picture-in-Picture

ShopLive.setKeepAspectOnTabletPortrait

Set the Shoplive screen ratio in tablet portrait mode. 
true: Maintain aspect ratio (default)
false: Fullscreen

fun setKeepAspectOnTabletPortrait(isKeepAspectOnTabletPortrait: Boolean)

• Application guide

  Setting aspect ratio in tablet portrait mode

ShopLive.setKeepPlayVideoOnHeadphoneUnplugged

The video stops when the earphones (or headset) are disconnected.
You can set the video to play continuously or leave it muted upon your needs

• To change to silent mode when Bluetooth earphones (or headset) are disconnected, you need to declare BLUETOOTH_CONNECT in AndroidManifest.xml and then grant runtime permission before entering the broadcast, if you want to set it with setKeepPlayVideoOnHeadphoneUnplugged(true, true).

<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />

fun setKeepPlayVideoOnHeadphoneUnplugged(isKeepPlayVideoOnHeadphoneUnplugged: Boolean)
fun setKeepPlayVideoOnHeadphoneUnplugged(isKeepPlayVideoOnHeadphoneUnplugged: Boolean, isMute: Boolean)

• Application guide

  Interruption due to loss of earphone (or headset) connection

ShopLive.setAutoResumeVideoOnCallEnded

When you return to the video after ending the call, the video will continue to play.
However, you can set the video to pause if necessary.

Required permissions:READ_PHONE_STATE

fun setAutoResumeVideoOnCallEnded(isAutoResumeVideoOnCallEnded: Boolean)

• Application guide

  Interrupt due to call connection

ShopLive.setShareScheme

When selecting "Share", set the URL or scheme to be passed.

• Application guide

  Share broadcast link

ShopLive.setLoadingProgressColor

Set the video loading progress bar color.

fun setLoadingProgressColor(@ColorInt colorInt: Int)

• Application guide

  Setting up a progress bar

ShopLive.setLoadingAnimation

Set the video loading progress bar as an image animation.

fun setLoadingAnimation(animationDrawable: Int)

• Application guide

  Setting up a progress bar

ShopLive.setChatViewTypeface

Set the chat font and chat send button font.

• To apply the same font to both the chat and the chat send button, call the setChatViewTypeface(typeface) function.

  fun setChatViewTypeface(typeface: Typeface)
  

sample code

val nanumGothic = resources.getFont(R.font.nanumgothic)
val nanumGothicBold = resources.getFont(R.font.nanumgothicbold)

ShopLive.setChatViewTypeface(nanumGothic)

• Application guide

  Change chat font

ShopLive.setEnterPipModeOnBackPressed

While watching a video, selecting (tapping) the back button to exit the screen will end the video. However, this option can be used to switch to Picture-in-Picture (PIP) mode and continue watching the video.

fun setEnterPipModeOnBackPressed(isEnterPipModeOnBackPressed: Boolean)

ShopLive.close

Closing the player

fun close()

ShopLive.setAutoCloseWhenAppDestroyed

You can set it so that the player does not close even if the root activity is terminated.

The reason for using this option is to prevent the broadcast from ending when the root activity is relaunched using the Intent.FLAG_ACTIVITY_NEW_TASK option. It allows for the ShopLive.close function to be called directly to properly terminate the broadcast when the app is appropriately closing.

• Default: Automatic termination

• If not set, the player will close when the app is closed.

  fun setAutoCloseWhenAppDestroyed(isAutoClose: Boolean)
  

ShopLive.startPictureInPicture

Switch from full screen mode to PIP screen mode.

fun startPictureInPicture()

ShopLive.stopPictureInPicture

Switch PIP screen mode to full screen mode.

fun stopPictureInPicture()

• Application guide

  Switch to Picture-in-Picture

ShopLive.getStatus

Getting Shoplive player status

fun getStatus(): Status

enum Status

ShopLive.isShowingPreviewPopup

This is the information provided when successfully entering the Shoplive Preview.

fun isSuccessCampaignJoin(): Boolean

ShopLive.isSuccessCampaignJoin

This is information provided when entry into the broadcast is successful.

fun isSuccessCampaignJoin(): Boolean

ShopLive.sendCommandMessage

Delivers commands and payload to the server.
You can pass commands and payloads in predefined formats. (Alternatively, you can define the command and payload in consultation with Shoplive.)

 fun sendCommandMessage(command: String, payload: Map<String, Any?>)

ShopLive.setMuteWhenPlayStart

Set the sound to turn on or mute when you start Shoplive Player.
(Default: Starts Shoplive Player with sound turned on.)

fun setMuteWhenPlayStart(isMute: Boolean)

ShopLive.setAppVersion

Set the app version.
Even if you don't call the API, the app version is read by default and passed to the server.
Please contact your Shoplive representative to use this feature.

fun setAppVersion(appVersion: String)

ShopLive.setVisibleStatusBar

You can hide the StatusBar on the screen.

fun setVisibleStatusBar(isVisible: Boolean)

ShopLive.setSystemBarColor

You can change the color of the SystemBar on your screen.

fun setSystemBarColor(data: ShopLivePlayerSystemBarColorData)

ShopLivePlayerSystemBarColorData

field	type	description
statusBarColor	ColorInt	You can change the StatusBar color. defaultShopLivePlayerSystemBarColorData.DEFAULT_COLOR
navigationBarColor	ColorInt	You can change the SystemBar color. defaultShopLivePlayerSystemBarColorData.DEFAULT_COLOR

sample code

ShopLive.setSystemBarColor(ShopLivePlayerSystemBarColorData().apply {
    statusBarColor = Color.TRANSPARENT
})

ShopLive.setSoundFocusHandling

If a phone call comes in while playing a video or the sound is suppressed due to the use of another app's player, you can receive the event and handle it directly.

fun setSoundFocusHandling(listener: OnAudioFocusListener?)

ShopLive.showDialogFragment

Used to display the user's DialogFragment on the Shoplive Player screen.

fun showDialogFragment(dialogFragment: DialogFragment)

ShopLive.closeDialogFragment

To close the dialog displayed using ShopLive.showDialogFragment(fragment).

fun closeDialogFragment()

ShopLive.setPlayerScreenCaptureEnabled

You can prevent screenshots of the broadcast screen.

fun setPlayerScreenCaptureEnabled(isEnabled: Boolean)

ShopLive.setMixWithOthers

When external audio is played, you can config the livestream audio.

fun setMixWithOthers(isMixAudio: Boolean)

ShopLive.setUtmSource

You can track UTM Source. Data can be checked at Data Insights.

fun setUtmSource(utmSource: String)

ShopLive.setUtmMedium

You can track UTM Medium. Data can be checked at Data Insights.

fun setUtmMedium(utmMedium: String)

ShopLive.setUtmCampaign

You can track UTM Campaigns. Data can be checked at Data Insights.

fun setUtmCampaign(utmCampaign: String)

ShopLive.setUtmContent

You can track UTM Content. Data can be checked at Data Insights.

fun setUtmContent(utmContent: String)

ShopLive.addParameter

You can add custom data before launching the player.

fun addParameter(key: String, value: String)

ShopLive.removeParameter

Before running the player, delete the custom data added with addParameter.

fun removeParameter(key: String)

ShopLive.setNextActionOnHandleNavigation

Set the next action of Shoplive Player when the user selects a link such as a product, notice, or banner.

fun setNextActionOnHandleNavigation(type: ActionType)

enumActionType

• Application guide

  Set the following actions for Shoplive Player when a user selects a link:

ShopLive.setEndpoint

This is used when you need to utilize the Shoplive service from a specific landing page or URL, rather than the Web Landing page of the Shoplive Player. For instance, in cases where the Shoplive Landing page cannot be used due to security reasons, you can create a landing page on a specific domain.

※ The Web Landing page of the Shoplive Player can be implemented after consultation with Shoplive.

fun setEndpoint(url: String)