Event handler

    Event handler


    기사 요약

    Shoplive Shortform에서 발생한 알림을 클라이언트에서 Handler 함수를 통해 전달받고 필요하게 처리합니다.

    ShopLiveShortform.setHandler(object : ShopLiveShortformHandler() {
    	override fun getOnClickProductListener(): ShopLiveShortformProductListener {
    	    return ShopLiveShortformProductListener { context, data, product ->
    	        // Something landing customer
        	}
    	}
    
    	override fun getOnClickBannerListener(): ShopLiveShortformUrlListener {
        	return ShopLiveShortformUrlListener { context, data, url ->
            	// Something landing customer
    	    }
    	}
    
    	override fun onEvent(context: Context, messenger: ShopLiveShortformMessageListener?, command: String, payload: Map<String, Any?>) {
    		// Do something
    	}
            
    	override fun onError(context: Context, error: ShopLiveCommonError) {
    		// Do something
    	}
            
    	override fun onShare(context: Context, data: ShopLiveShortformShareData) {
    		// Do something
    	}
      
    	override fun onCreate() {
    		// Do something
    	}
      
    	override fun onDestroy() {
    		// Do something
    	}
    
        open fun onShortsAttached(data: ShopLiveShortformData) {
    		// Do something
        }
    
        open fun onShortsDetached(data: ShopLiveShortformData) {
    		// Do something
        }
    })


    onEvent

    onEvent(context: Context, messenger: ShopLiveShortformMessageListener?, command: String, payload: Map<String, Any?>를 통해 Shoplive Shortform에서 발생하는 여러 가지 이벤트를 직접 핸들링할 수 있는 messageCallback 함수를 제공합니다.

    ShopLiveShortformMessageListener

    Property

    Type

    Description

    view

    View

    UI Component

    sendCommandMessage

    view에서 발생한 알림 함수에 특정 이벤트를 전달할 수 있습니다.

    fun onEvent(context: Context, messenger: ShopLiveShortformMessageListener?, command: String, payload: Map<String, Any?>) {
        messenger?.sendCommandMessage("SET_CUSTOM_SHORTFORM", payload = "YOUR_PAYLOAD")
    }


    onError

    onError(context: Context, error: ShopLiveCommonError) 를 통해 Shoplive Shortform에서 발생하는 에러를 직접 핸들링할 수 있는 messageCallback 함수를 제공합니다.

    ShopLiveCommonError

    Property

    Type

    Description

    code

    Int

    ShopLiveCommonErrorCode

    message

    String?

    에러 메세지

    cause

    Throwable?

    에러 원인


    onShare

    onShare(context: Context, data: ShopLiveShortformShareData)를 통해 Shoplive Shortform에서 직접 공유하기 기능을 개발합니다.

    ShopLiveShortformShareData

    Property

    Type

    Description

    shortsId

    String?

    Shotrform 고유의 아이디

    srn

    String?

    Shortform 고유 정보를 담는 아이디

    title

    String?

    Shortform 제목 (og tag 용도)

    description

    String?

    Shortform 설명 (og tag 용도)

    thumbnail

    String?

    Shortform thumbnail (og tag 용도)


    onCreate

    onCreate()를 통해 Shoplive Shortform 상세 화면으로 진입 시 필요한 기능을 개발할 수 있습니다.


    onDestroy

    onDestroy()를 통해 Shoplive Shortform 상세 화면에서 진출 시 필요한 기능을 개발할 수 있습니다.


    onShortsAttached

    onShortsAttached(data: ShopLiveShortformData)를 통해 Shoplive Shortform의 각각의 shorts attach 상태가 될 때 필요한 기능을 개발 할 수 있습니다.


    onShortsDetached

    onShortsDetached(data: ShopLiveShortformData)를 통해 Shoplive Shortform의 각각의 shorts detach 상태가 될 때 필요한 기능을 개발 할 수 있습니다.


    ShopLiveShortformProductListener

    onClick

    onClick(context: Context, data: ShopLiveShortformIdentifier?, product: ShopLiveShortformProductData)를 통해 Shoplive Shortform에서 직접 상품 클릭 기능을 개발합니다. 상품 생성하기 가이드를 참고합니다.

    ShopLiveShortformIdentifier

    Property

    Type

    Description

    shortsId

    String?

    Shotrform 고유의 아이디

    srn

    String?

    Shortform 고유 정보를 담는 아이디

    ShopLiveShortformProductData

    Property

    Type

    Description

    brand

    String?

    상품의 브랜드 정보

    currency

    String?

    상품의 통화

    description

    String?

    상품에 대한 설명

    discountPrice

    Double?

    상품의 할인 가격

    discountRate

    Double?

    상품의 할인율

    imageUrl

    String?

    상품 이미지 URL

    name

    String?

    상품명

    originalPrice

    Double?

    상품의 정상 가격

    productId

    Long?

    상품 고유의 아이디. 상품 등록 시 자동으로 발급

    showPrice

    Boolean

    상품의 보이는 가격

    sku

    String?

    상품 고유의 SKU 정보

    url

    String?

    상품 상세 페이지의 URL


    ShopLiveShortformUrlListener

    onClick

    onClick(context: Context, data: ShopLiveShortformIdentifier?, url: String)를 통해 Shoplive Shortform에서 직접 배너 클릭 기능을 개발합니다. 숏폼 내 배너 생성하기 가이드를 참고합니다.

    ShopLiveShortformIdentifier

    Property

    Type

    Description

    shortsId

    String?

    Shotrform 고유의 아이디

    srn

    String?

    Shortform 고유 정보를 담는 아이디