재생 종료 보고 (NotifyPlaybackFinish)

미디어 파일 재생 종료 시 호출됩니다.

호출

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

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

이름타입설명
playTimenumber재생 시간 (배속 X)
watchTimenumber시청 시간 (배속 O)
reasonstring미디어 종료 원인

설명
Ended미디어가 끝까지 재생된 후 종료
Error오류로 인하여 재생 종료
UserExited사용자가 미디어를 제어하여 종료

반환

{
    "result": "Ok"
}

result

설명
Ok성공