WEB 개발 가이드
자사몰 웹 환경에 소스라이브 플레이어를 연동하기 위한 가이드입니다.
연동 방식을 선택하고 아래 권장 순서대로 진행하면 빠르게 연동을 완료할 수 있습니다.
Step 1
연동 방식을 선택하세요
소스라이브 웹 플레이어는 두 가지 방식으로 연동할 수 있습니다. 대부분의 경우 라이브러리 방식을 권장합니다.
| 📦 라이브러리 방식 | 🔗 URL 방식 | |
|---|---|---|
| 플레이어 위치 | 자사몰 페이지 내 직접 삽입 | 플레이어 기본 화면으로 이동 |
| 개발 난이도 | 보통 | 낮음 |
| 사용자 인증 | 게스트 모드 / 간편 인증 / JWT / 플레이어 내 로그인 선택 가능 | 게스트 모드 / JWT (쿼리 파라미터 방식) / 플레이어 내 로그인 선택 가능 |
| 브릿지 이벤트 | 지원 ✓ | 미지원 ✗ |
| 플로팅 기능 | 지원 ✓ | 미지원 ✗ |
| 적합한 상황 | 자사몰 내 플레이어 임베드, 상품·쿠폰 이벤트 처리 필요 시 | 빠른 연동, 외부 채널 링크 공유 시 |
💡 두 방식을 함께 사용할 수 있습니다. 자사몰 내에는 라이브러리 방식으로 플레이어를 삽입하고, SNS·이메일 등 외부 공유용으로는 URL 방식을 병행하는 것이 일반적입니다.
Step 2
권장 작업 순서
라이브러리 방식 기준 권장 순서입니다. 선택 항목은 서비스 요구사항에 따라 추가하세요.
-
3브릿지 이벤트 연동 선택 플레이어 ↔ 자사몰 간 이벤트 핸들링 — 상품 클릭, 쿠폰 발급, 리워드 처리
1
라이브러리 설치
라이브러리 스크립트 삽입 및 기본 표시 확인
→
2
사용자 인증
게스트 모드·간편 인증·JWT·플레이어 내 로그인 중 서비스에 맞는 방식 선택
→
4
플로팅 플레이어 선택
페이지 이동 시에도 플레이어를 작은 화면으로 계속 시청할 수 있도록 구현
→
URL 방식은 별도 설치 없이 가이드만 따라하면 바로 시작할 수 있습니다.
URL 연동 바로 시작하기
단축 URL / 풀 URL 구성 방법, 파라미터 설정, 시나리오별 예시를 한 페이지에서 확인할 수 있습니다.
💡 나중에 라이브러리 방식으로 전환할 수 있습니다. URL 방식으로 빠르게 시작하고, 인증·브릿지 이벤트·플로팅 기능이 필요해지면 라이브러리 방식으로 전환하세요. 전환 부담은 낮습니다.
라이브러리 릴리즈노트
라이브러리 버전별 변경사항을 확인하세요.
API 문서
서버 간 연동을 위한 인증 방식 및 전체 API 규격을 확인할 수 있습니다.
Updated about 10 hours ago