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를 참조하십시오.
미디어 플레이어에서 다음 기능 제공:
다운로드한 Media SDK를 프로젝트에 추가합니다.
Android zip 파일(예: MediaSDK-android-v2.*.zip
)을 확장합니다.
다음 MediaSDK.jar
파일이 libs/
디렉토리에 있는지 확인합니다.
라이브러리를 프로젝트에 추가합니다.
IntelliJ IDEA:
프로젝트 탐색 패널에서 프로젝트를 마우스 오른쪽 버튼으로 클릭합니다.
모듈 설정 열기를 선택합니다.
프로젝트 설정에서 라이브러리를 선택합니다.
새 라이브러리를 +를 클릭하여 추가합니다.
Java를 선택하고 MediaSDK.jar
파일로 이동합니다.
모바일 라이브러리를 사용할 모듈을 선택합니다.
적용을 클릭한 다음 확인을 클릭하여 모듈 설정 창을 닫습니다.
Eclipse:
Eclipse IDE에서 프로젝트 이름을 마우스 오른쪽 버튼으로 클릭합니다.
빌드 경로 > 외부 아카이브 추가를 클릭합니다.
MediaSDK.jar
을 선택합니다.
열기를 클릭합니다.
프로젝트를 다시 마우스 오른쪽 버튼으로 클릭한 다음 빌드 경로 > 빌드 경로 구성을 클릭합니다.
주문 및 내보내기 탭을 클릭합니다.
MediaSDK.jar
파일을 선택했는지 확인합니다.
라이브러리를 가져옵니다.
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;
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>;
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>;
}
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로의 마이그레이션에 대한 자세한 내용은 이전 구현 설명서를 참조하십시오.