Configurar Android set-up-android
Saiba como configurar o Complemento de coleção de mídia de streaming para dispositivos Android.
Pré-requisitos
-
Obter parâmetros de configuração válidos para o SDK do Media Esses parâmetros podem ser obtidos de um representante da Adobe após a configuração da sua conta do Analytics.
-
Implementar o ADBMobile para Android em seu aplicativo
Para obter mais informações sobre a documentação do SDK do Adobe Mobile, consulte SDK 4.x do Android para Soluções da Experience Cloud. -
Forneça os seguintes recursos no player de mídia:
- Uma API para assinar eventos do player - O SDK de mídia exige que você chame um conjunto de APIs simples quando eventos ocorrem no player.
- Uma API que fornece informações sobre o player - Essas informações incluem detalhes como o nome da mídia e a posição do indicador de reprodução.
Implementação do SDK
-
Adicione a biblioteca baixada do SDK de mídia no projeto.
-
Expanda o arquivo zip do Android (por exemplo,
MediaSDK-android-v2.*.zip
). -
Verifique se o arquivo
MediaSDK.jar
existe no diretóriolibs/
. -
Adicione a biblioteca ao projeto.
IntelliJ IDEA:
-
Clique com o botão direito do mouse no painel Navegação do projeto.
-
Selecione Abrir configurações do módulo.
-
Em Configurações do projeto, selecione Bibliotecas.
-
Clique em + para adicionar uma nova biblioteca.
-
Selecione Java e navegue até o arquivo
MediaSDK.jar
. -
Selecione os módulos nos quais planeja usar a biblioteca móvel.
-
Clique em Aplicar e em OK para fechar a janela Configurações do módulo.
Eclipse:
-
No Eclipse IDE, clique com o botão direito do mouse no nome do projeto.
-
Clique em Criar caminho > Adicionar arquivos externos .
-
Selecionar
MediaSDK.jar
. -
Clique em Abrir.
-
Clique com o botão direito novamente no projeto e clique em Criar caminho > Configurar construção de caminho .
-
Clique nas guias Ordem e Exportar.
-
Verifique se o arquivo
MediaSDK.jar
foi selecionado.
-
-
-
Importe a biblioteca.
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;
-
Crie a instância
MediaHeartbeatConfig
.Aqui está uma amostra de inicialização
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>;
-
Implemente a 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>; }
-
Crie a instância
MediaHeartbeat
.Use a instância
MediaHeartbeatConfig
eMediaHertbeatDelegate
para criar a instânciaMediaHeartbeat
.code language-java // Replace <MediaHertbeatDelegate> with your delegate instance MediaHeartbeat _heartbeat = new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
note important IMPORTANT Certifique-se de que a instância MediaHeartbeat
possa ser acessada e não seja desalocada até o final da sessão. Essa instância será usada para todos os eventos de rastreamento a seguir.
Adicionar permissões de aplicativo
O aplicativo que usa o SDK de mídia requer as seguintes permissões para enviar dados em chamadas de rastreamento:
INTERNET
ACCESS_NETWORK_STATE
Para adicionar essas permissões, adicione as seguintes linhas no seu arquivo AndroidManifest.xml
no diretório do projeto do aplicativo:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
Migração da versão 1.x para 2.x do Android
Nas versões 2.x, todos os métodos públicos foram consolidados na classe com.adobe.primetime.va.simple.MediaHeartbeat
para facilitar o trabalho dos desenvolvedores. Além disso, todas as configurações foram consolidadas na classe com.adobe.primetime.va.simple.MediaHeartbeatConfig
Para obter informações sobre a migração da versão 1.x para a 2.x, consulte a documentação de Implementação herdada.