GuidesAPI GuideChangelog
Log In
Guides

에러 가이드

소스라이브 플레이어 웹 SDK 연동 중 자주 발생하는 이슈와 해결 방법입니다. 증상에 맞는 항목을 확인하세요.

에러 가이드 — 소스라이브 플레이어
증상으로 찾는 빠른 진단
증상가장 흔한 원인바로가기
플레이어가 표시되지 않음구형 코드가 남음 · 파트너 ID 오류 · CSP 차단오류 코드 확인 →
채팅 입력 시 UI가 잘리거나 밀림 (iOS)viewport 메타 태그 누락iOS · UI 해결 →
JWT를 설정했는데 게스트로 표시됨토큰 payload 필드 누락 또는 형식 오류(MEMBER_TOKEN_FAILED)JWT · 인증 해결 →
로그아웃했는데 이전 회원으로 진입함몰에서 로그아웃할 때 logOut 명령을 호출하지 않음로그아웃 처리 →
상품 클릭·쿠폰·로그인 버튼이 무반응로그인 · 쿠폰 이벤트 미등록 또는 허용하지 않는 이동 주소브릿지 이벤트 해결 →
브릿지 이벤트가 전혀 수신되지 않음웹 SDK가 시작하지 못함오류 코드 확인 →
플로팅에서 전체 화면 전환이 안 됨확대 클릭 이벤트를 등록하고 처리하지 않음FAQ에서 확인 →
📱
iOS · UI
채팅 입력 시 UI가 잘리거나 밀리는 현상
iOS Safari / WebView에서 키보드 등장 시 레이아웃 깨짐
viewport 메타 태그가 없는 경우 발생합니다. 웹 SDK는 플레이어를 크게 표시하는 동안 이 태그의 maximum-scale을 1.0으로 두어 입력칸 확대를 막고, 태그가 없으면 새로 만들지 않습니다.
플레이어를 넣는 페이지의 <head>에 아래 메타 태그를 추가하세요.
HTML — <head>에 추가
<meta name="viewport"
      content="width=device-width, initial-scale=1.0">
🔐
JWT · 인증
JWT 토큰을 설정했는데 게스트로 로그인됨
auth: { token } · logIn 적용 후에도 로그인 하지 않은 상태로 표시되는 경우
JWT 토큰 생성 과정에서 Header 설정 오류, 잘못된 서명 키, 필수 payload 누락 등이 있으면 서버에서 토큰 검증에 실패해 게스트로 처리됩니다.
JavaScript — 올바른 적용 방법
// 페이지를 열 때 로그인 상태면 시작 옵션으로
SauceLive.Player('init', { partnerId: '파트너 ID', auth: { token: jwt } });

// 페이지를 연 뒤 로그인했으면 명령으로

SauceLive.Player('logIn', jwt);
1
JWT Header에 알고리즘 정보를 정확히 설정했나요?
"typ": "JWT"와 "alg": "RS256" 두 필드가 모두 포함되어야 합니다.
JWT Header
{ "typ": "JWT", "alg": "RS256" }
2
모비두에서 받은 PEM 키로 서명했나요?
직접 만든 키가 아니라 모비두에서 받은 RS256 개인키(PEM)여야 합니다.
3
토큰을 Base64로 인코딩했나요?
JWT는 Header · Payload · Signature 각각을 Base64URL로 인코딩해 .으로 이어 붙여야 합니다.
4
필수 payload 필드가 모두 포함되어 있나요?
partnerId · memberId · nickName · memberType이 모두 있어야 합니다. 닉네임 필드는 nickName(N 대문자)이고, 실명이면 마스킹 처리를 권장합니다. 필드 규격은 API 문서의 JWT Token 생성에 있습니다.
📘 JWT 토큰 생성 전체 과정은 사용자 인증 가이드에 있습니다.
🔗
브릿지 이벤트
상품 클릭 또는 일부 기능이 동작하지 않음
상품 링크 이동 불가, 쿠폰 다운로드 무반응, 로그인 버튼 미동작
로그인 · 쿠폰 다운로드는 자사몰에서 브릿지 이벤트를 직접 등록해야 동작합니다. 상품 · 배너는 허용하지 않는 주소면 이동하지 않고 BLOCKED_URL 오류로 알립니다.
브릿지 이벤트 연동을 참고해 SauceLive.Player('on', …)으로 이벤트를 등록하세요.
JavaScript — 최소 브릿지 이벤트 구현 예시
SauceLive.Player('on', 'loginClick', () => {
  location.href = '/login?returnUrl=' + encodeURIComponent(location.href);
});
SauceLive.Player('on', 'couponClick', (e) => {
  // e.couponId · e.couponCode 로 몰 쿠폰을 발급합니다
});
// 필요한 이벤트를 추가하세요
📘 이벤트 값은 브릿지 이벤트 레퍼런스에 있습니다.
📡
오류 코드
플레이어가 표시되지 않거나 명령이 실패함
구형 코드가 남음 · 파트너 ID 오류 · CSP 차단
error 이벤트와 명령의 Promise 거절에서 err.code를 받고, 레퍼런스의 오류 코드 표에서 할 일을 확인하세요.
JavaScript — 두 곳에서 받기
SauceLive.Player('on', 'error', (err) => {
  console.warn('SauceLive', err.code);
});

document.getElementById('live-open').addEventListener('click', async () => {
  try {
    await SauceLive.Player('open', { broadcastId: '라이브 ID' });
  } catch (err) {
    console.warn('SauceLive', err.code);
  }
});
⚠️ saucelive-player.min.js가 실행되기 전에 호출한 명령은 Promise를 돌려주지 않아 실패를 못 받습니다. 결과를 받을 명령은 페이지 load 뒤(예: 버튼 클릭)에 호출하세요.

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

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

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