Show Menu
TÓPICOS×

Configurar Android

Com o fim do suporte para SDKs móveis da versão 4 em 31 de agosto de 2021, a Adobe também encerrará o suporte para o SDK do Media Analytics para iOS e Android. Para obter mais informações, consulte Perguntas frequentes sobre o fim do suporte do SDK do Media Analytics .

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 do Media ao 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:
      8. No Eclipse IDE, clique com o botão direito do mouse no nome do projeto.
      9. Clique em Criar caminho > Adicionar arquivos externos .
      10. Selecionar MediaSDK.jar .
      11. Clique em Abrir .
      12. Clique com o botão direito novamente no projeto e clique em Criar caminho > Configurar construção de caminho .
      13. Clique nas guias Ordem e Exportar .
      14. 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);
    
    
    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 detalhadas sobre a migração de 1.x para 2.x, consulte mig-1x-2x-overview.md.