Event handler

Event handler — 소스라이브 플레이어 Android SDK

📡 콜백 4개

콜백 전체

플레이어가 앱에 알려 주는 이벤트입니다.

콜백	전달값	언제 호출되나	플레이어
`onLoginRequest`	없음	게스트 참여가 허용되지 않은 방송에서 게스트가 채팅을 시도하고 로그인 안내를 확인했을 때 → 로그인이 필요한 순간 처리하기	닫힘 로그인 후 다시 실행해야 합니다
`onCouponDownload`	`couponCode: String` 어드민에 등록한 쿠폰 코드	`download` 타입 쿠폰을 시청자가 받았을 때 → A. 쿠폰 사용하기	유지
`onCouponCustom`	`couponData: String` 어드민에 등록한 데이터. 형식이 정해져 있지 않습니다	`custom` 타입 쿠폰을 시청자가 받았을 때	유지
`onCart`	`productId: String` 어드민에 등록한 상품 ID. 비어 있을 수 있습니다	시청자가 장바구니 담기를 눌렀을 때 → 5. 상품 클릭 관리	유지
`onProductClick`	이동할 구매 페이지 주소	시청자가 상품·배너를 눌러 구매 페이지로 이동할 때 등록하지 않으면 플레이어가 외부 브라우저로 엽니다 → 5. 상품 클릭 관리	유지

등록 방법

플레이어를 실행하기 전에 등록합니다.

Kotlin

SauceClient.setLivePlayerCallbackListener(object : LivePlayerCallbackListener {
    override fun onLoginRequest() { }
    override fun onCouponDownload(couponCode: String) { }
    override fun onCouponCustom(couponData: String) { }
    override fun onCart(productId: String) { }
})

⚠️ 인터페이스라 선언한 콜백을 모두 구현해야 합니다. 쓰지 않는 것도 빈 본문으로 둡니다. onProductClick 을 쓴다면 이 목록에 함께 넣으세요.

콜백으로 오지 않는 것

아래는 콜백 자체가 없습니다. 플레이어가 자체 처리하거나 앱이 개입할 수 없습니다.

이벤트	현재 동작
플레이어 종료·닫기	플레이어가 스스로 정리합니다. 앱에 알리지 않습니다
오류 발생	로그에 남습니다 → Error codes
채팅 메시지	플레이어가 자체 처리. 송·수신 모두 불가 → 4. 채팅 사용하기
쿠폰 (download·custom 외)	플레이어가 자체 처리 → A. 쿠폰 사용하기
닉네임 변경	플레이어가 자체 처리

💡 iOS 와 다릅니다 — 상품·쿠폰 콜백은 양쪽 모두 제공하지만, iOS 는 오류·닫기 콜백을 더 제공합니다. 플랫폼 차이는 APP 개발 가이드 (SDK)에서 확인하세요.

다음 단계

🚨 Error codes — 오류를 확인하는 방법

→