Show Menu
TOPICS×

Configuración de iOS

Requisitos previos

  • Obtenga parámetros de configuración válidos para Media SDK
    : Estos parámetros se pueden obtener de un representante de Adobe una vez creada la cuenta de Analytics.
  • Implemente ADBMobile para iOS en su aplicación
    : Para obtener más información sobre la documentación del SDK de Adobe Mobile, consulte SDK 4.x de iOS para las soluciones de Experience Cloud.
    A partir de iOS 9, Apple introdujo una función denominada App Transport Security (ATS). Esta función es útil para mejorar la seguridad de la red al garantizar que las aplicaciones solo utilizan protocolos y codificadores estándar del sector. Esta función está activada de forma predeterminada, pero tiene opciones de configuración que le permiten trabajar con ATS de diferentes formas. Para obtener más información sobre ATS, consulte Seguridad del transporte de aplicaciones.
  • Proporcione las siguientes capacidades en su reproductor de contenidos
    :
    • Una API para suscribirse a eventos del reproductor
      : el Media SDK requiere que se invoquen varias API sencillas cuando se producen eventos en el reproductor.
    • Una API que proporcione información del reproductor
      : esta información incluye detalles como el nombre del contenido y la posición del cabezal de reproducción.

Implementación del SDK

  1. Añada el Media SDK descargado al proyecto.
    1. Compruebe que los siguientes componentes de software existan en el directorio
      libs
      :
      • ADBMediaHeartbeat.h
        : archivo del encabezado Objective-C que se utiliza para las API de seguimiento de Heartbeat para iOS.
      • ADBMediaHeartbeatConfig.h
        : archivo del encabezado Objective-C que se utiliza para la configuración del SDK.
      • MediaSDK.a
        : binario multiarquitectura habilitado para código de bits que contiene las compilaciones de biblioteca para los simuladores (i386 y x86_64) y dispositivos iOS (armv7, armv7s, arm64).
        Este binario se debe vincular cuando el destino se dirija a una aplicación iOS.
      • MediaSDK_TV.a
        : binario multiarquitectura habilitado para código de bits que contiene las compilaciones de biblioteca para el simulador (x86_64) y los dispositivos Apple TV (arm64) nuevos.
        Este binario se debe vincular cuando el destino se dirija a una aplicación Apple TV (tvOS).
    2. Añada la biblioteca al proyecto:
      1. Inicie el IDE de Xcode y abra la aplicación.
      2. En
        Navegador de proyectos
        , arrastre el directorio
        libs
        y suéltelo debajo de su proyecto.
      3. Asegúrese de que la casilla de verificación
        Copiar elementos si es necesario
        esté activada, que la opción
        Crear grupos
        esté seleccionada y que ninguna de las casillas de verificación de
        Agregar a destino
        esté activada.
      4. Haga clic en
        Finalizar
        .
      5. En
        Navegador de proyectos
        , seleccione su aplicación y sus destinos.
      6. Vincule los marcos y bibliotecas requeridos de la sección
        Marcos vinculados
        y
        Bibliotecas
        en la pestaña
        General
        .
        Destinos de aplicaciones iOS:
        • AdobeMobileLibrary.a
        • MediaSDK.a
        • libsqlite3.0.tbd
          Destinos de Apple TV (tvOS):
        • AdobeMobileLibrary_TV.a
        • MediaSDK_TV.a
        • libsqlite3.0.tbd
        • SystemConfiguration.framework
      7. Compruebe que la aplicación se compile sin errores.
  2. Importe la biblioteca.
    #import "ADBMediaHeartbeat.h" #import "ADBMediaHeartbeatConfig.h"
  3. Cree una instancia de
    ADBMediaHeartbeatConfig
    .
    Esta sección le ayudará a entender los parámetros de configuración de
    MediaHeartbeat
    y a seleccionar valores de configuración correctos en la instancia de
    MediaHeartbeat
    para conseguir un seguimiento preciso.
    Este es un ejemplo de una inicialización de
    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 el protocolo de
    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. Utilice
    ADBMediaHeartBeatConfig
    y
    ADBMediaHeartBeatDelegate
    para crear la instancia
    ADBMediaHeartbeat
    .
    //Replace <ADBMediaHeartBeatDelegate> with your delegate instance _mediaHeartbeat = [[ADBMediaHeartbeat alloc] initWithDelegate: <ADBMediaHeartBeatDelegate> config:config];
    Asegúrese de que la instancia de
    ADBMediaHeartbeat
    es accesible y
    no se desasigna hasta el final de la sesión
    . Esta instancia se utilizará para todos los eventos de seguimiento posteriores.

Migración de la versión 1.x a 2.x en iOS

En la versión 2.x, todos los métodos públicos se incluyen en la clase
ADBMediaHeartbeat
para facilitar el trabajo de los desarrolladores. Todas las configuraciones se incluyen en la clase
ADBMediaHeartbeatConfig
.
Para obtener información detallada sobre la migración de 1.x a 2.x, consulte Migración de VHL 1.x a 2.x.

Configurar una aplicación nativa para tvOS

Ahora, gracias al lanzamiento del nuevo Apple TV, puede crear aplicaciones para utilizarlas en el entorno nativo de tvOS. Puede crear una aplicación original con varios marcos de trabajo disponibles en iOS o crear la aplicación utilizando plantillas XML y JavaScript. MediaSDK es compatible con tvOS a partir de la versión 2.0. Para obtener más información sobre tvOS, consulte el Sitio para desarrolladores de tvOS.
Complete los siguientes pasos en su proyecto Xcode. En esta guía se presupone que el proyecto está dirigido a una aplicación de Apple TV para tvOS:
  1. Arrastre el archivo de biblioteca
    VideoHeartbeat_TV.a
    a la carpeta
    lib
    de su proyecto.
  2. En la pestaña
    Fases de compilación
    del destino de su aplicación de tvOS, expanda la sección
    Vincular binario con bibliotecas
    y añada las bibliotecas siguientes:
    • MediaSDK_TV.a
    • AdobeMobileLibrary_TV.a
    • libsqlite3.0.tbd
    • SystemConfiguration.framework