로그인 연동
게스트가 채팅·쿠폰 등 로그인이 필요한 기능에 접근할 때, 소스라이브 플레이어 웹 SDK가 전송하는 loginClick 이벤트를 수신하여 자사몰의 로그인 흐름으로 연결합니다.
이벤트 발생 시점
소스라이브 플레이어에서 아래 기능은 로그인한 회원만 사용할 수 있습니다. 게스트가 접근 시 로그인 유도 UI가 표시되고, 「로그인」을 누르면 소스라이브 플레이어 웹 SDK가 loginClick 이벤트를 자사몰로 전송합니다.
플레이어 내 로그인을 사용하는 자사몰은 플레이어 안의 로그인 창이 열리고 loginClick은 전송되지 않습니다.
로그인 하시겠습니까?
취소
로그인
▲ 게스트가 로그인이 필요한 기능을 누르면 표시되는 플레이어 화면
로그인이 필요한 기능: 채팅 참여, 리워드 참가, 이벤트(퀴즈·투표 등) 참여, 상품 찜, 라이브 알림 신청, 로그인이 필요하다고 설정한 쿠폰
동작 흐름
이벤트 수신 후 자사몰의 로그인 페이지로 이동시키고, 로그인 완료 후 returnUrl을 통해 플레이어가 있는 페이지로 다시 돌아오게 합니다.
🔐 로그인 버튼 클릭
→
📨 loginClick 수신
→
🔀 로그인 페이지 이동
→
✅ returnUrl로 복귀
구현 방법
로그인 페이지로 이동만 시킬 때는 이벤트 값이 필요하지 않습니다. 여러 상점을 운영하거나 복귀 URL을 직접 조립할 때 사용합니다.
/signin과 returnUrl은 예시입니다. 자사몰의 로그인 주소와 쿼리 이름으로 바꾸세요.
JavaScript — 리다이렉트 방식
SauceLive.Player('on', 'loginClick', (e) => { // e: { broadcastId, shopId, shopName } — 로그인 요청 출처 // 현재 페이지 URL을 returnUrl로 저장 후 로그인 페이지로 이동 const returnUrl = location.href location.href = `/signin?returnUrl=${encodeURIComponent(returnUrl)}&shopId=${e.shopId ?? ''}` })
📘 returnUrl 활용: 로그인 완료 후
returnUrl에 담긴 페이지로 리다이렉트하면 사용자가 라이브를 보던 페이지로 돌아옵니다. e.broadcastId로 복귀 URL을 직접 조립할 수도 있습니다.
⚠️ 자사몰은
loginClick을 반드시 등록하세요. 웹 SDK는 자사몰의 로그인 주소를 모르기 때문에, 등록하지 않으면 로그인 버튼을 눌러도 로그인 페이지로 이동하지 않습니다.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요.
이벤트 데이터
loginClick은 라이브와 상점 정보를 이벤트 값으로 전달합니다.
전달되는 데이터 구조
{
"broadcastId": "lkSHOP-12d3892e16c94c1282a7821d17de6c77",
"shopId": "SHOP001",
"shopName": "소스라이브 스토어"
}
| 필드 | 타입 | 설명 |
|---|---|---|
| broadcastId | String | 로그인이 요청된 라이브 ID. 복귀 URL 조립에 활용합니다. |
| shopId | String | null | 라이브를 진행 중인 상점 ID. 여러 상점을 운영할 때 로그인 경로 분기에 활용합니다. |
| shopName | String | null | 상점 이름. 로그인 화면 안내 문구 등 표시용으로 활용합니다. |
📘 로그인 완료 후 회원 정보를 플레이어에 전달하는 방법은 연동 방식에 따라 다릅니다.
라이브러리 방식 — 사용자 인증 가이드를 참고하여
URL 방식 — 로그인 완료 후
라이브러리 방식 — 사용자 인증 가이드를 참고하여
logIn(JWT 인증) 또는 logInMember(간편 인증) 명령을 호출하세요. 실제 서비스에는 JWT 인증을 권장합니다.URL 방식 — 로그인 완료 후
accessToken 쿼리 파라미터를 포함한 플레이어 URL로 리다이렉트하세요. (URL 연동 가이드 참고)
Updated 4 days ago
Did this page help you?
