GuidesAPI GuideChangelog
Log In
Guides

로그아웃 처리

자사몰에서 로그아웃했을 때 플레이어에 남은 회원 토큰을 폐기하고 게스트로 진입시키는 방법입니다. 연동 방식에 맞게 logOut 명령이나 예약값 guest 를 전달합니다.

로그아웃 처리 — 소스라이브 플레이어
⏱ 예상 소요 시간: 10분
📋 사전 조건: 사용자 인증 연동 완료
로그아웃 처리가 필요한 이유

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 · 브릿지에서 시청 중 로그아웃을 반영하려면 플레이어를 다시 띄우세요.

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

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

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