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 usapopstatepara 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:
| Tecla | keyCode |
|---|---|
| Setas · OK | 37–40 · 13 |
| Play/Pause | 10252 |
| Play | 415 |
| Pause | 19 |
| Stop | 413 |
| Avançar · Voltar (mídia) | 417 · 412 |
| Canal + · Canal − | 427 · 428 |
| Vermelho · Verde · Amarelo · Azul | 403 · 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étodo | Retorna |
|---|---|
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.