오프라인 재생 정보 보고 (NotifyOfflinePlaybackLog)

재생 관련 보고가 오프라인 상태로 인해 전송되지 않았을 경우, 온라인 연결 시 로컬에 저장된 데이터를 전송합니다.

재생 시작재생 종료적용
오프라인오프라인O
오프라인온라인O
온라인오프라인O
온라인온라인X

호출

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

{
    "type": "NotifyOfflinePlaybackLog",
    "appId": string,
    "userId": string,
    "userData": object,
    "mediaUrl": string,
    "items": [
        {
            "sessionId": string,
            "startedAt": number,
            "stoppedAt": number,
            "position": number,
            "duration": number,
            "progress": { 
                "playTime": number,
                "watchTime": number,
            },
            "finishReason": "Ended" | "Error" | "UserExited"
        }
    ]
}
이름타입설명
appIdstringApp 아이디
userIdstring사용자 아이디
userDataobjectlaunchAgent 호출 시 입력한 정보
(사용자 및 컨텐츠 식별 등의 용도)
mediaUrlstring미디어 URL
items[Log]로그

Log

이름타입설명
sessionIdstring세션 아이디
startedAtnumber시작 시간
stoppedAtnumber종료 시간
positionnumber현재 재생 위치 (단위: 밀리초)
durationnumber전체 재생 길이 (단위: 밀리초)
progressobject현재 세션의 진행 상태

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

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

반환

{
    "result": "Ok"
}

result

설명
Ok성공