Configurar iOS set-up-ios

Saiba como configurar o Streaming Media Analytics para dispositivos iOS.

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

    note important
    IMPORTANT
    A partir do iOS 9, a Apple introduziu um recurso chamado App Transport Security (ATS). Esse recurso tem como objetivo melhorar a segurança da rede, garantindo que seus aplicativos usem somente protocolos e cifras padrão do setor. Esse recurso é ativado por padrão, mas você tem opções de configuração que fornecem opções para trabalhar com ATS. Para obter detalhes sobre ATS, consulte App Transport Security.
  • 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

IMPORTANT
A partir da versão 2.3.0, o SDK é distribuído via XCFrameworks.
A versão 2.3.0 do SDK exige o Xcode 12.0 ou mais recente e, se aplicável, o Cocoapods 1.10.0 ou mais recente.
  • Sempre que um arquivo binário de biblioteca for mencionado, sua substituição XCFramework deverá ser usada em vez disso:

    • MediaSDK.a > MediaSDK.xcframework
    • MediaSDK_TV.a > MediaSDKTV.xcframework
  • Se você adicionar manualmente o Adobe XCFrameworks ao seu projeto, verifique se ele não está incorporado.

  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 pretendido para um aplicativo da Apple TV (tvOS).

    2. Adicione 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.

      Escolher opções

      1. Clique em Concluir.

      2. No Navegador do projeto, selecione o seu aplicativo e os seus destinos.

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

        Públicos da Apple TV (tvOS):

        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      4. Verifique se o aplicativo foi criado sem erros.

  2. Importe a biblioteca.

    code language-none
    #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:

    code language-none
    // 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.

    code language-none
    @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.

    code language-none
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance
    _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate:
      <ADBMediaHeartBeatDelegate> config:config];
    
    note important
    IMPORTANT
    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 migrate-to-two-x

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 informações sobre a migração da versão 1.x para a 2.x, consulte a documentação da Implementação herdada.)

Configuração de um aplicativo nativo para tvOS

Com o lançamento da nova Apple TV, agora é possível criar aplicativos para execução no ambiente tvOS nativo. Você pode criar um aplicativo puramente nativo, usando qualquer uma das várias estruturas disponíveis no iOS, ou criar seu 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 tem um público-alvo que é um aplicativo da Apple TV direcionado ao 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
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb