Android 설정 set-up-android
Android 디바이스용 스트리밍 미디어 컬렉션 추가 기능을 설정하는 방법에 대해 알아봅니다.
사전 요구 사항
-
Media SDK에 대한 올바른 구성 매개 변수 가져오기
이러한 매개 변수는 분석 계정을 설정한 후 Adobe 담당자에게서 얻을 수 있습니다. -
애플리케이션에 Android용 ADBMobile 구현 Adobe Mobile SDK 설명서에 대한 자세한 내용은 Experience Cloud 솔루션용 Android SDK 4.x를 참조하십시오.
-
미디어 플레이어에서 다음 기능 제공:
- 플레이어 이벤트에 가입할 API - Media SDK를 사용하려면 이벤트가 플레이어에서 발생할 때 단순 API 세트를 호출해야 합니다.
- 플레이어 정보를 제공하는 API - 이 정보에는 미디어 이름 및 재생 헤드 위치와 같은 세부 정보가 포함됩니다.
SDK 구현
-
다운로드한 Media SDK를 프로젝트에 추가합니다.
-
Android zip 파일(예:
MediaSDK-android-v2.*.zip
)을 확장합니다. -
다음
MediaSDK.jar
파일이libs/
디렉토리에 있는지 확인합니다. -
라이브러리를 프로젝트에 추가합니다.
IntelliJ IDEA:
-
프로젝트 탐색 패널에서 프로젝트를 마우스 오른쪽 버튼으로 클릭합니다.
-
모듈 설정 열기 를 선택합니다.
-
프로젝트 설정 에서 라이브러리 를 선택합니다.
-
새 라이브러리를 + 를 클릭하여 추가합니다.
-
Java 를 선택하고
MediaSDK.jar
파일로 이동합니다. -
모바일 라이브러리를 사용할 모듈을 선택합니다.
-
적용 을 클릭한 다음 확인 을 클릭하여 모듈 설정 창을 닫습니다.
Eclipse:
-
Eclipse IDE에서 프로젝트 이름을 마우스 오른쪽 버튼으로 클릭합니다.
-
빌드 경로 > 외부 아카이브 추가 를 클릭합니다.
-
MediaSDK.jar
을 선택합니다. -
열기 를 클릭합니다.
-
프로젝트를 다시 마우스 오른쪽 버튼으로 클릭한 다음 빌드 경로 > 빌드 경로 구성 을 클릭합니다.
-
주문 및 내보내기 탭을 클릭합니다.
-
MediaSDK.jar
파일을 선택했는지 확인합니다.
-
-
-
라이브러리를 가져옵니다.
code language-java 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
초기화입니다.code language-java // 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
인터페이스를 구현합니다.code language-java public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
code language-java // 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
인스턴스를 만듭니다.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT 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로의 마이그레이션에 대한 자세한 내용은 이전 구현 설명서를 참조하십시오.