Android 설정

중요

2021년 8월 31일에 버전 4 Mobile SDK에 대한 지원이 종료됨에 따라 Adobe는 iOS 및 Android용 Media Analytics SDK에 대한 지원도 종료할 예정입니다. 자세한 내용은 Media Analytics SDK 지원 종료 FAQ를 참조하십시오.

전제 조건

  • 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를 참조하십시오.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now