브릿지 이벤트 연동
소스라이브 플레이어와 자사몰 사이의 양방향 이벤트 통신 구조입니다. 상품 클릭, 쿠폰 다운로드, 로그인 요청 등 플레이어 내 이벤트가 발생하면 자사몰에서 직접 처리할 수 있습니다. 소스라이브 플레이어 웹 SDK의 on으로 필요한 이벤트만 등록하고, 등록하지 않은 클릭은 웹 SDK가 기본 동작으로 처리합니다.
브릿지 이벤트 동작 원리
플레이어에서 이벤트가 발생하면 소스라이브 플레이어 웹 SDK가 자사몰 페이지로 전달합니다. 자사몰은 SauceLive.Player('on', 이벤트 이름, 처리 함수)로 필요한 이벤트의 수신 처리를 구현합니다.
소스라이브 플레이어
이벤트 발생
상품 클릭, 쿠폰 다운로드, 로그인 버튼 클릭, 리워드 달성 등의 액션 발생 시 브릿지 이벤트를 통해 전달합니다.
웹 SDK
웹
SauceLive.Player('on', …)
→
자사몰
이벤트 처리
등록한 처리 함수에서 이벤트를 수신하고, 페이지 이동·API 호출 등 원하는 동작을 수행합니다.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요. 앱이 플레이어 주소를 바로 열면 이벤트는 앱의 네이티브 브릿지로 전달됩니다.
적용 방법
설치 코드 뒤에 구현해야 할 이벤트만 추가합니다.
JavaScript
SauceLive.Player('on', 'loginClick', (e) => { // e.broadcastId · shopId · shopName 로 요청 출처 식별 가능 location.href = '/login' }) SauceLive.Player('on', 'productClick', (e) => { // 등록하지 않으면 웹 SDK가 linkUrl로 이동한다. 새 창으로 열 때만 등록 window.open(e.linkUrl, '_blank') }) // 필요한 이벤트를 추가하세요
⚠️ 등록한 클릭은 기본 이동(링크 이동 · 플로팅 이어 보기)이 실행되지 않습니다. 필요한 이동은 처리 함수에서 모두 구현하세요.
방송마다 다르게 처리하려면 처리 함수 안에서
방송마다 다르게 처리하려면 처리 함수 안에서
broadcastId로 구분하세요.
브릿지 없이 동작하는 것
아래 동작에는 자사몰 코드가 필요하지 않습니다. 플레이어와 웹 SDK가 자체적으로 처리합니다.
-
✓채팅 — 입력·전송·표시와 금칙어·차단 처리까지 플레이어 안에서 끝납니다
-
✓상품·쿠폰·리워드 화면 — 목록과 버튼을 그리는 것은 플레이어가 합니다. 브릿지가 필요한 지점은 클릭한 뒤의 동작입니다
-
✓쿠폰
apiDownload— 어드민에 등록한 고객사 API를 플레이어가 직접 호출합니다 -
✓상품·배너·리워드·쿠폰
link— 클릭 이벤트를 등록하지 않으면 웹 SDK가linkUrl로 이동합니다. 같은 자사몰 안의 주소면 플레이어를 플로팅으로 줄여 다음 페이지에서 이어 재생합니다(조건은 상품 클릭 연동) -
✓쿠폰
newWindow· 슬롯 배너 — 등록하지 않으면 웹 SDK가 새 창으로 엽니다. 슬롯 배너는 설정에 따라 같은 창에서 엽니다 -
✓공유·닫기 — 등록하지 않으면 웹 SDK가 자사몰 페이지 주소를 공유하고, 닫기는 플레이어를 닫습니다
❗ 이벤트를 등록하지 않으면 동작하지 않는 것도 있습니다. 로그인 이동(
loginClick), 쿠폰 download·custom(couponClick), 라이브 알림 신청·해제(notificationRequest)는 자사몰이 받아서 처리해야 합니다.
지원 이벤트 목록
웹 SDK가 전송하는 주요 이벤트 목록과 각 이벤트의 상세 가이드입니다. 이벤트 값의 전체 필드 구조는 브릿지 이벤트 레퍼런스에서 확인하세요.
📘 구현 우선순위
자사몰은 로그인 연동이 필수입니다. 상품 클릭·리워드·쿠폰
자사몰은 로그인 연동이 필수입니다. 상품 클릭·리워드·쿠폰
link·newWindow는 등록하지 않아도 웹 SDK가 기본 동작으로 처리하므로, 기본 동작과 다르게 처리할 때 등록하세요. 쿠폰 download·custom과 라이브 알림은 해당 기능을 어드민에서 활성화한 경우에만 구현합니다.
| 이벤트 | 카테고리 | 구현 조건 | 설명 | 상세 가이드 |
|---|---|---|---|---|
| loginClick | 로그인 연동 | 필수 | 게스트가 채팅·쿠폰 등 로그인 필요 기능에 접근할 때 전송됩니다. broadcastId·shopId·shopName으로 요청 출처를 식별할 수 있습니다. 등록하지 않으면 로그인 페이지로 이동하지 않습니다. |
가이드 보기 → |
| productClick | 상품 클릭 | 직접 처리 시 | 플레이어 내 상품을 클릭했을 때 전송됩니다. linkUrl에 상품 페이지 URL이 포함됩니다. 등록하지 않으면 웹 SDK가 이 URL로 이동합니다. |
가이드 보기 → |
| couponClick | 쿠폰 버튼 클릭 | download·custom 쿠폰 사용 시 | 쿠폰 버튼 클릭 시 전송됩니다. couponType으로 처리 방식을 구분합니다. 쿠폰 코드·ID 등이 포함됩니다. |
가이드 보기 → |
| rewardClick | 리워드 CLICK 버튼 클릭 | 직접 처리 시 | 리워드 달성 후 CLICK 버튼을 클릭할 때 전송됩니다. 리워드 처리를 위한 링크 URL이 포함됩니다. 등록하지 않으면 웹 SDK가 이 URL로 이동합니다. | 가이드 보기 → |
| notificationRequest | 라이브 알림 버튼 | 라이브 알림 사용 시 | 라이브 예고 플레이어의 알림 버튼을 누를 때 전송됩니다. 알림 신청·해제 처리 후 respondToNotification 명령으로 결과를 돌려줘야 합니다. |
가이드 보기 → |
플레이어로 보내는 명령
방향이 반대인 호출입니다. 자사몰이 SauceLive.Player('명령', 인자)로 플레이어에 전송하고, 결과를 Promise로 돌려받습니다.
| 명령 | 전송 시점 | 설명 | 상세 가이드 |
|---|---|---|---|
logInlogInMember |
자사몰 로그인 후 | 회원 토큰(JWT 인증) 또는 회원 아이디·별명(간편 인증)으로 시청자를 회원으로 전환합니다. | 가이드 보기 → |
logOutenterAsGuest |
자사몰 로그아웃 후 | 시청자를 게스트로 전환합니다. 자사몰 로그아웃을 플레이어에 반영할 때 사용합니다. 두 명령의 동작은 같습니다. | 가이드 보기 → |
respondToNotification |
알림 처리 후 | 라이브 알림 신청·해제 결과를 알립니다. 결과를 받을 때까지 알림 버튼이 잠깁니다. | 가이드 보기 → |
📘 각 이벤트 값의 전체 필드 구조와 타입은 브릿지 이벤트 레퍼런스에서 확인하세요.
Updated 4 days ago
Did this page help you?
