Show Menu
TOPICS×

Android 설정

전제 조건

  • Media SDK에 대한 올바른 구성 매개 변수 가져오기
    이러한 매개 변수는 분석 계정을 설정한 후 Adobe 담당자에게서 얻을 수 있습니다.
  • 애플리케이션에 Android용 ADBMobile 구현
    Adobe Mobile SDK 설명서에 대한 자세한 내용은 Experience Cloud 솔루션용 Android SDK 4.x 를 참조하십시오.
  • 미디어 플레이어에 다음 기능을 제공합니다.
    • 플레이어 이벤트에 가입할 API
      - Media SDK를 사용하려면 이벤트가 플레이어에서 발생할 때 단순 API 세트를 호출해야 합니다.
    • 플레이어 정보를 제공하는 API
      - 이 정보에는 미디어 이름 및 플레이헤드 위치와 같은 세부 사항이 포함되어 있습니다.

SDK 구현

  1. 다운로드한 Media SDK를 프로젝트에 추가합니다.
    1. Android zip 파일(예:
      MediaSDK-android-v2.*.zip
      )을 확장합니다.
    2. 다음
      MediaSDK.jar
      파일이
      libs/
      디렉토리에 있는지 확인합니다.
    3. 라이브러리를 프로젝트에 추가합니다.
      IntelliJ IDEA:
      1. 프로젝트 탐색
        패널에서 프로젝트를 마우스 오른쪽 버튼으로 클릭합니다.
      2. 모듈 설정 열기를 선택합니다
        .
      3. 프로젝트 설정
        ​에서
        라이브러리
        ​를 선택합니다.
      4. 새 라이브러리를
        +
        ​를 클릭하여 추가합니다.
      5. Java
        ​를 선택하고
        MediaSDK.jar
        파일로 이동합니다.
      6. 모바일 라이브러리를 사용할 모듈을 선택합니다.
      7. 적용
        ​을 클릭한 다음
        확인
        ​을 클릭하여 모듈 설정 창을 닫습니다.
        Eclipse:
      8. Eclipse IDE에서 프로젝트 이름을 마우스 오른쪽 버튼으로 클릭합니다.
      9. 빌드 경로
        >
        외부 아카이브 추가
        ​를 클릭합니다 .
      10. 선택
        MediaSDK.jar
        .
      11. 열기를 클릭합니다
        .
      12. 프로젝트를 다시 마우스 오른쪽 단추로 클릭한 다음
        빌드 경로
        >
        빌드 경로 구성
        ​을 클릭합니다.
      13. 주문
        내보내기
        탭을 클릭합니다.
      14. MediaSDK.jar
        파일을 선택했는지 확인합니다.
  2. 라이브러리를 가져옵니다.
    import com.adobe.primetime.va.simple.MediaHeartbeat; import com.adobe.primetime.va.simple.MediaHeartbeat.MediaHeartbeatDelegate; import com.adobe.primetime.va.simple.MediaHeartbeatConfig; import com.adobe.primetime.va.simple.MediaObject;
  3. MediaHeartbeatConfig
    인스턴스를 생성합니다.
    다음은 샘플
    MediaHeartbeatConfig
    초기화입니다.
    // Media Heartbeat Initialization config.trackingServer = _<SAMPLE_HEARTBEAT_TRACKING_SERVER>_; config.channel = <SAMPLE_HEARTBEAT_CHANNEL>; config.appVersion = <SAMPLE_HEARTBEAT_SDK_VERSION>; config.ovp = <SAMPLE_HEARTBEAT_OVP_NAME>; config.playerName = <SAMPLE_PLAYER_NAME>; config.ssl = <true/false>; config.debugLogging = <true/false>;
  4. MediaHeartbeatDelegate
    인터페이스를 구현합니다.
    public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
    // Replace <bitrate>, <startupTime>, <fps>, and // <droppeFrames> with the current playback QoS values. @Override public MediaObject getQoSObject() { return MediaHeartbeat.createQoSObject(<bitrate>, <startupTime>, <fps>, <droppedFrames>); } //Replace <currentPlaybackTime> with the video player current playback time @Override public Double getCurrentPlaybackTime() { return <currentPlaybackTime>; }
  5. MediaHeartbeat
    인스턴스를 생성합니다.
    MediaHeartbeatConfig
    인스턴스 및
    MediaHertbeatDelegate
    인스턴스를 사용하여
    MediaHeartbeat
    인스턴스를 만듭니다.
    // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
    MediaHeartbeat
    인스턴스가 액세스할 수 있는지 그리고
    세션이 끝날 때까지 이 인스턴스에 대한 할당이 취소되지 않는지
    확인하십시오. 이 인스턴스는 다음의 모든 추적 이벤트에 사용됩니다.
앱 권한 추가
Media SDK를 사용하는 앱에서는 추적 호출에서 데이터를 전송하기 위해 다음 권한이 필요합니다.
  • INTERNET
  • ACCESS_NETWORK_STATE
이러한 권한을 추가하려면 애플리케이션 프로젝트 디렉토리의
AndroidManifest.xml
파일에 다음 줄을 추가합니다.
  • <uses-permission android:name="android.permission.INTERNET" />
  • <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Android에서 버전 1.x에서 2.x로 마이그레이션
버전 2.x에서는 모든 공개 메서드가 개발자가 쉽게 만들 수 있도록
com.adobe.primetime.va.simple.MediaHeartbeat
클래스에 통합되어 있습니다. 또한 모든 구성이 이제
com.adobe.primetime.va.simple.MediaHeartbeatConfig
클래스에 통합되어 있습니다.
1.x에서 2.x로 마이그레이션에 대한 자세한 내용은 mig-1x-2x-overview.md 를 참조하십시오.