Android 설정

Android 디바이스를 위한 스트리밍 미디어용 Analytics을 설정하는 방법에 대해 알아봅니다.

사전 요구 사항

• 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:

      1. Eclipse IDE에서 프로젝트 이름을 마우스 오른쪽 버튼으로 클릭합니다.

      2. 빌드 경로 > 외부 아카이브 추가​를 클릭합니다.

      3. MediaSDK.jar을 선택합니다.

      4. 열기​를 클릭합니다.

      5. 프로젝트를 다시 마우스 오른쪽 버튼으로 클릭한 다음 빌드 경로 > 빌드 경로 구성​을 클릭합니다.

      6. 주문 및 내보내기 탭을 클릭합니다.

      7. 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로의 마이그레이션에 대한 자세한 내용은 이전 구현 설명서를 참조하십시오.