GuidesAPI GuideChangelog
Log In
Guides

로그인 연동

게스트가 채팅·쿠폰 등 로그인이 필요한 기능에 접근할 때, 소스라이브 플레이어 웹 SDK가 전송하는 loginClick 이벤트를 수신하여 자사몰의 로그인 흐름으로 연결합니다.

로그인 연동 — 소스라이브 플레이어
⏱ 예상 소요 시간: 15분
📋 사전 조건: 브릿지 이벤트 연동 완료
이벤트 발생 시점

소스라이브 플레이어에서 아래 기능은 로그인한 회원만 사용할 수 있습니다. 게스트가 접근 시 로그인 유도 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 상점 이름. 로그인 화면 안내 문구 등 표시용으로 활용합니다.
📘 로그인 완료 후 회원 정보를 플레이어에 전달하는 방법은 연동 방식에 따라 다릅니다.

라이브러리 방식 — 사용자 인증 가이드를 참고하여 logIn(JWT 인증) 또는 logInMember(간편 인증) 명령을 호출하세요. 실제 서비스에는 JWT 인증을 권장합니다.
URL 방식 — 로그인 완료 후 accessToken 쿼리 파라미터를 포함한 플레이어 URL로 리다이렉트하세요. (URL 연동 가이드 참고)

Did this page help you?
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.