send 함수

SHOPLIVE 플레이어에 명령을 전송할 때 사용합니다. 플레이어에서 특정 UI 구성 요소를 숨기거나 노출할 수 있고, 음소거를 하거나 해제할 수도 있습니다.

mplayer("send", action, payload)

action

기능

payload

hideControls

컨트롤 감추기

없음

showControls

컨트롤 보이기

없음

mute

음소거

없음

unmute

음소거 해제

없음

removeBanner

배너닫기

없음

removeCoupon

쿠폰닫기

없음

removeNotice

공지닫기

없음

showToast

메시지 토스트 띄우기

{
"message": "{메시지}",
"duration": {밀리초},
"position": "BOTTOM|CENTER|TOP"
}

아래의 샘플 코드를 참고하시기 바랍니다.

mplayer("send", action, payload);

// 컨트롤 감추기
mplayer("send", "hideControls");
// 컨트롤 보이기
mplayer("send", "showControls");

// 쿠폰 다운로드 후 수동으로 추적 이벤트 전달할 때
var messageCallback = {
  DOWNLOAD_COUPON: function(payload, parent) {
    var type = payload.type;
    var coupon = payload.coupon;
    alert(payload.coupon + " 쿠폰을 다운로드했습니다.");
    if (type === "BANNER") {
      mplayer("send", "removeBanner");
    } else if (type === "COUPON") {
      mplayer("send", "removeCoupon");
    } else if (type === "NOTICE") {
      mplayer("send", "removeNotice");
    }
  },
};

모바일 앱의 이벤트를 위한 설정

모바일 어플리케이션과의 연동을 진행할 경우 앱 이벤트에 대해 아래와 같은 명령을 플레이어에 전송할 수 있습니다.

action

앱 이벤트

payload

샘플

videoInitialized

비디오 초기화 완료

없음

예) mplayer("send", "videoInitialized");

showGoodsUi

키보드가 내려갈 때 채팅 입력창을 없애고 상품 카드 뷰를 노출

없음

예) mplayer("send", "showGoodsUi");

setIsPlayingVideo

영상의 재생 상태가 변할 때 호출. 재생이 시작되면 true, 멈추면 false

{"value": true}

예) mplayer("send", "setIsPlayingVideo", {"value": true});

onVideoTimeUpdated

(리플레이 m3u8) 영상 재생 중인 시간의 상대적인 위치 정보를 주기적으로 호출.

{"value": 35.5}

웹에서 250ms마다 호출중. 앱에서는 1초 혹은 그 이하 주기로 호출해 주세요.
예) mplayer("send", "onVideoTimeUpdated", {"value": 35.5});

onVideoDurationChanged

(리플레이 m3u8) 영상의 길이 정보가 획득될 때 호출

{"value": 3601.3}


Did this page help you?