Dokumentation Analytics Direktuppspelning av Media Collection Guide

Konfigurera Android set-up-android

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Ämnen:

Skapat för:

Användare
Administratör
Utvecklare

Lär dig hur du konfigurerar tillägget Streaming Media Collection 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. 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 for 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. Kontrollera att filen MediaSDK.jar finns i katalogen libs/.
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. Välj Libraries under Project Settings.
  4. Klicka på + om du vill lägga till ett nytt bibliotek.
  5. Välj Java och navigera till filen MediaSDK.jar.
  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. Kontrollera att filen MediaSDK.jar ä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 instansen MediaHeartbeatConfig.

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 gränssnittet MediaHeartbeatDelegate.

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 instansen MediaHeartbeat.

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

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

note important
IMPORTANT
Kontrollera att din `MediaHeartbeat`-instans är tillgänglig och att inte frigörs förrän i slutet av sessionen. Den här instansen kommer att användas för alla följande spårningshändelser.

Lägger 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

Om du vill lägga till de här behörigheterna lägger du till följande rader i filen AndroidManifest.xml i programmets projektkatalog:

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

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

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

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