Configurar Android

Saiba como configurar o Streaming Media Analytics 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

1. Adicione a biblioteca baixada do SDK de mídia no projeto.

   1. Expanda o arquivo zip do Android (por exemplo, MediaSDK-android-v2.*.zip).

   2. Verifique se o arquivo MediaSDK.jar existe no diretório libs/.

   3. Adicione a biblioteca ao projeto.

      IntelliJ IDEA:

      1. Clique com o botão direito do mouse no painel Navegação do projeto.

      2. Selecione Abrir configurações do módulo.

      3. Em Configurações do projeto, selecione Bibliotecas.

      4. Clique em + para adicionar uma nova biblioteca.

      5. Selecione Java e navegue até o arquivo MediaSDK.jar.

      6. Selecione os módulos nos quais planeja usar a biblioteca móvel.

      7. Clique em Aplicar e em OK para fechar a janela Configurações do módulo.

      Eclipse:

      1. No Eclipse IDE, clique com o botão direito do mouse no nome do projeto.

      2. Clique em Criar caminho > Adicionar arquivos externos .

      3. Selecionar MediaSDK.jar.

      4. Clique em Abrir.

      5. Clique com o botão direito novamente no projeto e clique em Criar caminho > Configurar construção de caminho .

      6. Clique nas guias Ordem e Exportar.

      7. Verifique se o arquivo MediaSDK.jar foi selecionado.

2. Importe a biblioteca.

   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;
   

3. Crie a instância MediaHeartbeatConfig.

   Aqui está uma amostra de inicialização MediaHeartbeatConfig:

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

4. Implemente a interface MediaHeartbeatDelegate.

   public class VideoAnalyticsProvider implements Observer, MediaHeartbeatDelegate{}
   

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

5. Crie a instância MediaHeartbeat.

   Use a instância MediaHeartbeatConfig e MediaHertbeatDelegate para criar a instância MediaHeartbeat.

   // Replace <MediaHertbeatDelegate> with your delegate instance
   MediaHeartbeat _heartbeat =
     new MediaHeartbeat(<MediaHeartbeatDelegate>, config);
   

   IMPORTANTE

   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.

Recursos do Business.Adobe.com