Seguimiento de reproducción principal en iOS track-core-playback-on-ios

Configuración de seguimiento inicial

Identifique el momento en que el usuario desencadena la intención de reproducir (cuando hace clic en reproducir o la reproducción automática está activada) y cree una instancia de MediaObject.

API de createMediaObjectWithName

StreamTypeConstantes:

MediaTypeConstantes:

Formato general para crear el objeto MediaObject:

ADBMediaObject *mediaObject =
  [ADBMediaHeartbeat createMediaObjectWithName:<MEDIA_NAME>
                                       mediaId:<MEDIA_ID>
                                        length:<MEDIA_LENGTH>
                                    streamType:<STREAM_TYPE>
                                     mediaType: <MEDIA_TYPE>];

Adjuntar metadatos de vídeo

Opcionalmente, se pueden adjuntar objetos de metadatos de vídeo estándar o personalizados a la sesión de seguimiento de vídeo mediante el uso de variables de datos de contexto.

• Metadatos de vídeo estándar

  • Implementación de metadatos estándar en iOS

  • Claves de metadatos de vídeo
    Claves de metadatos de iOS

  • Consulte la lista completa de metadatos de vídeo aquí: Parámetros de audio y vídeo.

  note note
  NOTE
  No es obligatorio adjuntar el objeto de metadatos de vídeo estándar al objeto de contenidos.

• Metadatos personalizados

  Cree un objeto de variable para las variables personalizadas y rellénelo con los datos de este vídeo. Por ejemplo:

  code language-none
  NSMutableDictionary *videoMetadata = [[NSMutableDictionary alloc] init]; [videoMetadata setObject:@"false" forKey:@"isUserLoggedIn"]; [videoMetadata setObject:@"Sample TV station" forKey:@"tvStation"];

Realice un seguimiento de la intención de iniciar la reproducción

Para empezar a realizar el seguimiento de una sesión multimedia, invoque trackSessionStart en la instancia de Media Heartbeat.

- (void)onMainVideoLoaded:(NSNotification *)notification {
//    [_mediaHeartbeat trackSessionStart:mediaObject data:nil];
    [_mediaHeartbeat trackSessionStart:mediaObject data:videoMetadata];
}

Realizar un seguimiento del inicio real de la reproducción

Identifique el evento del reproductor de vídeo para el principio de la reproducción, cuando se renderice el primer fotograma del vídeo en la pantalla e invoque trackPlay:

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}

Realizar un seguimiento de la finalización de la reproducción

Identifique el evento del reproductor de vídeo para la finalización de la reproducción, cuando el usuario ha visto el contenido hasta el final e invoque trackComplete:

- (void)onVideoComplete:(NSNotification *)notification {
    [_mediaHeartbeat trackComplete];
}

Realizar un seguimiento del final de la sesión

Identifique el evento del reproductor de vídeo para la descarga o cierre de la reproducción, cuando el usuario cierra o completa la descarga e invoque trackSessionEnd:

- void)onMainVideoUnloaded:(NSNotification *)notification {
    [_mediaHeartbeat trackSessionEnd];
}

Rastrear todos los escenarios de pausa posibles

Identifique el evento del reproductor en el que se pause el vídeo e invoque trackPause:

- (void)onVideoPause:(NSNotification *)notification {
    [_mediaHeartbeat trackPause];
}

Pausar escenarios

Identifique cualquier situación en la que se pausará el reproductor y compruebe que se ha invocado trackPause correctamente. Las siguientes situaciones requieren que la aplicación invoque trackPause():

• El usuario hace una pausa explícita en la aplicación.
• El reproductor se pone en estado de pausa.
• (Aplicaciones móviles): El usuario pone la aplicación en segundo plano, pero desea que la aplicación mantenga abierta la sesión.
• (Aplicaciones móviles): Se produce cualquier tipo de interrupción del sistema que provoca que una aplicación se ponga en segundo plano. Por ejemplo, si el usuario recibe una llamada o aparece una ventana emergente de otra aplicación, pero desea que la aplicación mantenga la sesión activa para que el usuario pueda reanudar el vídeo desde donde se produjo la interrupción.

Identifique el evento del reproductor en el que el vídeo se reproduzca o se reanude e invoque trackPlay:

- (void)onVideoPlay:(NSNotification *)notification {
    [_mediaHeartbeat trackPlay];
}