Wiki Vertex Cloud

Base operacional · ago/2026

A Vertex Edge Lite nasceu de um problema simples e caro: colocar mídia no ar em TVs reais — loja, elevador, academia, hall — sem depender de pendrive, sem equipe de TI e sem plataformas que só fazem sentido em redes gigantes.

Queremos que você chegue a um lugar concreto: uma rede de telas sob o seu controle, com conteúdo certo no horário certo, preview remoto do que o público está vendo e espaço para crescer de uma TV de teste até uma operação de mídia indoor, Ads ou DOOH.

Por isso unimos o Player Edge Lite (na TV Android) ao Vertex Cloud (na nuvem): parear, publicar, ajustar layout, widgets e agenda — tudo no mesmo fluxo. A escolha Vertex é essa combinação de caminho curto para a primeira imagem no ar e ferramentas profundas quando a operação escala.

Esta página é o mapa completo desse sistema: o porquê de cada menu, o efeito de cada decisão na TV e o caminho até essa conquista. Se quiser só o atalho visual agora, use o Tutorial.

Tutorial e Wiki se complementam: o Tutorial cobre o fluxo rápido (conta, APK, pareamento e publicação). A Wiki explica a arquitetura e a operação do dia a dia — para você chegar e se manter no ar com segurança.

Capítulo 1

Fundamentos

Antes de abrir cada menu, vale entender as três camadas do sistema e o caminho mínimo até a primeira publicação.

Tela com zonas de layout e conteúdo

Modelo mental do sistema

O Vertex Edge Lite separa três camadas de propósito:

  1. Tela (hardware + app) — a TV Android pareada; onde o público vê.
  2. Layout — a geometria da tela (cheia ou Ads A+B). Não é conteúdo.
  3. Conteúdo + agenda — mídias, widgets, playlists e horários publicados na nuvem.
Por que isso importa: layout define onde as zonas existem; playlist/agenda definem o que toca e quando. Publicar é o ato que liga as duas coisas na TV.

Menus: Minhas telas · Biblioteca · Playlists · Agendamento · Widgets

Fluxo até Publicar no Cloud

Primeiros passos

Caminho mínimo até a TV no ar (detalhe visual no Tutorial):

  1. Conta no Cloud
  2. APK na TV (bit.ly/vertexlite)
  3. Parear em Minhas telas
  4. Upload na Biblioteca
  5. Playlist + Agendamento
  6. Publicar…
Dica: se o objetivo agora é só a primeira imagem na TV, siga o Tutorial e volte aqui para aprofundar.

Capítulo 2

Operação por tela

Cada ponto da rede tem contexto próprio. Aqui você controla, diagnostica e altera layout sem perder a visão do que está no ar.

Minhas telas — o centro de comando por ponto

Minhas telas não é só a lista de TVs. É o lugar onde você opera cada ponto individualmente: ver o que está no ar, mudar layout, interromper agenda, atualizar o app e republicar.

Por que existe um drawer por tela: em mídia indoor / DOOH, cada ponto tem contexto diferente (elevador ≠ vitrine ≠ academia). Controlar tudo só pelo Agendamento global não basta — você precisa diagnosticar e agir no ponto.
Lista Minhas telas e drawer com Preview, Controle, Layout e Agenda
Clique na linha da TV → drawer lateral com preview ao vivo e abas Controle / Layout / Agenda.

Preview ao vivo

No topo do drawer, o Preview ao vivo mostra um snapshot quase em tempo real do que a TV está exibindo (quando Online). É a prova visual de que publicação, layout e widgets chegaram ao ponto — sem precisar ir até a loja.

Argumento de operação: redes com dezenas de telas vivem de confiança remota. Preview + status Online/Offline + último sinal evitam “achar que publicou” quando a TV está offline ou em idle.

Aba Controle

  • O quê está tocando: playlist ativa, mídia atual, programa publicado, agenda agora
  • Saúde do ponto: memória, storage livre, ping, último sinal
  • Comandos: Tocar · Parar · Sync · Atualizar app

Parar / Tocar entram em Modo manual — a agenda automática fica suspensa. Use quando precisa “segurar” a tela (manutenção, evento, teste). Para voltar ao horário publicado: Retomar agenda.

Por que Modo manual: às vezes você precisa intervir agora, sem editar a agenda da rede inteira. Manual isola o ponto; Retomar agenda devolve o controle ao Cloud.

Atualização do app (OTA)

No mesmo drawer: Versão instalada × Versão disponível. Se houver update, aparece Atualização disponível — use Atualizar app para a TV baixar e abrir o instalador.

Staging e produção têm OTA separados (conforme o ambiente do pareamento).

Aba Layout

Define a geometria daquela TV (não o arquivo de mídia):

  • Modo Paisagem ou Retrato
  • Templates: Tela cheia · Ads (A esquerda / A direita / A acima · B abaixo)
  • Salvar layout — cancela publicações daquela TV e deixa idle até republicar
Regra de ouro: mude layout só quando a geometria do ponto muda. Depois, sempre Republicar…. As agendas continuam salvas.

Aba Agenda

Visão do dia naquele ponto: o que está Em execução, o que está Aguardando, e se a publicação está válida. Atalho Republicar… quando o ponto ficou idle após troca de layout.

Layouts e zonas — o “onde” do conteúdo

Layout = mapa da tela. Conteúdo = o que preenche cada zona via agenda do aspecto certo.

  • Tela cheia — Paisagem → zona 16:9 (comece por aqui no primeiro teste)
  • Tela cheia — Retrato → zona 9:16
  • Ads → Zona A (criativo vertical) + Zona B (peça principal) + rodapé overlay opcional
Por que Ads em zonas: mídia indoor moderna vende atenção em formatos mistos — institucional + anúncio na mesma TV, com agendas independentes. É o que permite monetizar PDV/elevador sem apagar o conteúdo da casa.

Como a TV fica no ar

Depois de layout + duas agendas (quando Ads) + publicar, o resultado visual é este:

TV em paisagem com Zona A 9:16, Zona B 5:4 e rodape
Ads em paisagem: A (9:16) + B (5:4) + rodapé overlay.
TV em retrato com Zona A acima e Zona B abaixo
Ads em retrato: A acima · B abaixo.

Cada zona exige agenda com o aspecto correspondente. Sem agenda 5:4 publicada, a Zona B fica vazia — não é bug, é falta de publicação naquele aspecto.

Capítulo 3

Conteúdo

Biblioteca, playlists, agendamento e widgets: o que toca, em qual ordem e com qual contexto vivo na tela.

Biblioteca

Repositório de arquivos da conta. Upload em Full HD (1080p). 2K/4K são rejeitados de propósito: economizam storage e evitam TV fraca engasgando.

Upload na Biblioteca
Arraste · Enviar · depois use em Playlist ou Carrossel.
Por que Biblioteca separada de Playlist: o mesmo arquivo pode entrar em várias playlists e pontos. Você organiza mídia uma vez e reutiliza na rede.

Playlists, Agendamento e Publicar

Fluxo playlist e agendamento
Playlist monta a sequência; Agendamento define quando e em qual aspecto.
  • Playlist = ordem de mídias/widgets
  • Agendamento = aspecto + horário/dias + playlist
  • Publicar… = envia para a(s) tela(s) escolhida(s)
Modal Publicar
Sem Publicar, a agenda fica em rascunho e a TV em idle.
Por que Publicar é um passo explícito: evita que um rascunho pela metade vá ao ar na rede. Você edita com segurança e só então dispara o sync nas TVs escolhidas.

Widgets — por que existem

Em mídia indoor, vídeo estático sozinho envelhece rápido. Widgets trazem contexto vivo (notícia, clima, mercado) e aumentam tempo de atenção — sem exigir que o operador gere arte nova todo dia.

Hub de Widgets no Cloud
Hub Widgets: News · Clima · Mercados · Carrossel · Rodapé.
Exemplo de configuracao de News e fluxo ate Publicar
Padrão: criar widget → Preview → Salvar → inserir na Playlist → Agendar → Publicar.

Vão na Playlist

News · Clima · Mercados · Mensagem · Carrossel

Vai na tela (overlay)

Rodapé — aplica direto nas TVs marcadas

News

O quê: manchetes a partir de feeds RSS, com templates Story / lista / destaque.

Onde: Widgets → News → Novo News → depois item na Playlist (aspecto da zona).

Por quê: a tela “parece viva” todos os dias sem redesign. Em elevadores e academias, News + Ads na mesma TV é o padrão de engajamento + monetização.

  • Fontes RSS (uma URL por linha)
  • Modo Solto (1 artigo) ou Carrossel de Stories
  • Duração, refresh e ordem aleatória
  • Preview HTML antes de salvar

Clima

O quê: condição e horizonte do tempo por cidade.

Onde: Widgets → Clima → salva → Playlist.

Por quê: clima é o widget mais universal de varejo e hall — contexto local barato e legível a distância. Horizonte até 5 dias na TV.

Mercados

O quê: câmbio, índices e ações em lista/cards ou gráfico (linha/área/candle).

Onde: Widgets → Mercados → Playlist (ótimo em 16:9 ou Zona B).

Por quê: escritórios, coworkings e áreas corporativas querem “tela de status” o dia todo — aumenta percepção de produto profissional sem equipe de design.

Carrossel

O quê: sequência de imagens com ritmo de stories.

Onde: preferencialmente na Playlist → Adicionar → Grupo de mídias (atalho no hub Widgets).

Por quê: vitrine, cardápio visual e campanhas locais precisam de ritmo — carrossel entrega isso sem exportar vídeo.

Rodapé (Footer)

O rodapé é um overlay opt-in na base da TV. Ele não entra na playlist e não usa Publicar: você cria o perfil, escolhe os módulos e marca as telas. Desmarcar a tela (e salvar) remove o rodapé dela. Excluir o perfil remove de todas. Sem tela marcada, a TV não exibe a barra.

Esquema dos modulos do rodape
Esquema: módulos disponíveis e como se organizam na barra.
Rodape realista sobreposto na TV com dados de exemplo
Na TV: barra clara sobre o conteúdo, com câmbio, índice, clima, manchete e hora (dados de exemplo).
  • Módulos: Câmbio · Índices · Clima · Trânsito · Relógio · Manchetes · Texto
  • Manchetes em marquee (rolagem) ou fixo
  • Trânsito / CET-SP só neste widget
Por que overlay e não playlist: o rodapé precisa permanecer visível enquanto A/B trocam campanhas. Se fosse item de playlist, sumiria a cada troca de mídia — perderia o papel de “barra de contexto”.

Capítulo 4

Conta e planos

Cadastro em dia e capacidade certa de telas/armazenamento para a operação crescer sem surpresa.

Dados da conta

Em Meu cadastro no Cloud, mantenha nome, e-mail, telefone e endereço atualizados. Esses dados são usados em recibos, comunicação de suporte e, quando houver assinatura, no faturamento.

Por que isso importa: conta com dados incompletos atrasa suporte, dificulta emissão de documentos e pode impedir a conclusão de um upgrade de plano no checkout. Vale completar assim que o teste começar a funcionar.

Acesse: Cloud → Meu cadastro (também funciona com ?page=account).

Planos e pagamento

O teste libera capacidade temporária (telas e armazenamento). Depois, a conta pode seguir no plano gratuito (1 tela) ou assinar um plano Edge Lite com mais pontos e biblioteca.

  • Compare opções em Planos / Faturamento no menu Conta
  • Checkout via Stripe (cartão); mensal ou anual, conforme a oferta ativa
  • Upgrade aumenta limite na hora; reduzir plano pode exigir ajustar telas excedentes em Minhas telas
  • Se o pagamento falhar, o sistema avisa por e-mail e há prazo de tolerância antes de restringir telas

Atalhos: Ver planos · Faturamento

Capítulo 5

Avançado e FAQ

Aspectos, vídeo em Ads, atualização do player e respostas com contexto para os casos mais comuns.

Aspectos e conflitos

Na agenda, o aspecto é o destino do conteúdo — não o nome do layout da TV.

  • Zona A · 9:16 — conteúdo vertical. Ads paisagem → Zona A; Ads retrato → Zona B (~4:5); tela cheia retrato → TV inteira.
  • 16:9 · Tela cheia / Zona A — conteúdo horizontal. Tela cheia paisagem → TV inteira; Ads retrato → faixa superior (Zona A é 16:9 nesse layout).
  • Zona B · 5:4 — conteúdo largo. Ads paisagem → Zona B (5:4). Em Ads retrato a Zona B é ~4:5 (prefira agenda 9:16 para a B).

Na publicação, cada tela mostra o layout atual e a zona + proporção onde a agenda encaixa. Conflito só no mesmo destino com horário sobreposto.

Vídeo em Ads (A + B)

Em Ads, vídeo é sem áudio (ambiente compartilhado). O player tenta dual vídeo; se a TV não aguentar, prioriza vídeo na Zona B e a A fica com imagem/News/carrossel.

Player Lite e OTA

O app na TV sincroniza layouts e agendas pela nuvem. Atualize por Minhas telas → Controle → Atualizar app. Passo a passo de instalação: Tutorial.

FAQ

Perguntas frequentes

Respostas com contexto para operar o Cloud e o Player Edge Lite com segurança.

A TV ficou preta / idle depois do pareamento

Isso é esperado se só o pareamento foi feito. Parear autentica a TV na sua conta — ainda não envia conteúdo. O player entra em idle até existir uma agenda publicada. Complete: Biblioteca → Playlist → Agendamento → Publicar….

Onde controlo uma tela específica?

Em Minhas telas, clique na linha da TV. Abre o painel com Preview ao vivo e as abas Controle, Layout e Agenda. Cada ponto tem contexto próprio — operar só pelo Agendamento global não basta para diagnosticar um PDV ou elevador específico.

Como paro a agenda sem desparear a TV?

Abra a tela → Controle → Parar. A TV entra em Modo manual: a agenda fica suspensa, o pareamento permanece. Para voltar ao horário da nuvem, use Retomar agenda — sem reescrever a programação da rede inteira.

O preview ao vivo não aparece

O preview depende da TV Online enviando heartbeat/screenshot. Aguarde alguns segundos, use Sync e confira o último sinal em Controle. Em redes corporativas restritas o upload pode demorar — o status Online/Offline continua sendo a referência principal.

Por que a Zona B não toca?

Em Ads, cada zona só recebe agenda do aspecto correspondente. A Zona B exige publicação 5:4. Confira layout Ads, agenda 5:4, horário ativo, Publicar… após troca de layout e APK atualizado. Se só existir agenda 9:16, a A toca e a B fica vazia.

Mudar layout “apagou” a programação?

Ao salvar um novo layout, o sistema cancela as publicações daquela TV de propósito: as zonas mudaram de geometria. As agendas continuam salvas — use Agenda → Republicar… ou publique de novo em Agendamento.

Widget não aparece na TV

Salvar o widget só cria o objeto. Para ir ao ar: Playlist → Agendamento (aspecto da zona) → Publicar…. Exceção: o Rodapé aplica direto nas telas marcadas, sem playlist.

Rodapé some quando a playlist troca?

Não deveria — é overlay fixo. Se sumiu, confira em Widgets → Rodapé se o perfil ainda está na tela, se houve troca de layout sem republicar e se o app está atualizado.

Por que manter os dados da conta atualizados?

Nome, e-mail, telefone e endereço entram em recibos, suporte e checkout. Cadastro incompleto atrasa atendimento e pode bloquear assinatura. Atualize em Meu cadastro.

Como assinar ou alterar um plano?

Em Planos / Faturamento, escolha a capacidade e conclua no Stripe. Upgrade vale na hora; downgrade pode exigir revogar telas excedentes. Falha de cartão gera e-mail e janela de tolerância.

Onde peço ajuda?

Fale em contato@maggioreav.com.br. Inclua nome da tela, Online/Offline, versão do app e o que já tentou (publicar, republicar, atualizar app).