Configurar Android set-up-android

Saiba como configurar o Streaming Media Analytics para dispositivos Android.

IMPORTANT
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 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.

    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;
    
  3. 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>;
    
  4. 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>;
    }
    
  5. Crie a instância MediaHeartbeat.

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

    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.

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb