Como disparar campanhas sob demanda por requisição de HTTP

Ao publicar campanhas com o filtro “sob demanda” para players Android e Windows, a exibição é condicionada ao clique do botão de “Play”. Também é possível dispará-la com requisição de HTTP.


Não sabe como publicar campanhas sob demanda? Veja tutorial.


publish campaign on demand

Neste tutorial, vamos explicar como obter o endereço da campanha e como exibí-la na tela aplicando diversos parâmetros.

  1. Abra o player ou grupo de players em que a campanha foi publicada.
  2. Selecione “Campanhas no Player”.
  3. A campanha vai se encontrar no box “Campanhas Controladas”. Clique com o botão direito sobre o botão “play” e selecione “Copiar endereço do link”.
    copy on demand campaign url

    Esse endereço pode ser utilizado para tocar a campanha naquele player ou grupo específico, através de uma requisição de HTTP do tipo GET:
  4. https://app.onsign.tv/play/VL3GR4qlL7ZcdHLOF4O0
  5. É possível adicionar os seguintes parâmetros de exibição ao carregar o URL:
Parâmetro Comportamento
repeat Adicione um número de 0 a 999 para especificar quantas vezes a campanha será tocada. Ao escrever 0, a campanha será tocada infinitamente.
action Controla em que sequência as campanhas sob demanda serão exibidas. Leia mais abaixo.
Any other Qualquer outro parâmetro pode ser adicionado ao endereço URL e vai estar disponível através do Javascript em signage.playbackInfo()
signage.playbackInfo()

Exemplo:

Ao requisitar o URL abaixo, o player vai tocar um item indefinidamente ao adicionar o parâmetro info:

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

Organize sequência de exibição de campanhas sob demanda

Por padrão, a campanha é dispara assim que o URL for acessado, interrompendo qualquer campanha exibida anteriormente - seja uma campanha agendado ou outra sob demanda.

A partir das versões 7.0.3 do App de OnSign TV para Android, há novas maneiras de exibir campanhas sob demanda com os parâmetros action:

Action Resultado
play Interrompe a campanha sendo exibida no momento que o URL é solicitado. Qualquer fila de campanhas sob demanda serão descartadas. Esse é o comportamento padrão se não há outra action especificada.
.
queue Adicione a campanha à fila para ser exibida assim que o conteúdo atual acabar. Se houver outras campanhas sob demanda agendadas, a campanha irá ser exibida após aquelas já agendadas.
playqueue Interrompe o ciclo de reprodução atual (campanhas que não sejam sob demanda) e começa a exibir campanhas sob-demanda em fila.

Essas três ações permitem realizar várias interações.

Exemplos:

Suponha que um dispositivo tem publicadas as campanhas sob demanda “A”, “B” e “C”, as campanhas principais “X” e “Y”.

  • Dispare três campanhas sob demanda em sequência: Se o player exibe a campanha X e alguém requisita:
  • 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

    O player vai interromper automaticamente a exibição da campanha “X” e começará a tocar a campanha “A”, seguida da “B” e, por fim, “C”.

  • Dispare nova campanha sob demanda e descarte fila: Agora, alguém requisita o seguinte URL quando a campanha “B” está tocando:
  •    https://app.onsign.tv/play/token_A

    O player vai começar a exibir imediatamente a campanha “A”. Em seguida, a campanha “X”, que havia sido interrompida anteriormente vai ser retomada, depois a "Y", e assim por diante.
    Note que a campanha “C” não será exibida, já que a fila é descartada ao utilizar o parâmetro action=play.