Wiki Vertex Cloud

Versão inicial · sujeito a revisão

Guia básico de funcionamento da Cloud e do Player Lite. Use os links dos ícones ⓘ na ferramenta para chegar às seções abaixo.

Manutenção: este Wiki é um rascunho operacional. Precisa de atualizações e revisões futuras (novos layouts, widgets, billing, OTA e edge cases de Ads). Responsável: produto/engenharia Vertex. Checklist sugerido: revisar a cada sprint que altere layouts, agendas ou player.

Índice Layouts e zonas Aspectos e publicação Vídeo em Ads (A + B) Biblioteca e aspectos de mídia Widgets (carrossel, news, footer) Player Lite e OTA Perguntas frequentes

Layouts e zonas

O layout da TV define a geometria da tela — não o conteúdo.

Tela cheia — Paisagem: uma zona 16:9
Tela cheia — Retrato: uma zona 9:16
Ads (esquerda/direita): Zona A (~31,6% largura, 9:16) + Zona B (resto, 5:4). Rodapé é overlay.

Ao mudar o layout de uma tela, as publicações daquela TV são canceladas e o player fica em idle até republicar.

Aspectos e publicação

Cada agenda tem um aspecto que encaixa na zona correspondente:

9:16 → Zona A (Ads) ou tela cheia retrato
5:4 → Zona B (Ads)
16:9 → tela cheia paisagem

Conflito de publicação só ocorre no mesmo aspecto com horário sobreposto. Aspectos diferentes podem cruzar no mesmo horário.

Vídeo em Ads (A + B)

Em layout Ads, vídeos são sem áudio (somente visual). O Player Lite tenta tocar vídeo nas duas zonas ao mesmo tempo (2× ExoPlayer).

Se a TV não aguentar dois decoders, entra em fallback: prioridade de vídeo na Zona B (5:4). A Zona A passa a focar imagem, carrossel e news — itens de vídeo na playlist da A podem ser pulados.

Recomendação: agendas de vídeo pesado preferencialmente em 5:4; Zona A com imagens/carrossel/news quando possível.

Biblioteca e aspectos de mídia

Prepare arquivos no aspecto da zona de destino. O player preenche o quadro (fit); proporção diferente pode distorcer.

Widgets

Carrossel: sequência de imagens com duração por slide
News: manchetes via RSS, renderizadas no player
Footer: rodapé overlay (relógio, texto, etc.)

Player Lite e OTA

Download e tutorial: vertex.maggioreav.com.br/lite. O app sincroniza layouts e playlists pela Cloud (produção ou staging no pairing).

A TV pareada em staging usa o OTA de staging; em produção, o OTA de produção. Se o painel mostrar “Atualizado” mas o app for antigo, confira se o ambiente (staging/prod) tem a mesma versão LITE_* publicada. Recursos de Ads (vídeo na Zona B / dual ExoPlayer) exigem APK recente (ex.: 1.0.14+).

Perguntas frequentes

Por que a Zona B não toca?

Confira: layout Ads na TV, agenda com aspecto 5:4, horário ativo, publicação feita após a última troca de layout, e APK atualizado.

Por que só a Zona A mostra conteúdo?

Se só houver agenda 9:16, a B fica vazia. Publique também uma agenda 5:4.

Mudar layout “apagou” a programação?

As publicações daquela tela são canceladas de propósito. As agendas continuam salvas — é só republicar.

Vertex Cloud Wiki · documento vivo · última estrutura: Jul/2026