Quick Access LG webOS: como usar long press no 0 para devs

Você provavelmente já usou sua TV como se fosse um segundo monitor para colocar podcast no canto da tela enquanto escreve código. Eu faço isso todos os dias. Mas confesso que até outro dia eu navegava por sete cliques para abrir o YouTube na minha LG webOS — até descobrir que bastava manter o 0 pressionado por três segundos para abrir um menu de atalhos que me economiza pelo menos uns 20 segundos por sessão. Segundo o Catracalivre.com.br, esse recurso existe em diversos modelos da LG com webOS e transforma os números do controle em teclas de acesso rápido. Vou destrinchar isso aqui do ponto de vista de quem trabalha com desenvolvimento.

O que realmente acontece quando você segura o 0 na TV LG

O Quick Access (ou Acesso Rápido) é uma camada de mapeamento de teclas que existe no firmware das TVs LG com webOS desde a linha 2020. Não é mágica — é um registry de bindings que associa um identificador numérico a um aplicativo ou serviço interno, lendo o evento de keydown sustentado no controle físico.

Na prática, a TV interpreta um long press de três segundos na tecla 0 como um sinalizador para abrir o painel de configuração. A partir daí, você pode vincular qualquer número de 1 a 9 (e em alguns firmwares, alfabéticos) a um app instalado. A manutenção da tecla pressionada é o gatilho — não há vibração sonora nem feedback visual durante o hold, o que confunde muita gente na primeira vez.

Quando a associação está feita, o número deixa de ser apenas um canal e vira um shortcut. Pressionar e segurar por 1,5 segundo já dispara o aplicativo — não precisa mais segurar por três. Esse tempo menor é registrado depois da configuração inicial.

Por que isso interessa para quem programa

Para um dev, qualquer economia de interação repetitiva vira produtividade acumulada. Se você abre o YouTube, Spotify ou Plex umas 30 vezes por semana, estamos falando de uns 10 minutos economizados mensalmente só na navegação. Parece pouco, mas é a mesma lógica de criar alias no shell: pequenas alavancas que escalam.

Mas o ponto mais interessante para mim é entender como isso foi implementado. O webOS é uma plataforma baseada em web technologies — HTML5, CSS, JavaScript e o framework Enact — e os atalhos de teclado fazem parte da camada nativa do sistema operacional. Se você trabalha com desenvolvimento web, vale estudar como o webOS trata eventos do controle remoto físico, porque a arquitetura é parecida com a de Progressive Web Apps rodando em TVs.

Comparação com outras plataformas de TV

Repare que a LG é a única entre as grandes que entrega isso nativamente, sem launcher alternativo nem skill de voz. Para quem está pensando em desenvolver apps para TV, isso é relevante: significa que sua aplicação pode aparecer nesse atalho, desde que esteja publicada na LG Content Store.

Na Prática: configurando seu atalho em 4 passos

1. Com a TV ligada e no conteúdo de TV (não em app aberto), pressione e segure o número 0 por três segundos até aparecer o painel “Editar Acesso Rápido”.
2. Selecione um número disponível (1 a 9 aparecem como slots vazios com o ícone “+”).
3. Escolha o aplicativo ou função na lista — Netflix, YouTube, HDMI 1, configurações de imagem, qualquer serviço instalado.
4. Confirme e teste: pressione e segure o número escolhido por 1,5 segundo. O app deve abrir direto, sem passar pela home.

Dica que aprendi testando: se você atribuir o app ao número 1 ou 2, o alcance do polegar é melhor — não precisa esticar a mão até o meio do controle. Para funções que você usa todo dia (como alternar para o notebook via HDMI), o 3 ou 4 funcionam bem.

O “porquê” técnico: long press detection em JavaScript

Como a LG usa web technologies por baixo, o evento de segurar tecla é tratado com lógica de timing em JavaScript. Se você for criar uma app para webOS ou replicar esse comportamento em um sistema IoT, o padrão é assim:

// Detector de long press portável
function createLongPressHandler(element, onShortPress, onLongPress, holdMs = 1500) {
  let timer = null;
  let triggered = false;

  const start = (e) => {
    triggered = false;
    timer = setTimeout(() => {
      triggered = true;
      onLongPress?.(e);
    }, holdMs);
  };

  const cancel = (e) => {
    clearTimeout(timer);
    if (!triggered) onShortPress?.(e);
  };

  element.addEventListener('mousedown', start);
  element.addEventListener('touchstart', start);
  element.addEventListener('mouseup', cancel);
  element.addEventListener('mouseleave', cancel);
  element.addEventListener('touchend', cancel);
  return () => {
    element.removeEventListener('mousedown', start);
    element.removeEventListener('touchstart', start);
    element.removeEventListener('mouseup', cancel);
    element.removeEventListener('mouseleave', cancel);
    element.removeEventListener('touchend', cancel);
  };
}

// Uso: tecla "0" do controle mapeada via webOSTV.js
const key0 = document.getElementById('virtual-key-0');
createLongPressHandler(
  key0,
  () => console.log('short press: nada acontece'),
  () => console.log('long press: abre painel Quick Access'),
  3000 // 3 segundos como na LG
);

Esse padrão é o mesmo que você usaria para implementar atalhos em um dashboard de smart home, em uma interface de quiosque ou em uma webapp embarcada. O detalhe do triggered é o que evita o bug clássico de disparar o long press junto com o short press.

Indo além: integrando com Home Assistant ou automações

Se você já tem um setup de smart home, dá para transformar esse atalho em gatilho para cenas. Eu, por exemplo, configurei o número 5 para abrir o app da minha TV no Plex, e pelo Home Assistant criei uma automação que sincroniza a iluminação da sala (luzes Philips Hue no modo “Movie Night”) quando o Plex detecta playback. Não é a LG fazendo isso — é a integração via API do Plex + webhook no HA.

Para quem quiser explorar o lado dev do webOS, o SDK oficial é o webOS TV CLI, que permite instalar apps em modo debug, capturar logs via SSH e até simular o controle remoto. Para TVs de desenvolvimento, a LG vende o modelo Signage com firmware desbloqueado.

Erros Comuns que devs (e usuários) cometem

• Segurar o 0 esperando feedback imediato. Não tem som, não tem animação durante o hold. Você precisa esperar firme os três segundos — o que faz muita gente desistir achando que o controle travou.
• Tentar configurar com um app já aberto em primeiro plano. O painel só abre a partir da tela inicial ou do conteúdo de TV ao vivo. Se você está dentro de um streaming, o long press do 0 geralmente é ignorado.
• Assumir que funciona em qualquer marca. Não funciona. É exclusivo de LG com webOS a partir da linha 2020. Em Samsung, Roku ou Android TV você não vai encontrar nada parecido nativamente.
• Esquecer que o slot sobrescreve o canal. Se você atribuir o número 1 ao YouTube, pressionar e soltar o 1 rapidamente ainda tenta sintonizar o canal 1 — o atalho só funciona com long press.
• Configurar e nunca usar. Parece óbvio, mas no fim do dia a TV vira mais um eletrodoméstico e você esquece o atalho existe. Recomendo fixar no controle com uma etiqueta pequena.

Quando essa feature não vale a pena

Se você usa muito o controle por voz (Alexa, Google Assistente ou ThinQ da própria LG), o long press do 0 é redundante. Voz já é mais rápido que qualquer botão. Outra situação em que não ajuda: se você abre sempre o mesmo app e ele já é o último usado (a própria TV reabre no retorno). O ganho real aparece quando você alterna entre 4 ou 5 serviços diferentes no mesmo dia.

E vale reforçar o que o próprio Catracalivre lembra: “a função não altera os aplicativos nem acelera tecnicamente o processador da TV; ela apenas encurta o caminho necessário para abrir determinados conteúdos.” Não espere ganho de performance, é só UX.

FAQ — Perguntas que um dev faria

Funciona em TVs LG antigas?

Depende do firmware. A LG começou a introduzir o Quick Access no webOS 5.0 (linha 2020). Modelos de 2019 e anteriores podem não ter o recurso, mesmo sendo LG.

Posso atribuir um app que não está na LG Store?

Não pelo painel nativo. Apps sideload (Developer Mode) só aparecem em firmwares de dev. Para o usuário comum, só apps oficiais.

Quantos atalhos dá para configurar?

Em geral, 9 slots (números 1 a 9). Algumas versões mais recentes aceitam também letras, mas isso varia por região e firmware.

Tem como fazer o mesmo no celular que espelha a TV?

Não diretamente, mas com o app LG ThinQ você pode acionar atalhos remotamente. Para automações mais avançadas, integra via Home Assistant com a integração webostv.

Desenvolvedor consegue ler qual número foi acionado via SDK?

Sim. Pelo webOS TV SDK, eventos do tipo keydown no controle expõem o keyCode. Você consegue escutar 0, 1, etc., e tratar o long press do seu lado dentro da app.

No fim das contas, é um daqueles recursos escondidos que mostram como a integração entre hardware e software pode ser bem feita — e como a maioria dos usuários nunca descobre. Testei em três modelos diferentes da LG aqui no meu setup (uma OLED de 55″, uma NanoCell e uma mais antiga de 2021) e funcionou igual nas três. Se você tem uma LG em casa, vale gastar dois minutos configurando — depois é só músculo lembrar.

Gostou? Me segue no GitHub e deixa um comentário se tiver dúvida ou quiser aprofundar algum ponto. Se quiser ver mais conteúdo sobre desenvolvimento embarcado, webOS, ou smart home, é só pedir nos comentários que eu trago nos próximos posts.