Configurar Android set-up-android
Saiba como configurar serviços de mídia de transmissão 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.jarexiste 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.jarfoi 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
MediaHeartbeatConfigeMediaHertbeatDelegatepara 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 MediaHeartbeatpossa 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:
INTERNETACCESS_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.