Show Menu
TOPICS×

Configurar 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 reprodutor de mídia:
    • Uma API para assinar os eventos do reprodutor
      - O SDK do Media exige a chamada de um conjunto de APIs simples quando ocorrerem eventos no reprodutor.
    • Uma API que fornece informações sobre o reprodutor
      - 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
        Caminho de criação
        >
        Adicionar arquivos externos
        .
      10. Selecionar
        MediaSDK.jar
        .
      11. Clique em
        Abrir
        .
      12. Clique novamente com o botão direito no projeto e clique em
        Caminho de compilação
        >
        Configurar caminho da compilação
        .
      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.
Inclusão de permissões de aplicativo
O aplicativo que usa o SDK do Media exige as seguintes permissões para enviar dados nas 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.