Configurar Android

IMPORTANTE

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);
    
    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 detalhadas sobre a migração de 1.x para 2.x, consulte mig-1x-2x-overview.md.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now