Modos de operación del SDK
El SDK puede funcionar en uno o más modos, según la respuesta que reciba del anuncio. servidor.
- Anuncio único
- Un anuncio que se puede reproducir en cualquier momento cuando
start
el mensaje se envía aIMAAdsManager
. Sin inicialización especial para reproducir un solo anuncio. - Grupo de anuncios
- Varios anuncios que se reproducen de manera consecutiva cuando se envía el mensaje
start
a elIMAAdsManager
. No se necesita una inicialización especial para reproducir un solo grupo de anuncios. - Reglas de anuncios
- Una lista de reproducción de pausas publicitarias programadas en determinados momentos en comparación con determinadas
contenido. El mensaje
start
se ignora en el modo de reglas de anuncios. Puede Existen varias pausas publicitarias programadas dentro de una sola playlist (p.ej., anuncios previos al video, anuncios durante el video o al final del video). Para obtener más detalles sobre la implementación, consulta el Reglas de anuncios a continuación.
Reglas de anuncios
IMA El SDK de tvOS admite playlists de anuncios completamente automatizadas. Esta función Inserta pausas publicitarias en el contenido según se especifica en Google Ad Manager cuando coordines anuncios. También simplifica en gran medida el código del reproductor de video necesarios para respaldar las pausas publicitarias, incluidos los anuncios previos al video, durante el video y al final del video.
- Cuando se coordina el tráfico de anuncios en Ad Manager, es posible especificar varias reglas de anuncios como "Reproducir siempre la pausa publicitaria al comienzo del contenido" o "reproducir una pausa publicitaria de un minuto cada 30 minutos de contenido".
- Cuando se solicitan anuncios, el servidor de anuncios puede mostrar una playlist de anuncios. El SDK procesa la playlist y programa automáticamente las pausas publicitarias que se han especificada.
- Cuando se inicializa
AdsManager
, se genera unIMAContentPlayhead
El objeto se pasa a través deinitializeWithContentPlayhead:adsRenderingSettings:
. llamada. Si usas AVPlayer para mostrar tu contenido, pasas un deIMAAVPlayerContentPlayhead
al SDK cuando creas tuadDisplayContainer
Este objeto se usa para seguir el progreso de la reproducción de contenido se insertan automáticamente en los momentos especificados en Ad Manager.
Con AVPlayer:
IMAContentPlayhead *contentPlayhead = [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer]; IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl adDisplayContainer:adDisplayContainer contentPlayhead:contentPlayhead userContext:nil];
Sin AVPlayer:
- Implementa la interfaz
IMAContentPlayhead
. - Implementa
currentTime
para mostrar la hora actual de tu reproductor de video. - Cambia la llamada de inicialización
IMAAdsManager
a usainitializeWithContentPlayhead:self
.
- Implementa la interfaz
- La función IMAAdsManagerDelegate se usa para pausar y reanudar el contenido mientras se reproducen las pausas publicitarias.
Nota: Cuando el contenido se haya terminado de reproducir o
el usuario detuvo la reproducción, asegúrate de llamar a contentComplete
en el IMAAdsLoader
para indicarle al SDK que el contenido
ha terminado de reproducirse. Luego, el SDK reproduce la pausa publicitaria al final del video, si se programó una.
El evento ALL_ADS_COMPLETED
se genera cuando todas las pausas publicitarias tienen
se reprodujeron. Además, ten en cuenta que el seguimiento de contenido comienza cuando
initializeWithContentPlayhead:adsRenderingSettings
de IMAAdsManager
siempre debes llamar a initializeWithContentPlayhead:adsRenderingSettings
antes de reproducir el contenido.