Android 설정

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

중요

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:

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

이 페이지에서는