서비스 소개
사용 매뉴얼
iframe 재생 데이터 메시지
iframe 메시지로 플레이어가 전송하는 재생 데이터를 받아 실시간 지표(재생률·완료율·시청 구간 등)를 계산하고 활용합니다.
데모 패널에서는 사용자/세션, 채널/콘텐츠, 현재 시각·진행률, 누적 재생시간, 시청 구간 합계와 목록, 20/40/60/80/100% 재생률을 실시간으로 제공합니다. 세션 정보(uuid)는 재생을 시작할 때마다 새로 생성되는 값이며, 동일 브라우저/탭에서도 재시작 시 값이 달라질 수 있습니다. 세션 단위의 통계/분석 지표에 활용하세요.
실시간 재생 데이터
세션
-
채널 ID
-
컨텐츠 ID
-
재생 시각
0.0s / 0.0s
진행률
0.0%
누적 재생시간(세션)
-
시청 구간 합계
0.0s (0.0%)
재생률:20%40%60%80%100%
최근 메시지 Payload
수신 대기 중
시청 구간
구간 데이터가 없습니다.
부모 페이지 예시 코드
부모 페이지에서는 window의 "message" 이벤트를 구독하고, 출처(origin)를 "https://play.mbus.tv"로 검증한 뒤 payload(type: "jw")를 사용하세요.
// 메시지 수신 (출처 검증 필수)
window.addEventListener('message', (e) => {
if (e.origin !== 'https://play.mbus.tv') return;
let data = e.data;
if (typeof data === 'string') { try { data = JSON.parse(data); } catch { return; } }
// Playdata 예시
// {
// type: 'jw', uuid, channelId, objectId,
// mediaLength, mediaPos, mediaPlayTime,
// play20, play40, play60, play80, play100,
// label, watchedSections: [{ start, end }]
// }
if (data?.type !== 'jw') return;
const rate = data.mediaLength > 0 ? (data.mediaPos / data.mediaLength) * 100 : 0;
// TODO: rate, watchedSections를 활용하여 재생률/완료율/구간 리포트를 계산해 사용하세요.
});
