StreamManager
Controla transmisiones de inserción de anuncios dinámicos. Administra las interacciones con el backend de la DAI y controla los pings de seguimiento, así como el reenvío de eventos de transmisión y de anuncios al publicador. Este administrador no hereda contenido de BaseAdsManager, ya que no es un administrador de un anuncio específico, sino de toda la transmisión.
Constructor
StreamManager
new StreamManager(videoElement, adUiElement, uiSettings)
Parámetro |
|
---|---|
videoElement |
Es el elemento de video HTML en el que se producirá la reproducción. El valor no debe ser nulo. |
adUiElement |
Opcional Es el elemento HTML que se usa para contener los elementos de la IU del anuncio. Este elemento debe tener el mismo alto y ancho que la reproducción del video y debe superponerse directamente. Si no se proporciona, no se mostrará ninguna IU ni se solicitarán anuncios que la requieran, como los que se pueden omitir. El valor no debe ser nulo. |
uiSettings |
Opcional La configuración de la IU que se usará en esta transmisión. El valor no debe ser nulo. |
- Implementa
- EventTarget
- Arroja
-
cuando los parámetros de entrada no cumplen con los requisitos.
Métodos
contentTimeForStreamTime
contentTimeForStreamTime(streamTime) muestra número
Muestra el tiempo del contenido sin anuncios en un tiempo de transmisión determinado. Muestra el tiempo de transmisión determinado para las transmisiones en vivo.
Parámetro |
|
---|---|
streamTime |
número el tiempo de transmisión con los anuncios insertados (en segundos). |
- Muestra
-
number
: Es el tiempo del contenido que corresponde al tiempo de transmisión determinado una vez que se quitan los anuncios.
enfoque
enfoque()
Pone el foco en el botón Omitir (si está presente). Si no están presentes, se enfocan en los elementos interactivos, como los íconos o las creatividades interactivas.
getAdSkippableState
getAdSkipState() muestra un valor booleano
Muestra true si el anuncio se puede omitir actualmente. Cuando cambia este valor, StreamManager
activa un evento StreamEvent.SKIPPABLE_STATE_CHANGED
.
- Muestra
-
boolean
Verdadero si se puede omitir el anuncio en este momento; de lo contrario, es falso.
loadStreamMetadata
loadStreamMetadata()
Solicita al SDK que cargue los metadatos del anuncio y, luego, transmite StreamEvent.LOADED. Se debería activar manualmente una vez que se recupere el manifiesto de transmisión de la herramienta de unión de videos de terceros. Esto solo se usa para VOD de publicación de grupos de anuncios con una herramienta de unión de videos de terceros y no es-op para otras solicitudes de transmisión.
onTimedMetadata
onTimedMetadata(metadata)
Pasa un diccionario de metadatos procesados. El diccionario espera la clave "TXXX" con la cadena de metadatos definida por el usuario como valor. Si el reproductor proporciona metadatos sin procesar, llama a StreamManager.processMetadata en su lugar.
Parámetro |
|
---|---|
metadatos |
Objeto El diccionario de metadatos. El valor no debe ser nulo. |
previousCuePointForStreamTime
anteriorCuePointForStreamTime(streamTime) muestra CuePoint.
Muestra el punto de inserción anterior para el tiempo de transmisión determinado. El resultado es nulo si no existe el punto de inserción. Se usa para implementar funciones, como el ajuste automático, y se llama cuando el publicador detecta que el usuario realizó una búsqueda para volver a una pausa publicitaria.
Parámetro |
|
---|---|
streamTime |
número el tiempo de transmisión que se buscó. |
- Muestra
-
nullable CuePoint
: Es el punto de inserción anterior para el tiempo de transmisión determinado.
processMetadata
processMetadata(type, data, timestamp)
Procesa metadatos temporizados para las transmisiones en vivo. Úsala si tu reproductor de video proporciona metadatos sin analizar junto con marcas de tiempo; de lo contrario, llama a StreamManager.onTimedMetadata.
Parámetro |
|
---|---|
tipo |
cadena Tipo para los metadatos. Debe ser “ID3” para HLS o el URI de ID de esquema de mensaje de evento para DASH. |
datos |
(Uint8Array o string no es nulo) Datos de etiqueta sin procesar. Para el ID3, deben ser los datos sin procesar completos de la etiqueta. Para los mensajes de evento DASH, esta es la cadena de datos del mensaje. |
timestamp |
número Tiempo en segundos en que se deben procesar los datos. Para DASH, esta es la hora de inicio del mensaje del evento. |
replaceAdTagParameters
replaceAdTagParameters(adTagParameters)
Reemplaza todos los parámetros de etiqueta de anuncio que se usan para las próximas solicitudes de anuncios de una transmisión en vivo.
Parámetro |
|
---|---|
adTagParameters |
Objeto con propiedades de cadena Los parámetros de la nueva etiqueta de anuncio. Debe contener valores de cadena. El valor no debe ser nulo. |
requestStream
requestStream(streamRequest)
Solicita que se cargue una transmisión con los parámetros de transmisión proporcionados.
Parámetro |
|
---|---|
streamRequest |
Contiene parámetros para cargar los metadatos de la transmisión. El valor no debe ser nulo. |
restablecer
restablecer()
Restablece el administrador de transmisiones y quita los sondeos continuos.
setClickElement
setClickElement(clickElement)
Establece el elemento de clics en los anuncios. Se usa como receptor de clics o de presión mientras se reproduce un anuncio y puede hacer que salgas de la página actual. Esta función dejó de estar disponible y, en su lugar, se debe pasar un adUiElement a StreamManager. Si se proporciona un adUiElement al constructor de StreamManager, este método se convierte en una no-op.
Parámetro |
|
---|---|
clickElement |
Elemento Es el elemento que se usa cuando se hace clic en el anuncio. El valor puede ser nulo. |
- Funciones obsoletas
- En su lugar, proporciona un adUiElement al constructor de StreamManager.
streamTimeForContentTime
streamTimeForContentTime(contentTime) muestra number
Muestra el tiempo de transmisión con anuncios para un tiempo de contenido determinado. Muestra la hora de contenido especificada para las transmisiones en vivo.
Parámetro |
|
---|---|
contentTime |
número el tiempo del contenido sin anuncios (en segundos). |
- Muestra
-
number
es el tiempo de transmisión que corresponde al tiempo del contenido determinado una vez que se insertan los anuncios.