재생통계 Sample Player

설정

사전에 조회할 값 설명

Statistics 공통

WECANDEO 통계를 사용하기 위해서는 활성화 된 WECANDEO 계정이 있어야 합니다. 먼저 WECANDEO 홈페이지 에서 계정을 생성하고 플랜(Trial, Standard, Enterprise)에 가입하여 계정을 활성화 합니다. 활성화 된 계정에 이용중인 상품이 VideoPack인 경우 VODStatistics를, LivePack인 경우 LiveStatistics 를 사용할 수 있습니다.

WECANDEO API를 사용하여 필요한 값을 조회합니다.

※ WECANDEO API를 사용하기 위해 필요한 API Key는 활성화 된 계정의 CMS에서 확인 가능합니다.[CMS > 계정관리 > 개발자 API]

• VODStatistics
  • videoKey : 동영상 배포 코드 조회 API를 호출하면 videoKey 를 확인할 수 있습니다.
  • DRM 재생을 위한 값
    • gid : [ CMS > 부가서비스 > Wecandeo DRM ] 메뉴에서 gid를 확인할 수 있습니다.
    • secretKey : [ CMS > 부가서비스 > Wecandeo DRM ] 메뉴에서 secretKey를 확인할 수 있습니다.
    • packageId : 배포 패키지 목록 조회 API를 호출하면 packageId를 확인할 수 있습니다.
    • videoId : 동영상 목록 - 배포 패키지별 조회 API를 호출하면 videoId를 확인할 수 있습니다.

※ DRM 기능을 사용하기 위해서는 사용 가능한 플랜(Enterprise)에 가입되어 있어야 하며, 관리자를 통해 해당 기능이 활성화 되어 있어야 합니다.

• LiveStatistics
  • liveKey : [CMS > 라이브 채널 > 채널 리스트 > 채널 선택 > 배포 코드] 메뉴에서 liveKey를 확인할 수 있습니다.

1. 라이브러리 추가

implementation 'com.google.android.exoplayer:exoplayer:2.12.1'
implementation 'com.android.volley:volley:1.1.1'
implementation 'com.google.code.gson:gson:2.8.6'
implementation files('libs/WecandeoPlaySdk.jar')

- libs 폴더에 WecandeoPlaySdk.jar 파일 추가

2. AndroidManifest.xml 에 permissions 추가

<uses-permission android:name="android.permission.INTERNET" />

3. AndroidManifest.xml application 태그 안에 usesCleartextTraffic 설정

<application
android:usesCleartextTraffic="true">

4. LiveStatistics, VodStatistics, StatisticsUrlInfo, RequestSingleton Class 는 수정하지 않고 사용

VOD

Player 구성 방법

• DRM
  • 발급된 videoId, videoKey, gId, scretKey, packageId 를 통해 Player 구성
• Non DRM
  • 발급된 videoKey 로 영상 상세정보 조회를 하여 나온 videoUrl 값을 이용하여 Player 구성
• 공통
  • Player 구성 이후 VodStatistics 객체 생성

    vodStatistics = new VodStatistics(getApplicationContext());
    

  • onPlayerStateChange(boolean playWhenReady, int playbackState) 오버라이드
    • 영상이 처음 로드되고 재생준비가 완료되면 다음 정보 셋팅

vodStatistics.setWecandeoSdk(wecandeoSdk);
vodStatistics.setDuration(TimeUnit.MILLISECONDS.toSeconds(wecandeoSdk.getPlayer().getDuration()));
vodStatistics.fetchVideoDetail("videoKey");

통계 전송 설명

• 재생준비 완료
  • 영상 상세정보 조회
  • 영상 통계정보 조회
  • 플레이어 로드 통계 전송
• 재생 시 통계 전송
• 재생 중
  • 재생 중 통계 전송
    • 재생시간 60초 이하 구간 5초마다 통계 전송
    • 재생시간 60초 이후 구간 10초마다 통계 전송
  • 재생 중 구간 통계 전송(0 ~ 100%)
• 재생 완료 시
  • 정지 통계 전송
• 재생 정지 시
  • 정지 통계 전송
• 일시정지 시 통계 전송
• seekbar 이동 시 통계 전송
  • seekbar 는 최초 재생 이후 실행하도록 설정해야 합니다.

VodStatistics class

• 영상 상세정보 조회
  • 영상 상세정보를 조회하게 되면 VodStatistics Class 에서는 영상 통계정보 조회 이후, 플레이어 로드 통계를 전송하게 됩니다.

public void fetchVideoDetail(String videoKey)

• 재생 / 다시시작 / 일시정지 / 정지 / SEEK
  • state : 재생 상태 ("PLAY", "RETRY", "PAUSE", "STOP", "SEEK")

public void sendStatistics(String state)

Live

Player 구성 방법

• 발급된 liveKey 로 영상 상세정보 조회를 하여 나온 videoUrl 값을 이용하여 Player 구성
• Player 구성 이후 통계 연동을 위한 LiveStatistics 객체 생성

liveStatistics = new LiveStatistics(getApplicationContext(), "liveKey");

통계 전송 설명

• 영상 상태정보 조회
• 재생 시
  • 영상 상세정보 조회
  • 재생 시 통계 전송
• 재생 중 통계 전송
  • 5초마다 통계 전송
• 정지 시 통계 전송

LiveStatistics Class

• 재생
  • 재생 시 영상 상세정보 조회 이후 재생 통계 전송

liveStatistics.sendStatistics("PLAY")

• 정지

liveStatistics.sendStatistics("STOP")