Android instellen set-up-android
Leer hoe u de verzameling streamingmedia voor Android-apparaten instelt.
Vereisten
-
verkrijg geldige configuratieparameters voor de Media SDK
Deze parameters kunt u verkrijgen van een Adobe-medewerker nadat u uw analyseaccount hebt ingesteld. -
voert ADBMobile voor Android in uw toepassing uit
Voor meer informatie over de documentatie van Adobe Mobile SDK, zie Android SDK 4.x voor de Oplossingen van het Experience Cloud. -
verstrek de volgende mogelijkheden in uw media speler:
- API om aan spelergebeurtenissen in te tekenen - de Media SDK vereist dat u een reeks eenvoudige APIs roept wanneer de gebeurtenissen in uw speler voorkomen.
- API die spelerinformatie verstrekt - Deze informatie omvat details zoals de media naam en de positie van het spelhoofd.
SDK-implementatie
-
Voeg uw gedownloade Media SDK toe aan uw project.
-
Vouw het ZIP-bestand van Android uit (bijvoorbeeld
MediaSDK-android-v2.*.zip
). -
Controleer of het
MediaSDK.jar
-bestand in de maplibs/
staat. -
Voeg de bibliotheek aan uw project toe.
IntelliJ IDEA:
-
Klik met de rechtermuisknop op uw project in het deelvenster Project navigation.
-
Selecteer Open Module Settings .
-
Selecteer onder Project Settings de optie Libraries .
-
Klik op + om een nieuwe bibliotheek toe te voegen.
-
Selecteer Java en ga naar het
MediaSDK.jar
-bestand. -
Selecteer de modules waarin u de mobiele bibliotheek wilt gebruiken.
-
Klik op Apply en vervolgens op OK om het venster met module-instellingen te sluiten.
Verduistering:
-
In winde van de Verduistering, klik op de projectnaam met de rechtermuisknop aan.
-
Klik op Build Path > Add External Archives .
-
Selecteer
MediaSDK.jar
. -
Klik op Open.
-
Klik nogmaals met de rechtermuisknop op het project en klik op Build Path > Configure Build Path .
-
Klik op de tabbladen Order en Export.
-
Zorg ervoor dat het
MediaSDK.jar
-bestand is geselecteerd.
-
-
-
Importeer de bibliotheek.
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;
-
Maak de
MediaHeartbeatConfig
-instantie.Hier volgt een voorbeeld van initialisatie van
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>;
-
Implementeer de interface
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>; }
-
Maak de
MediaHeartbeat
-instantie.Gebruik de instantie
MediaHeartbeatConfig
en de instantieMediaHertbeatDelegate
om de instantieMediaHeartbeat
te maken.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT Zorg ervoor dat uw MediaHeartbeat
instantie toegankelijk is en wordt niet gedealloceerd tot het eind van de zitting. Deze instantie wordt gebruikt voor alle volgende gebeurtenissen tracking.
Toevoegend app toestemmingen
Uw toepassing die Media SDK gebruikt, vereist de volgende machtigingen om gegevens te verzenden bij het bijhouden van aanroepen:
INTERNET
ACCESS_NETWORK_STATE
Voeg de volgende regels toe aan uw AndroidManifest.xml
-bestand in de projectmap van de toepassing om deze machtigingen toe te voegen:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
migrerend van versie 1.x aan 2.x in Android
In versies 2.x worden alle methoden van het type public geconsolideerd in de klasse com.adobe.primetime.va.simple.MediaHeartbeat
, zodat ontwikkelaars deze eenvoudiger kunnen gebruiken. Bovendien worden alle configuraties nu geconsolideerd in de klasse com.adobe.primetime.va.simple.MediaHeartbeatConfig
.
Raadpleeg de documentatie bij Legacy Implementation voor informatie over het migreren van 1.x naar 2.x.