Shoplive Player에서 발생한 사용자 UI 이벤트 또는 상태 변경과 같은 알림을 클라이언트에서 핸들러(delegate) 함수를 통해 전달받고 필요한 처리를 합니다.


delegate

Shoplive iOS SDK의 핸들러 이벤트를 전달받는 함수를 선언하고, Shoplive iOS SDK와 이벤트를 연결하는 property입니다.

@objc var delegate: ShopLiveSDKDelegate? { get set }
@objc public protocol ShopLiveSDKDelegate: AnyObject {
    @objc func handleNavigation(with url: URL)
    @objc func handleChangeCampaignStatus(status: String)
    @objc func handleCampaignInfo(campaignInfo: [String : Any])

    @objc func onSetUserName(_ payload: [String : Any])

    @objc func handleCommand(_ command: String, with payload: Any?)
    @objc func handleReceivedCommand(_ command: String, with payload: Any?)

    @objc func handleError(code: String, message: String)

    @objc optional func handleDownloadCoupon(with couponId: String, result: @escaping (ShopLiveCouponResult) -> Void)
    @objc optional func handleCustomAction(with id: String, type: String, payload: Any?, result: @escaping (ShopLiveCustomActionResult) -> Void)
}

샘플 코드

class MainViewController: UIViewController {
    ...
    override func viewDidLoad() {
        super.viewDidLoad()

        // delegate와 현재 클래스를 연결합니다.
        ShopLive.delegate = self

    }
    ...
}

// delegate를 연결할 클래스는 ShopLiveSDKDelegate Protocol을 구현합니다. 
extension MainViewController: ShopLiveSDKDelegate {
    func handleNavigation(with url: URL) {
        print("handleNavigation \(url)")
    }
    ...
}

handleNavigation(with:)

Shoplive에서 상품, 배너 등을 선택(탭) 했을 때, 선택한 상품 또는 배너 정보를 전달합니다.

handleNavigation(with url: URL)

매개변수

설명

url

상품 또는 배너 선택 시 이동할 URL

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleNavigation(with url: URL) {
        print("handleNavigation \(url)")

        UIApplication.shared.open(url, options: [:], completionHandler: nil)
    }
    ...
}

handleChangeCampaignStatus(status:)

방송 상태가 변경되었을 때 변경된 방송 상태를 전달합니다.

@objc func handleChangeCampaignStatus(status: String)

매개변수

설명

status

방송 상태
READY, ONAIR, CLOSED

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleChangeCampaignStatus(status: String) {
        print("handleChangeCampaignStatus \(status)")

        switch status {
            case "READY", "ONAIR":
                break
            case "CLOSED":
                print("ended campaign")
                break
        }
    }
    ...
}

handleCampaignInfo(campaignInfo:)

현재 방송에 관한 정보를 전달합니다.

handleCampaignInfo(campaignInfo: [String : Any])

매개변수

설명

campaignInfo

현재 빙송의 정보
예) title: 방송 제목

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleCampaignInfo(campaignInfo: [String : Any]) {

        campaignInfo.forEach { (key, value) in
            print("campaignInfo key: \(key)  value: \(value)")
        }

    }
    ...
}

onSetUserName(_ payload:)

사용자 이름이 변경되었을 때 호출됩니다.

onSetUserName(_ payload: [String : Any])

매개변수

설명

payload

사용자 정보
예) userId: 사용자 ID

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func onSetUserName(_ payload: [String : Any]) {
        payload.forEach { (key, value) in
            print("onSetUserName key: \(key) value: \(value)")
        }
    }
    ...
}

handleCommand(_ command: , with payload:)

Shoplive iOS SDK의 특정 명령어 정보를 전달합니다.

handleCommand(_ command: String, with payload: Any?)

매개변수

설명

command

명령어 이름

payload

명령어와 함께 전달되는 데이터


Shoplive Player 상태 변경

command
Shoplive Player 상태가 변경될 때 Command로 전달합니다.

매개변수

설명

willShopLiveOn

Shoplive Player가 전체 화면으로 변경 시작

didShopLiveOn

Shoplive Player가 전체 화면으로 변경 완료

willShopLiveOff

Shoplive Player가 PIP 모드 또는 종료 상태로 변경 시작

didShopLiveOff

Shoplive Player가 PIP 모드 또는 종료 상태로 변경 완료

payload

변경 전 Shoplive Player 상태를 payload로 전달합니다.

매개변수

설명

style

PresentationStyle의 rawValue (Int)

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleCommand(_ command: String, with payload: Any?) {
        print("handleCommand: \(command)  payload: \(payload)") 
    }
    ...
}

handleReceivedCommand(_ command: , with payload:)

Shoplive iOS SDK의 WEB으로부터 수신된 명령어 정보를 전달합니다.

handleReceivedCommand(_ command: String, with payload: Any?)

매개변수

설명

command

명령어 이름

payload

명령어와 함께 전달되는 데이터

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleReceivedCommand(_ command: String, with payload: Any?) {
        // print("handleReceivedCommand: \(command)  payload: \(payload)")
    }
    ...
}

CLICK_PRODUCT_DETAIL

방송 화면에서 상품 목록을 열고, 상품이 선택되면 전달되는 상품 정보입니다.

command:
CLICK_PRODUCT_DETAIL

payload:
{
    action = 링크;
    brand = 브랜드;
    sku = product01234;
    url = "http://product.com";
}

CLICK_PRODUCT_CART

방송 화면에서 상품 목록을 열고, 상품의 장바구니 버튼이 선택되면 전달되는 장바구니 정보입니다.

command:
CLICK_PRODUCT_CART

payload:
{
action = LINK;
    brand = "company brand";
    ...
    url = "https://company.com/product/12345/detail";
}

LOGIN_REQUIRED

Shoplive iOS SDK가 적용되는 앱의 로그인이 필요할 때 전달되는 로그인 동작을 요청합니다.

command:
LOGIN_REQUIRED

payload: 없음

ON_SUCCESS_CAMPAIGN_JOIN

방송 진입에 성공했을 때 전달되는 정보입니다.

command:
ON_SUCCESS_CAMPAIGN_JOIN

payload:
{
isGuest: 1 // 1: 게스트, 0: 인증 사용자
}

Coupon

쿠폰 처리를 완료할 때 쿠폰 활성 여부를 설정하기 위한 상태입니다.

@objc public enum ShopLiveResultStatus: Int, CaseIterable {
    case SHOW // 쿠폰 다시 활성
    case HIDE // 쿠폰 사라짐
    case KEEP // 상태 유지

    public var name: String {
        switch self {
        case .SHOW:
            return "SHOW"
        case .HIDE:
            return "HIDE"
        case .KEEP:
            return "KEEP"
        }
    }
}

쿠폰 처리를 완료할 때 알림 메시지가 있으면 나타나는 타입을 설정합니다.

@objc public enum ShopLiveResultAlertType: Int, CaseIterable {
    case ALERT // 얼럿
    case TOAST // 토스트

    public var name: String {
        switch self {
        case .ALERT:
            return "ALERT"
        case .TOAST:
            return "TOAST"
        }
    }
}
@objc public class ShopLiveCouponResult: NSObject {
    var success: Bool         // 쿠폰 처리 성공/실패 여부
    var coupon: String = ""   // 쿠폰 ID
    var message: String?      // 알림 메시지
    var couponStatus: ShopLiveResultStatus // 완료 후 쿠폰 상태
    var alertType: ShopLiveResultAlertType // 알림 메시지 출력 타입

    public init(couponId: String, success: Bool, message: String?, status: ShopLiveResultStatus, alertType: ShopLiveResultAlertType) {
        self.coupon = couponId
        self.success = success
        self.message = message
        self.couponStatus = status
        self.alertType = alertType
    }
}
@objc public class ShopLiveCustomActionResult: NSObject {
    var success: Bool             // 커스텀 동작 처리 성공/실패
    var id: String = ""           // 커스텀 동작 ID   
    var message: String?          // 알림 메시지
    var couponStatus: ShopLiveResultStatus           // 완료 후 커스텀 동작 상태
    var alertType: ShopLiveResultAlertType           // 알림 메시지 출력 타입

    public init(id: String, success: Bool, message: String?, status: ShopLiveResultStatus, alertType: ShopLiveResultAlertType) {
        self.id = id
        self.success = success
        self.message = message
        self.couponStatus = status
        self.alertType = alertType
    }
}

handleDownloadCoupon(with: result:)

Shoplive에서 쿠폰을 선택(탭) 했을 때 클라이언트로 쿠폰 정보를 전달합니다. 클라이언트의 쿠폰 처리 결과를 Shoplive iOS SDK로 다시 전달하는 result callback을 통해 Shoplive Player에서의 쿠폰 상태를 설정합니다.

handleDownloadCoupon(with couponId: String, result: @escaping (ShopLiveCouponResult) -> Void)

매개변수

매개변수

couponId

쿠폰 ID

result

결과값을 Shoplive iOS SDK로 전달하는 result callback

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleDownloadCoupon(with couponId: String, result: @escaping (ShopLiveCouponResult) -> Void) {
        print("handleDownloadCoupon: \(couponId)")

        //쿠폰 처리 완료 시 호출 (처리 결과)
        // 성공
        let couponResult = ShopLiveCouponResult(couponId: couponId, success: true, message: "쿠폰 다운로드가 성공하였습니다.", status: .SHOW, alertType: .ALERT)
        // 실패
        let couponResult = ShopLiveCouponResult(couponId: couponId, success: false, message: "쿠폰 다운로드가 실패하였습니다.", status: .HIDE, alertType: .TOAST)
        result(couponResult)
    }
    ...

handleCustomAction(with id:, type:, payload:, result:)

팝업에서 클릭 이벤트를 custom으로 지정하고, 팝업을 선택(탭) 했을 때 팝업 정보를 전달합니다. 팝업의 id, type (COUPON, BANNER, NOTICE), payload를 전달합니다.

handleCustomAction(with id: String, type: String, payload: Any?, result: @escaping (ShopLiveCustomActionResult) -> Void)

매개변수

설명

id

팝업 ID

type

팝업 타입

  • COUPON, BANNER, NOTICE

payload

사용자 정의 데이터

result

결과값을 Shoplive iOS SDK로 전달하는 result callback

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleCustomAction(with id: String, type: String, payload: Any?, result: @escaping (ShopLiveCustomActionResult) -> Void) {
        print("handleCustomAction \(id) \(type) \(payload.debugDescription)")

        // 팝업 처리가 완료되면 호출됨(처리 결과)
        // 성공
        let customActionResult = CustomActionResult(id: id, success: true, message: "Coupon download was successful.", status: .SHOW, alertType: .ALERT)

        // 실패
        let customActionResult = CustomActionResult(id: id, success: false, message: "Coupon download was failed.", status: .HIDE, alertType: .TOAST)

        result(customActionResult)
    }
    ...
}

handleError(code:, message:)

방송 전 또는 방송 중 발생하는 오류 상황에 관한 메시지를 전달합니다.

handleError(code: String, message: String)

매개변수

설명

code

오류 코드

message

오류 메시지

샘플 코드

extension MainViewController: ShopLiveSDKDelegate {
    func handleError(code: String, message: String) {}
        print("handleError \(code) \(message)")
    }
    ...
}

Did this page help you?