Cómo exhibir campañas bajo demanda por solicitud HTTP

Cuando se publica una campaña bajo demanda para reproductores Windows o Android, se puede exhibir en la pantalla al hacer clic en el botón “Play”, o a través de una solicitud HTTP.


¿No sabe cómo publicar campañas bajo demanda? Aprenda en este tutorial.


publish campaign on demand

En este tutorial, usted va a descubrir cómo obtener la dirección de la campaña bajo demanda y cómo exhibirla según distintos parámetros.

  1. Abra el reproductor o grupo de reproductores en que usted publicó la campaña bajo demanda.
  2. Haga clic en “Campañas del reproductor”.
  3. Se puede hallar la campaña bajo “Campañas activadas”. Haga clic con el botón derecho del ratón encima del ícono de play a la derecha y elija la opción “Copiar dirección del URL” para obtener el Playback URL.

copy on demand campaign url
El Playback URL puede ser utilizado para automatizar la exhibición de la campaña en aquel reproductor o grupo específico a través de una solicitud HTTP del tipo GET:

https://app.onsign.tv/play/VL3GR4qlL7ZcdHLOF4O0
  1. Cuando lo haga, es posible utilizar algunos parámetros para controlar el comportamiento de la exhibición:
Parámetro Comportamiento
repeat Añada un número de 0 a 999 para definir cuantas veces en secuencia la campana debe ser reproducida. Al inserir 0, la campaña será mostrada infinitamente en la pantalla.
action Controla la secuencia de exhibición de las campañas bajo demanda (lea más en el título abajo)
Cualquier otro Cualquier otro parámetro puede ser añadido a la direción de la campaña, y estará disponible a través del Javascript en
signage.playbackInfo()

Ejemplo:

Cuando se solicite la dirección abajo, el reproductor va a exhibir la campaña indefinidamente caso el parámetro info esté disponible para la campaña.

$ curl 'https://app.onsign.tv/play/VL3GR4qlL7ZcdHLOF4O0?repeat=0&info=1234'

Cómo poner campañas bajo demanda en fila

Por defecto, la campaña empieza cuando se acceda a la dirección, interrumpiendo el contenido de la pantalla.

Desde la versión 7.0.3 de la aplicación OnSign TV para Android es posible exhibir campañas bajo demanda de otras maneras al utilizar el parámetro
action:

Action Resultado
play Interrumpe inmediatamente el contenido de la pantalla y comienza la exhibición de la campaña bajo demanda. Este es el comportamiento por defecto para action si no hay otro definido.
queue Ponga la campaña bajo demanda en fila para que empiece a ser exhibida tan pronto el contenido de la pantalla se acabe. Si ya hay otras campañas en filas, esas serán exhibidas en primer lugar.
playqueue Añada nuevo contenido a fila. Cuando esté siendo exhibida campañas que no sean bajo demanda, serán interrumpidas inmediatamente y la fila empezará a ser reproducida.

Al combinar esos parámetros es posible construir varias interacciones.

Ejemplos:

Supongamos que en un reproductor hayan trés campañas bajo demanda publicadas, “A”, “B” y “C”, además de dos campañas en bucle primario (“X” y “Y”).

  • Dispare trés campañas bajo demanda en fila: Al llamar la siguiente dirección cuando “X” esté en la pantalla…
https://app.onsign.tv/play/token_A?action=playqueue
https://app.onsign.tv/play/token_B?action=playqueue
https://app.onsign.tv/play/token_C?action=playqueue

El reproductor va a parar de exhibir la campaña “X” inmediatamente para reproducir “A”, “B” y “C”.

  • Comience a reproducir una campaña bajo demanda y descarte la fila: Tras acceder al enlace anterior, la fila de campaña empieza a reproducirse. Cuando la campaña bajo demanda “B” esté siendo reproducida, solicite la siguiente dirección:
   https://app.onsign.tv/play/token_A

El reproductor va a exhibir la campaña “A” y luego las campañas del bucle primario (“X” y “Y”), que han sido interrumpidas antes. La campaña bajo demanda “C” no será exhibida porque el parámetro action=play descarta la fila de campañas.