URL 연동

소스클립 도메인의 플레이어 주소로 페이지를 이동시키는 방식입니다. 주소 구조와 파라미터, 앱 웹뷰에서의 연동을 다룹니다.

URL 연동 — 소스클립 플레이어

⏱ 예상 소요 시간: 10분

📋 사전 조건: 파트너 ID · 클립 ID

주소 구조

파트너 ID와 클립 ID를 쿼리로 붙입니다.

text

https://player.sauceclip.com/player?partnerUniqueId=파트너 ID&clipId=클립 ID

💡 스테이지 환경. 운영 도메인 앞에 stage. 를 붙입니다 — https://stage.player.sauceclip.com/player

파라미터

파라미터	타입	필수	설명
partnerUniqueId	String	필수	파트너 ID
clipId	String	선택	처음 재생할 클립 ID
curationId	String	선택	스와이프로 이어질 클립을 이 큐레이션 안으로 제한
clipIds	String	선택	재생할 클립 ID 목록을 콤마로 나열. 지정한 순서대로 재생되며 최대 100개
accessToken	String	선택	로그인한 시청자의 소스 JWT 토큰. 사용자 인증 참조

⚠️ clipId 와 clipIds 는 함께 쓰지 않습니다. clipIds 가 있으면 목록 조회 방식으로 동작합니다.

📍 clipIds 의 값 중 정수가 아니거나 0 이하인 값은 목록에서 제외됩니다. 101번째부터도 제외됩니다.

주소 갱신

플레이어 안에서 스와이프하면 주소의 clipId 가 재생 중인 클립으로 바뀝니다. 시청자가 그 주소를 복사하면 보던 클립이 열립니다.

브릿지 이벤트 받기

이 주소를 그대로 열면 브릿지 이벤트는 앱 웹뷰에서 받습니다. 자사몰 페이지 안에서 받으려면 라이브러리 연동을 씁니다.

📌 자사몰 페이지에서 브릿지 이벤트를 받으려면 라이브러리 연동을 씁니다.

앱 웹뷰

앱에서는 이 주소를 웹뷰로 엽니다. 이동과 관련된 동작은 웹뷰 안에서 처리되지 않으므로 브릿지 이벤트 구현이 함께 필요합니다.

📌 수신 코드와 웹뷰 설정은 앱 웹뷰 수신에 있습니다.

Updated about 4 hours ago

Did this page help you?