GuidesAPI GuideChangelog
Log In
Guides

라이브러리 설치

설치 코드 삽입부터 플레이어 첫 실행까지, 게스트 모드 기준의 가장 기본적인 연동 과정입니다. 소스라이브 플레이어 웹 SDK를 몰 페이지에 설치합니다.

라이브러리 설치 — 소스라이브 플레이어
⏱ 예상 소요 시간: 10분
📋 사전 조건: 파트너 ID 발급
📌 구형 라이브러리를 쓰고 있다면 구형 라이브러리에서 옮기기를 먼저 확인하세요.
전체 동작 흐름

선택 항목은 필요한 경우에만 추가하세요.

① 설치 코드
→
② 컨테이너 추가
→
③ 시작 옵션 선택
→
④ 플레이어 실행
1
설치 코드 삽입
플레이어를 표시할 모든 페이지의 <head>에 설치 코드를 추가하고, 파트너 ID를 모비두 담당자가 발급한 값으로 바꾸세요.
HTML
<script>(function(w,n){var s=w[n]=w[n]||{};s.Player=s.Player||function(){(s.Player.q=s.Player.q||[]).push(arguments)}})(window,'SauceLive');</script>
<script async src="https://player.sauceflex.com/static/web-sdk/saucelive-player.min.js"></script>
<script>SauceLive.Player('init', { partnerId: '파트너 ID' });</script>
📘 웹 SDK는 CDN에서 로드되므로 패키지 설치나 빌드가 필요 없습니다.
📘 stage 라이브는 saucelive-player.min.js 주소의 player.를 stage.player.로 바꿔 테스트하세요.
⚠️ saucelive-player.min.js 스크립트에 crossorigin 속성을 붙이지 마세요.
2
컨테이너 추가
플레이어를 표시할 <div> 컨테이너를 추가하고 CSS로 너비를 지정합니다.
HTML + CSS
<style>
  #saucelive-player {
    max-width: 360px;
    margin: auto;
  }
</style>

<!-- 플레이어를 표시할 컨테이너 -->
<div id="saucelive-player"></div>
📘 권장 비율 — 9:16. 높이를 지정하지 않으면 너비에 맞춘 9:16 높이가 적용됩니다. 컨테이너 안은 비워 두세요.
3
시작 옵션 init
시작 옵션은 설치 코드의 init에 partnerId와 함께 넣습니다.
JavaScript
SauceLive.Player('init', {
  partnerId: '파트너 ID',           // 필수
  // broadcastId: '라이브 ID',        // 선택 — 정해 둔 방송을 띄울 때
  // container: '#saucelive-player', // 선택 — 컨테이너 선택자 (기본값: '#saucelive-player')
});
파라미터타입필수기본값설명
partnerId String 필수 - 계약 후 발급받은 파트너 ID
broadcastId String 선택 - 어드민에서 확인한 라이브 ID. 미설정 시 가장 최근에 시작한 라이브를 표시합니다.
라이브 편성 · 승인 뒤 송출 정보에서 확인합니다.
container String
Element
선택 #saucelive-player 플레이어를 표시할 컨테이너
platform String 선택 - 웹빌더 식별값. 직접 구축한 자사몰은 설정하지 않습니다
📘 전체 시작 옵션은 라이브러리 파라미터 레퍼런스에 있습니다.
어드민 송출정보에서 라이브 ID 확인
▲ 어드민 분석 > 라이브 > 상세 > 송출정보에서 라이브 ID를 확인·복사
4
플레이어 실행
컨테이너가 있는 페이지는 설치 코드만으로 플레이어가 표시되고, 없는 페이지는 open 명령으로 방송을 모달로 엽니다.
HTML
<button type="button" id="live-open">라이브 보기</button>
<script>
  document.getElementById('live-open').addEventListener('click', () => {
    SauceLive.Player('open', { broadcastId: '라이브 ID' }); // 방송을 모달로 엽니다
  });
</script>
📘 라이브 중인 방송이 없으면 오류 없이 비어 있다가, 1분마다 다시 확인해 시작되면 표시합니다.
전체 완성 예시

위 단계를 한 HTML 파일로 모은 예시입니다. 파트너 ID만 바꾸면 실행됩니다.

HTML — 완성 예시
<!DOCTYPE html>
<html lang="ko">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>소스라이브 플레이어 테스트</title>
  <script>(function(w,n){var s=w[n]=w[n]||{};s.Player=s.Player||function(){(s.Player.q=s.Player.q||[]).push(arguments)}})(window,'SauceLive');</script>
  <script async src="https://player.sauceflex.com/static/web-sdk/saucelive-player.min.js"></script>
  <script>SauceLive.Player('init', { partnerId: '파트너 ID' });</script>
  <style>
    #saucelive-player { max-width: 360px; margin: auto; }
  </style>
</head>
<body>
  <div id="saucelive-player"></div>
</body>
</html>
플레이어 실행 결과 화면
▲ 플레이어 실행 화면
구형 라이브러리에서 옮기기

모든 페이지에서 구형 <script>와 SauceLiveLib. 호출을 지운 뒤 위 순서대로 설치하세요.

📌 구형 코드가 남은 페이지에서는 웹 SDK가 플레이어를 띄우지 않고 멈추며, error 이벤트로 LEGACY_MODULE_PRESENT를 한 번 보냅니다.
앱 WebView 환경에서 사용하는 경우

앱 WebView에서는 iOS·Android 모두 인라인 재생과 자동 재생을 허용하세요. 허용하지 않으면 영상이 재생되지 않습니다.

Swift
let configuration = WKWebViewConfiguration()
configuration.allowsInlineMediaPlayback = true
let webView = WKWebView(frame: rect, configuration: configuration)
Kotlin
webView.getSettings().setMediaPlaybackRequiresUserGesture(false)

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

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

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