에러 가이드
소스라이브 플레이어 웹 SDK 연동 중 자주 발생하는 이슈와 해결 방법입니다. 증상에 맞는 항목을 확인하세요.
증상으로 찾는 빠른 진단
| 증상 | 가장 흔한 원인 | 바로가기 |
|---|---|---|
| 플레이어가 표시되지 않음 | 구형 코드가 남음 · 파트너 ID 오류 · CSP 차단 | 오류 코드 확인 → |
| 채팅 입력 시 UI가 잘리거나 밀림 (iOS) | viewport 메타 태그 누락 | iOS · UI 해결 → |
| JWT를 설정했는데 게스트로 표시됨 | 토큰 payload 필드 누락 또는 형식 오류(MEMBER_TOKEN_FAILED) | JWT · 인증 해결 → |
| 로그아웃했는데 이전 회원으로 진입함 | 몰에서 로그아웃할 때 logOut 명령을 호출하지 않음 | 로그아웃 처리 → |
| 상품 클릭·쿠폰·로그인 버튼이 무반응 | 로그인 · 쿠폰 이벤트 미등록 또는 허용하지 않는 이동 주소 | 브릿지 이벤트 해결 → |
| 브릿지 이벤트가 전혀 수신되지 않음 | 웹 SDK가 시작하지 못함 | 오류 코드 확인 → |
| 플로팅에서 전체 화면 전환이 안 됨 | 확대 클릭 이벤트를 등록하고 처리하지 않음 | FAQ에서 확인 → |
원인
viewport 메타 태그가 없는 경우 발생합니다. 웹 SDK는 플레이어를 크게 표시하는 동안 이 태그의
maximum-scale을 1.0으로 두어 입력칸 확대를 막고, 태그가 없으면 새로 만들지 않습니다.
해결 방법
플레이어를 넣는 페이지의
<head>에 아래 메타 태그를 추가하세요.
HTML — <head>에 추가
<meta name="viewport" content="width=device-width, initial-scale=1.0">
원인
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)여야 합니다.
직접 만든 키가 아니라 모비두에서 받은 RS256 개인키(PEM)여야 합니다.
3
토큰을 Base64로 인코딩했나요?
JWT는 Header · Payload · Signature 각각을 Base64URL로 인코딩해
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 로 몰 쿠폰을 발급합니다 }); // 필요한 이벤트를 추가하세요
📘 이벤트 값은 브릿지 이벤트 레퍼런스에 있습니다.
원인 확인
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 뒤(예: 버튼 클릭)에 호출하세요.
Updated 4 days ago
Did this page help you?
