Show Menu
TOPICS×

Configurar iOS

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 iOS no aplicativo
    Para obter mais informações sobre a documentação do SDK do Adobe Mobile, consulte SDK do iOS 4.x para Soluções da Experience Cloud.
    A partir do iOS 9, a Apple introduziu um recurso chamado App Transport Security (ATS). Este recurso visa melhorar a segurança da rede, garantindo que seus aplicativos usem somente protocolos padrão do setor e cifras. Esse recurso é ativado por padrão, mas você tem opções de configuração que permitem trabalhar com ATS. Para obter detalhes sobre ATS, consulte App Transport Security.
  • 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. Verifique se os componentes de software a seguir existem no diretório
      libs
      :
      • ADBMediaHeartbeat.h
        : o arquivo do cabeçalho Objective-C usado para APIs de rastreamento de heartbeat no iOS.
      • ADBMediaHeartbeatConfig.h
        : o arquivo do cabeçalho Objective-C usado na configuração do SDK.
      • MediaSDK.a
        : um binário multiarquitetura habilitado para código de bits que contém as compilações de biblioteca para dispositivos iOS (armv7, armv7s, arm64) e simuladores (i386 e x86_64).
        Esse binário deve ser vinculado quando o destino for um aplicativo iOS.
      • MediaSDK_TV.a
        : um binário multiarquitetura habilitado para código de bits, que apresente as compilações de biblioteca para novos dispositivos Apple TV (arm64) e simuladores (x86_64).
        Esse binário deve ser vinculado quando o destino for um aplicativo da Apple TV (tvOS).
    2. Adicionar a biblioteca ao projeto:
      1. Abra o Xcode IDE e o seu aplicativo.
      2. No
        Navegador do projeto
        , arraste o diretório
        libs
        e solte-o no seu projeto.
      3. Certifique-se de que as caixas de seleção
        Copiar itens se necessário
        e
        Criar grupos
        estejam marcadas e que nenhuma das caixas de seleção em
        Adicionar ao destino
        estejam selecionadas.
      4. Clique em
        Concluir
        .
      5. No
        Navegador do projeto
        , selecione o seu aplicativo e os seus destinos.
      6. Vincule as estruturas e bibliotecas necessárias na seção
        Estruturas vinculadas
        e
        Bibliotecas
        na guia
        Geral
        .
        Destinos de aplicativos iOS:
        • AdobeMobileLibrary.a
        • MediaSDK.a
        • libsqlite3.0.tbd
          Destinos da Apple TV (tvOS)
          :
        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      7. Verifique se o aplicativo foi criado sem erros.
  2. Importe a biblioteca.
    #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
  3. Crie uma instância
    ADBMediaHeartbeatConfig
    .
    Essa seção ajuda você a entender os parâmetros de configuração do
    MediaHeartbeat
    e definir corretamente os valores de configuração na sua instância
    MediaHeartbeat
    , de modo a permitir um rastreamento preciso.
    Aqui está uma amostra de inicialização
    ADBMediaHeartbeatConfig
    :
    // Media Heartbeat Initialization ADBMediaHeartbeatConfig *config = [[ADBMediaHeartbeatConfig alloc] init]; 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 = <YES/NO>; config.debugLogging = <YES/NO>;
  4. Implemente o protocolo
    ADBMediaHeartbeatDelegate
    .
    @interface VideoAnalyticsProvider : NSObject <ADBMediaHeartbeatDelegate> @end @implementation VideoAnalyticsProvider // Replace <bitrate>, <startuptime>, <fps> and <droppeFrames> // with the current playback QoS values. - (ADBMediaObject *)getQoSObject { return [ADBMediaHeartbeat createQoSObjectWithBitrate:<bitrate> startupTime:<startuptime> fps:<fps> droppedFrames:<droppedFrames>]; } // Return the current video player playhead position. // Replace <currentPlaybackTime> with the video player current playback time - (NSTimeInterval)getCurrentPlaybackTime { return <currentPlaybackTime>; } @end
  5. Use
    ADBMediaHeartBeatConfig
    e
    ADBMediaHeartBeatDelegate
    para criar a instância
    ADBMediaHeartbeat
    .
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
    Certifique-se de que a instância
    ADBMediaHeartbeat
    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.

Migração da versão 1.x para 2.x do iOS

Na versão 2.x, todos os métodos públicos foram consolidados na classe
ADBMediaHeartbeat
para facilitar o trabalho dos desenvolvedores. Todas as configurações foram consolidadas na classe
ADBMediaHeartbeatConfig
.
Para obter mais informações sobre a migração de 1.x para 2.x, consulte Migração do VHL 1.x para 2.x.

Configuração de um aplicativo nativo para tvOS

Com o lançamento da nova Apple TV, é possível criar aplicativos compatíveis com um ambiente tvOS nativo. Você pode criar um aplicativo completamente nativo com as várias estruturas disponíveis no iOS, ou criar seu próprio aplicativo usando modelos XML e JavaScript. A partir da versão 2.0 do SDK do Media, o suporte para tvOS está disponível. Para mais informações sobre tvOS, consulte o Site do desenvolvedor do tvOS.
Execute as seguintes etapas no projeto Xcode. Este guia foi escrito supondo que seu projeto tenha um direcionamento o aplicativo Apple TV com segmentação tvOS:
  1. Arraste o arquivo de biblioteca
    VideoHeartbeat_TV.a
    para a pasta
    lib
    do seu projeto.
  2. Na guia
    Criar fases
    do destino do seu aplicativo tvOS, expanda a seção
    Link binário com bibliotecas
    e adicione as seguintes bibliotecas:
    • MediaSDK_TV.a
    • AdobeMobileLibrary_TV.a
    • libsqlite3.0.tbd
    • SystemConfiguration.framework