이 설명서는 SDK의 버전 2.x에 있는 추적 기능에 대해 설명합니다.
SDK의 1.x 버전을 구현하는 경우 SDK 다운로드에서 Android용 1.x 개발자 안내서를 다운로드할 수 있습니다.
초기 추적 설정
사용자가 재생 의도를 트리거하는 시기(사용자가 재생을 클릭하거나 자동 재생이 켜짐)를 식별하고 MediaObject
인스턴스를 만듭니다.
변수 이름 | 설명 | 필수 여부 |
---|---|---|
name |
미디어 이름 | 예 |
mediaId |
미디어 고유 식별자 | 예 |
length |
미디어 길이 | 예 |
streamType |
스트림 유형(아래 StreamType 상수 참조) | 예 |
mediaType |
미디어 유형(아래 MediaType 상수 참조) | 예 |
StreamType
상수:
상수 이름 | 설명 |
---|---|
VOD |
Video on Demand에 대한 스트림 유형입니다. |
LIVE |
라이브 컨텐츠에 대한 스트림 유형입니다. |
LINEAR |
선형 컨텐츠에 대한 스트림 유형입니다. |
AOD |
Audio On Demand에 대한 스트림 유형입니다. |
AUDIOBOOK |
오디오북에 대한 스트림 유형입니다. |
PODCAST |
팟캐스트에 대한 스트림 유형입니다. |
MediaType
상수:
상수 이름 | 설명 |
---|---|
Audio |
오디오 스트림에 대한 미디어 유형입니다. |
Video |
비디오 스트림에 대한 미디어 유형입니다. |
MediaHeartbeat.createMediaObject(<MEDIA_NAME>,
<MEDIA_ID>, <MEDIA_LENGTH>, <STREAM_TYPE>, <MEDIA_TYPE>);
메타데이터 첨부
원할 경우 컨텍스트 데이터 변수를 통해 표준 및/또는 사용자 지정 메타데이터 개체를 추적 세션에 첨부합니다.
표준 메타데이터
표준 메타데이터 개체를 미디어 개체에 첨부하는 것은 선택 사항입니다.
사용자 지정 메타데이터
사용자 지정 변수에 대한 사전을 만들고, 이 미디어의 데이터로 채웁니다. 예:
HashMap<String, String> mediaMetadata =
new HashMap<String, String>();
mediaMetadata.put("isUserLoggedIn", "false");
mediaMetadata.put("tvStation", "Sample TV Station");
mediaMetadata.put("programmer", "Sample programmer");
재생을 시작하려는 의도 추적
미디어 세션 추적을 시작하려면 미디어 하트비트 인스턴스에서 trackSessionStart
를 호출합니다. 예:
public void onVideoLoad(Observable observable, Object data) {
_heartbeat.trackSessionStart(mediaInfo, mediaMetadata);
}
두 번째 값은 2단계에서 작성한 사용자 지정 미디어 메타데이터 개체 이름입니다.
재생 시작이 아니라 trackSessionStart
는 사용자의 재생 의도를 추적합니다. 이 API는 미디어 데이터/메타데이터를 로드하고, QoS 지표(trackSessionStart
과 trackPlay
사이의 기간)를 시작할 시간을 예상하는 데 사용됩니다.
사용자 지정 미디어 메타데이터를 사용하지 않는 경우 trackSessionStart
의 두 번째 인수에 대해 빈 개체를 보내면 됩니다.
실제 재생 시작 추적
미디어 플레이어에서 미디어의 첫 번째 프레임이 화면에서 렌더링되는 미디어 재생 시작에 대한 이벤트를 식별하고, trackPlay
를 호출합니다.
// Video is rendered on the screen) and call trackPlay.
public void onVideoPlay(Observable observable, Object data) {
_heartbeat.trackPlay();
}
재생 완료 추적
미디어 플레이어에서 사용자가 컨텐츠의 끝까지 시청한 미디어 재생 완료에 대한 이벤트를 식별하고, trackComplete
를 호출합니다.
public void onVideoComplete(Observable observable, Object data) {
_heartbeat.trackComplete();
}
세션의 끝 추적
미디어 플레이어에서 사용자가 미디어를 닫거나 미디어가 완료 및 언로드된 미디어 재생 언로드/종료에 대한 이벤트를 식별하고, trackSessionEnd
를 호출합니다.
// Closes the media and/or the media completed and unloaded,
// and call trackSessionEnd().
public void onMainVideoUnload(Observable observable, Object data) {
_heartbeat.trackSessionEnd();
}
미디어 추적 세션의 끝을 trackSessionEnd
는 표시합니다. 세션을 끝까지 성공적으로 시청한 경우, 즉, 사용자가 끝까지 컨텐츠를 시청한 경우 trackComplete
가 trackSessionEnd
전에 호출되는지 확인합니다. 새 미디어 추적 세션에 필요한 track*
를 제외하고, 다른 모든 trackSessionEnd
API 호출은 trackSessionStart
이후 무시됩니다.
가능한 모든 일시 중지 시나리오 추적
미디어 플레이어에서 미디어 일시 중지 이벤트를 식별하고 trackPause
를 호출합니다.
public void onVideoPause(Observable observable, Object data) {
_heartbeat.trackPause();
}
시나리오 일시 중지
비디오 플레이어에서 일시 정지할 시나리오를 식별하고 trackPause
가 제대로 호출되는지 확인하십시오. 다음 시나리오에서는 모두 앱 호출 trackPause()
가 필요합니다.
플레이어에서 미디어 재생 및/또는 일시 중지에서 미디어 재개를 위한 이벤트를 식별하고 trackPlay
를 호출합니다.
// trackPlay()
public void onVideoPlay(Observable observable, Object data) {
_heartbeat.trackPlay();
}
이 이벤트 소스는 4단계에서 사용한 이벤트 소스와 같을 수 있습니다. 미디어 재생이 다시 시작될 때 각 trackPause()
API 호출이 다음 trackPlay()
API 호출과 연결되는지 확인하십시오.
코어 재생 추적에 대한 자세한 내용은 다음을 참조하십시오.