GuidesAPI GuideChangelog
Log In
Guides

플로팅 모드

작은 창으로 전환하는 시점을 정하는 설정입니다. basic 은 처음부터 작은 창으로, scroll 은 원래 플레이어가 화면 밖으로 나갈 때 전환합니다.

플로팅 모드 — 소스라이브 플레이어
예상 소요 시간: 5분
📋 사전 조건: 플로팅 플레이어 개요 확인
🔧 필수 단계type 은 생략할 수 없습니다
플로팅 모드 선택

setFloatingType()type 값으로 모드를 선택합니다.
type필수이고, 나머지 파라미터는 모두 선택입니다.

비교 항목📌 기본 플로팅 basic📜 스크롤 플로팅 scroll
등장 시점페이지 로드 시 바로 플로팅 플레이어로 표시임베드된 플레이어를 지나 스크롤할 때 플로팅으로 전환
전제 조건일반 플레이어 영역이 없어도 됨페이지에 일반 플레이어가 임베드되어 있어야 자연스러움
닫기 버튼사라진 뒤 재접속 시 다시 노출사라진 뒤 원래 위치로 스크롤하면 다시 생성
확대 버튼기본 플레이어 링크로 이동플레이어 위치(최상단)로 스크롤
위치 이동(드래그)가능 — 드래그 후 가까운 모서리로 자동 정렬불가 — 지정한 위치에 고정
추천 상황플로팅을 단독으로 사용하거나, 라이브 링크를 공유해 바로 시청하게 할 때상세페이지에 플레이어가 있고, 스크롤로 지나쳐도 시청을 유지하고 싶을 때

📌 기본 플로팅 type: 'basic'

페이지 로드 시 바로 플로팅 플레이어 형태로 나타납니다.

상품 상세 이미지 × ⚡ 로드 시 바로 →
  • 닫기 버튼: 플로팅 플레이어가 사라지며, 재접속 시 다시 노출됩니다.
  • 확대 버튼: 기본 플레이어 링크로 리다이렉트됩니다.
이런 상황에 적합
  • 별도 일반 플레이어 영역 없이 플로팅만 단독으로 사용할 때
  • 라이브 링크를 공유해 바로 플로팅으로 시청하게 할 때

📜 스크롤 플로팅 type: 'scroll'

플레이어가 화면에서 보이지 않을 때 스크롤 이벤트에 따라 플로팅 형태로 전환됩니다.

LIVE 63% 43,070원 상품 설명 영역 1 상품 설명 영역 2 상품 설명 영역 3 × 스크롤 ↓
  • 닫기 버튼: UI가 사라지지만 원래 위치로 스크롤 시 다시 생성됩니다.
  • 확대 버튼: 최상단 위치로 스크롤을 올려줍니다.
이런 상황에 적합
  • 자사몰 페이지에 일반 플레이어가 이미 임베드되어 있을 때
  • 사용자가 스크롤해 플레이어를 지나쳐도 시청을 유지시키고 싶을 때
JavaScript — 기본 플로팅
window.SauceLiveLib.setInit({ broadcastId: '라이브ID를 입력해주세요' });
window.SauceLiveLib.setFloatingType({ type: 'basic' });
window.SauceLiveLib.load();
JavaScript — 스크롤 플로팅
window.SauceLiveLib.setInit({ broadcastId: '라이브ID를 입력해주세요' });
window.SauceLiveLib.setFloatingType({ type: 'scroll' });
window.SauceLiveLib.load();

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

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

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