Dokumentation Analytics Användarhandbok om Media Analytics

Konfigurera Android set-up-android

Last update: Mon Nov 14 2022 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:
Media Analytics

Skapat för:

User
Admin
Developer

Lär dig hur du konfigurerar Streaming Media Analytics för Android-enheter.

IMPORTANT

När stödet för version 4 Mobile SDK upphör den 31 augusti 2021 upphör även stödet för Media Analytics SDK för iOS och Android i Adobe. Mer information finns i Vanliga frågor om supporten för Media Analytics SDK.

Förutsättningar

Hämta giltiga konfigurationsparametrar för Media SDK
Dessa parametrar kan hämtas från en Adobe-representant när du har konfigurerat ditt analyskonto.
Implementera ADBMobil för Android i ditt program
Mer information om Adobe Mobile SDK-dokumentationen finns i Android SDK 4.x för Experience Cloud Solutions.
Tillhandahåll följande funktioner i din mediespelare:
- Ett API för att prenumerera på spelarhändelser - Media SDK kräver att du anropar en uppsättning enkla API:er när händelser inträffar i spelaren.
- Ett API som tillhandahåller spelarinformation - Den här informationen innehåller information som medienamnet och spelhuvudets position.

SDK-implementering

Lägg till din hämtade Media SDK i ditt projekt.
1. Expandera zip-filen för Android (t.ex. MediaSDK-android-v2.*.zip).
2. Verifiera att MediaSDK.jar filen finns i libs/ katalog.
3. Lägg till biblioteket i ditt projekt.
  
  IntelliJ IDEA:
  1. Högerklicka på projektet på panelen Project navigation.
  2. Välj Open Module Settings.
  3. Under Project Settings väljer du Libraries.
  4. Klicka + för att lägga till ett nytt bibliotek.
  5. Välj Java och navigera till MediaSDK.jar -fil.
  6. Välj de moduler där du vill använda det mobila biblioteket.
  7. Klicka på Apply och sedan på OK för att stänga fönstret Modulinställningar.
  Eclipse:
  1. Högerklicka på projektnamnet i Eclipse IDE.
  2. Klicka på Build Path > Add External Archives .
  3. Välj MediaSDK.jar.
  4. Klicka på Open.
  5. Högerklicka på projektet igen och klicka på Build Path > Configure Build Path .
  6. Klicka på flikarna Order och Export.
  7. Se till att MediaSDK.jar filen är markerad.

Importera biblioteket.

code language-java

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;`

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;

Skapa MediaHeartbeatConfig -instans.

Här följer ett exempel på MediaHeartbeatConfig-initiering:

code language-java

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>;`

// 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>;

Implementera MediaHeartbeatDelegate gränssnitt.

code language-java
`public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}`

code language-java

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>; }`

// 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>;
}

Skapa MediaHeartbeat -instans.

Använd MediaHeartbeatConfig -instans och MediaHertbeatDelegate instans för att skapa MediaHeartbeat -instans.

code language-java
`// Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);`

note important
IMPORTANT
Se till att `MediaHeartbeat` -instansen är tillgänglig och avallokeras inte förrän sessionen är slut. Den här instansen används för alla följande spårningshändelser.

Lägga till programbehörigheter

Ditt program som använder Media SDK kräver följande behörigheter för att skicka data i spårningsanrop:

INTERNET
ACCESS_NETWORK_STATE

Lägg till följande rader i AndroidManifest.xml i programprojektkatalogen:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Migrera från version 1.x till 2.x i Android

I version 2.x konsolideras alla publika metoder i com.adobe.primetime.va.simple.MediaHeartbeat för utvecklare. Dessutom konsolideras nu alla konfigurationer i com.adobe.primetime.va.simple.MediaHeartbeatConfig klassen.

Mer information om hur du migrerar från 1.x till 2.x finns i dokumentationen för den äldre implementeringen.

recommendation-more-help

c8eee520-cef5-4f8c-a38a-d4952cfae4eb