Pular para o conteúdo
CF MEDIA

Apps web na TV

Com a ação link:, o CF media abre um site ou app web inteiro em tela cheia, na mesma janela, com o controle remoto funcionando.

Abrir automaticamente

cfmedia/home.json
{
  "headline": "Meu App",
  "items": [
    {
      "layout": "0,0,6,3",
      "icon": "play_arrow",
      "title": "Abrir Meu App",
      "action": "link:http://{SERVER}/index.html"
    }
  ],
  "ready": { "action": "link:http://{SERVER}/index.html" }
}
info
Em servidores sem licença, o app web abre no modo gratuito (espera, marca d’água, avisos) e nunca automaticamente na abertura do app. Veja Servidores licenciados.

O botão Voltar

  • O Voltar do controle faz o que o navegador faria: volta no histórico do seu app (history.back()). Se o seu app usa popstate para navegar entre telas, funciona naturalmente.
  • No início do histórico, o Voltar retorna ao CF media, sem reabrir o seu app sozinho.
  • Segurar Voltar (1 s) ou apertar Menu abre as Configurações do CF media, de qualquer lugar.

Teclas que o seu app recebe

O CF media entrega as teclas do controle com os códigos que apps web de TV (Samsung/LG) já conhecem:

TeclakeyCode
Setas · OK37–40 · 13
Play/Pause10252
Play415
Pause19
Stop413
Avançar · Voltar (mídia)417 · 412
Canal + · Canal −427 · 428
Vermelho · Verde · Amarelo · Azul403 · 404 · 405 · 406

Saber se é TV

No modo TV, o identificador do navegador (User-Agent) termina com CFmedia/1.0.0 AndroidTV. No celular, só CFmedia/1.0.0. Apps web de TV que procuram “AndroidTV” já abrem no modo TV, sem perguntar.

A ponte CFHost (Android)

No app Android, o seu app web encontra o objeto window.CFHost:

MétodoRetorna
CFHost.platform()"android"
CFHost.version()Versão do CF media, ex.: "1.0.0"
CFHost.getDevice()"tv" ou "phone" (escolha do usuário)
CFHost.detectTv()true se o aparelho é uma TV
CFHost.exit()Fecha o app (para um botão “Sair” no seu app)
js
// botão "Sair" do seu app web
if (window.CFHost && CFHost.exit) CFHost.exit();
else history.back();

Tela e orientação

No celular, o seu app web gira com o sensor. Na TV, fica sempre deitado. O CF media não muda o zoom nem o tamanho da fonte do seu app.