브릿지 이벤트 연동
상품 클릭·공유·닫기 같은 동작을 자사몰이 직접 처리하는 이벤트입니다. 정의하면 플레이어의 기본 동작 대신 정의한 함수가 실행됩니다.
이벤트 목록
정의하지 않아도 플레이어가 기본 동작을 수행합니다. 앱 웹뷰는 예외입니다.
| 이벤트 | 전송 시점 | 정의하지 않았을 때 |
|---|---|---|
sauceclipMoveProduct | 상품 클릭 | 상품 링크로 현재 창 이동 |
sauceclipOnShare | 공유 클릭 | 클립 링크를 클립보드에 복사하고 토스트 표시 |
sauceclipMoveExit | 닫기 클릭 | 컨피그에 설정한 주소로 이동, 없으면 뒤로 가기 |
sauceclipMoveChannel | 채널 클릭 | 채널 주소로 현재 창 이동 |
sauceclipMoveLinkButton | 링크 버튼 클릭 | 어드민에 설정한 방식으로 링크 열기 |
sauceclipEnter | 플레이어 진입 | — |
sauceclipTogglePlay | 플로팅 모드에서 플레이어 탭 | 재생·일시정지 전환 |
sauceclipPlayerError | 에러 발생 | — |
⚠️ 앱 웹뷰에서는 이동과 관련된 동작이 웹뷰 안에서 처리되지 않습니다. 상품·채널 이동과 닫기는 브릿지 이벤트로 구현합니다.
수신 방법
플레이어가 놓인 환경에 따라 전달 경로가 다릅니다. 위에서부터 먼저 찾은 경로 하나로만 보냅니다.
| 순서 | 환경 | 받는 곳 | 페이로드 |
|---|---|---|---|
| 1 | 앱 웹뷰 (Android) | sauceclip 인터페이스 | JSON 문자열 |
| 2 | 앱 웹뷰 (iOS) | WKScriptMessageHandler | JSON 문자열 |
| 3 | 동일 페이지 | window 의 같은 이름 함수 | 객체 |
| 4 | iframe | 부모 창의 message 이벤트 | { key, params } JSON 문자열 |
📍 네 경로 중 어디에도 수신부가 없으면 플레이어가 기본 동작을 수행합니다.
⚠️
sauceclipMoveLinkButton 만 iframe 경로를 쓰지 않습니다. 부모 창으로 가지 않고 플레이어가 직접 링크를 엽니다.
가이드
Updated about 4 hours ago
Did this page help you?