로그아웃 처리
자사몰에서 로그아웃했을 때 플레이어에 남은 회원 토큰을 폐기하고 게스트로 진입시키는 방법입니다. 연동 방식에 맞게 logOut 명령이나 예약값 guest 를 전달합니다.
로그아웃 처리가 필요한 이유
URL · 브릿지 방식으로 띄운 플레이어는 인증에 성공한 회원 토큰을 플레이어 도메인의 쿠키에 저장합니다.
자사몰과 도메인이 다르므로, 자사몰에서 로그아웃해도 이 쿠키는 남아 있습니다.
자사몰 로그아웃
→
토큰 없이 재진입
→
이전 회원으로 진입
라이브러리 방식은 쿠키에 남기지 않지만, 실행 중인 플레이어는 logOut 을 호출해야 게스트가 됩니다.
⚠️ 빈 값은 로그아웃이 아닙니다. URL의
accessToken 을 비워 두면 플레이어가 이를 토큰으로 해석하지 못해 저장된 쿠키를 그대로 사용합니다. 로그아웃에는 예약값 guest 를 사용합니다.
연동 방식별 호출
사용 중인 연동 방식의 것 하나만 적용하세요.
| 연동 방식 | 호출 | 적용 시점 |
|---|---|---|
| 라이브러리 (실행 중인 플레이어) |
logOut 명령 |
몰 로그아웃 직후 |
| 라이브러리 (새로 연 페이지) |
auth 생략 |
init 시 |
| URL | ?accessToken=guest |
플레이어 URL 생성 시 |
| 브릿지 (iframe · 앱 웹뷰) |
sauceflexEnterAsGuest |
sauceflexEnter 수신 직후 |
JavaScript — 라이브러리 방식
// 로그아웃 뒤 연 페이지: 회원 토큰이 없으면 init 에 auth 를 넣지 않습니다 const memberToken = window.MALL_MEMBER_TOKEN ?? null; // 몰 서버가 페이지에 넣은 회원 JWT. 로그아웃 상태면 null SauceLive.Player('init', { partnerId: '파트너 ID', ...(memberToken ? { auth: { token: memberToken } } : {}), }); // 플레이어를 이미 띄운 페이지: 몰의 로그아웃 처리를 마친 뒤 호출합니다 SauceLive.Player('logOut');
📘 간편 인증(
auth.member)도 같은 방법으로 로그아웃합니다.
URL 방식
// 로그인 상태 — 서버에서 발급한 JWT 전달 https://player.sauceflex.com/broadcast/{라이브 ID}?accessToken={JWT} // 로그아웃 상태 — 예약값 전달 https://player.sauceflex.com/broadcast/{라이브 ID}?accessToken=guest
브릿지로 전송하기
플레이어를 iframe 이나 앱 웹뷰로 띄워 URL·라이브러리 호출을 제어할 수 없을 때 사용합니다.
sauceflexEnterAsGuest 는 자사몰·앱이 플레이어로 보내는 이벤트입니다.
⚠️ 전송 시점은
sauceflexEnter 수신 직후입니다. 플레이어는 sauceflexEnter 를 보낸 뒤 세션 처리를 시작하므로, 그 사이에 전송해야 반영됩니다.
JavaScript
const iframe = document.getElementById('sauce-player'); window.addEventListener('message', (e) => { if (typeof e.data !== 'string') return; const { key } = JSON.parse(e.data); if (key !== 'sauceflexEnter') return; if (isLoggedIn) return; // 로그인 상태이면 보내지 않습니다 iframe.contentWindow.postMessage( JSON.stringify({ key: 'sauceflexEnterAsGuest' }), '*' ); });
Kotlin — SauceflexBridge.kt
@JavascriptInterface fun sauceflexEnter() { if (isLoggedIn) return // 로그인 상태이면 보내지 않습니다 activity?.runOnUiThread { webView.evaluateJavascript( "window.postMessage(JSON.stringify({ key: 'sauceflexEnterAsGuest' }), '*')", null ) } }
Swift — WKScriptMessageHandler
case "sauceflexEnter": guard !isLoggedIn else { break } // 로그인 상태이면 보내지 않습니다 webView.evaluateJavaScript( "window.postMessage(JSON.stringify({ key: 'sauceflexEnterAsGuest' }), '*')" )
📘 이벤트 이름과 값은 브릿지 이벤트 레퍼런스 — 앱 웹뷰 이름에서 확인하세요.
동작과 제약
| 항목 | 동작 |
|---|---|
| 회원 토큰 | 저장된 회원 토큰을 폐기하고 게스트로 진입합니다. |
| 게스트 식별자 | 이전에 사용하던 게스트 식별자는 유지됩니다. 회원 정보만 지워지므로, 이전 게스트 닉네임이 그대로 표시될 수 있습니다. |
| 적용 범위 | URL · 브릿지는 플레이어 진입 시점에 한 번 적용됩니다. 라이브러리의 logOut 은 실행 중인 플레이어에 바로 적용됩니다. |
❗ 세션 처리가 끝난 뒤 도착한
sauceflexEnterAsGuest 는 무시됩니다. URL · 브릿지에서 시청 중 로그아웃을 반영하려면 플레이어를 다시 띄우세요.
Updated 1 day ago
Did this page help you?
