재생 진행 상태 보고 (NotifyPlaybackProgress)

재생 중 콘솔에 설정된 Interval에 따라 주기적으로 재생 진행 상태를 보고합니다.

호출
Callback URL콜백 URL (콘솔에서 설정)
AuthorizationAPI 접근 권한 목적으로 사용 (콘솔에서 설정)
POST <Callback URL>
content-type: application/json
Authorization: Bearer <Authorization>

{
    "type": "NotifyPlaybackProgress",
    "appId": string,
    "sessionId": string,
    "userId": string,
    "userData": object,
    "mediaUrl": string,
    "position": number,
    "duration": number,
    "progress": { 
        "playTime": number,
        "watchTime": number,
    }
}
이름타입설명
appIdstringApp 아이디
sessionIdstring세션 아이디
userIdstring사용자 아이디
userDataobjectlaunchAgent 호출 시 입력한 정보
(사용자 및 컨텐츠 식별 등의 용도)
mediaUrlstring미디어 URL
positionnumber현재 재생 위치 (단위: 밀리초)
durationnumber전체 재생 길이 (단위: 밀리초)
progressobject현재 세션의 진행 상태

이름타입설명
playTimenumber재생 시간
(비디오 시간 기준, 예: 2배속으로 1초 재생 시 2초)
watchTimenumber시청 시간
(실제 시간 기준, 예: 2배속으로 1초 재생 시 1초)

반환

{
    "result": "Ok" | "PlaybackLimitExceeded"
}

result

값설명
Ok성공
PlaybackLimitExceeded재생 제한 초과 (배수 제한, 재생 횟수 등)