라이브러리 설치
설치 코드 삽입부터 플레이어 첫 실행까지, 게스트 모드 기준의 가장 기본적인 연동 과정입니다. 소스라이브 플레이어 웹 SDK를 몰 페이지에 설치합니다.
📌 구형 라이브러리를 쓰고 있다면 구형 라이브러리에서 옮기기를 먼저 확인하세요.
전체 동작 흐름
선택 항목은 필요한 경우에만 추가하세요.
① 설치 코드
→
② 컨테이너 추가
→
③ 시작 옵션 선택
→
④ 플레이어 실행
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를 확인·복사
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)
다음 단계
플레이어가 정상 실행되었다면 필요한 기능을 순서대로 추가하세요.
Updated 4 days ago
Did this page help you?
