Instalar o Kiosk NFC num tablet

O Kiosk NFC é o ecrã de check-in à porta da academia. O aluno encosta a pulseira ou cartão NFC ao leitor e a presença fica registada - sem login, sem app, em segundos. Aparece logo na vista ao vivo de quem está no tatame.

Não confundir com o Balcão: o kiosk é o terminal automático de entrada (toca-e-entra); o balcão é o posto de atendimento onde um operador cobra, vende e inscreve. Este guia é do kiosk.

Para a lista de compras com links, ver Hardware recomendado.

Como funciona, em resumo

A Orira corre numa página web de kiosk no teu domínio.
Abres essa página no tablet e ela mostra um código de ativação em grande (com QR ao lado). Tu, admin, confirmas esse código no telemóvel e o tablet liga-se sozinho - é o emparelhamento, como quando se liga uma smart TV. Não escreves nada no tablet.
Quando alguém passa o cartão, o leitor NFC lê o número de série (UID) do cartão e "escreve-o" no ecrã como se fosse teclado - a página apanha-o e faz o check-in.
O ecrã responde por cores: verde (em dia, presença registada), amarelo (pode treinar mas tem pagamento em atraso) e vermelho (bloqueado por atraso de pagamento ou sem inscrição válida).

O detalhe técnico que mais importa: o leitor tem de funcionar em modo emulação de teclado (USB HID) - ou seja, ao ler um cartão digita o UID seguido de Enter, como se fosse um teclado. A maioria dos leitores USB baratos faz exatamente isto e é plug-and-play no Android, sem driver. Os leitores do tipo PC/SC (ex.: ACR122U) não servem para este modo simples. Como confirmar: secção "Ativar o tablet" mais abaixo.

Alternativa sem leitor USB: no Chrome em Android, a página de kiosk também consegue ler pelo NFC do próprio tablet (Web NFC). Funciona, mas é menos cómodo (o aluno tem de encostar à traseira do tablet) e exige um tablet com NFC. O leitor USB externo é a montagem recomendada.

Material necessário

Tablet (ex.: Samsung Galaxy Tab A9) - mostra o ecrã do kiosk.
Leitor NFC USB em emulação de teclado (HID) - lê o cartão e digita o UID.
Adaptador OTG com carga (USB-C) - liga o leitor e carrega o tablet ao mesmo tempo.
Tags NFC (pulseiras ou cartões) - uma por aluno.
Suporte de tablet (opcional) - para fixar o tablet à parede ou balcão.

Modelos concretos e links em Hardware recomendado.

Atenção à frequência: o leitor lê uma frequência (tipicamente 13,56 MHz / NFC, alguns também 125 kHz). As tags têm de ser da mesma frequência do leitor, senão não são lidas. Quase tudo o que é "NFC moderno" é 13,56 MHz (NTAG213/215/216, MIFARE).

Montagem física

Liga o adaptador OTG-com-carga à porta USB-C do tablet.
Liga o carregador à entrada de carga do adaptador (um kiosk fica ligado o dia todo, por isso deve estar sempre na corrente).
Liga o leitor NFC USB à porta USB-A do adaptador.
Coloca o tablet no suporte, virado para quem entra, com o leitor ao alcance da mão.

Preparar o tablet Android (uma vez)

Liga o tablet ao Wi-Fi da academia - estável, porque o kiosk precisa de internet.
Define brilho confortável e bloqueia a rotação (portrait ou landscape, conforme o suporte).

Modo quiosque com Fully Kiosk Browser (recomendado)

O Fully Kiosk Browser é a forma mais robusta de fixar o tablet na página da Orira - impede que alguém saia por engano, mantém o ecrã sempre ligado e reinicia automaticamente ao ligar a corrente.

Instala o Fully Kiosk Browser a partir da Play Store (gratuito; versão PLUS opcional mas não necessária para a Orira).
Abre o Fully Kiosk e, na primeira janela, define a URL de arranque: cola o link de ativação desse kiosk (secção Kiosk NFC da Configuração → bloco "Ativação manual (link/QR, avançado)"). Como o token vai no próprio link, o tablet volta a ativar-se sozinho mesmo depois de uma reinstalação ou limpeza de dados - que é onde a configuração por emparelhamento se perderia e obrigaria a repetir o código.
Em Definições → Modo Quiosque, ativa "Ativar Modo Quiosque" - o ecrã fica fixo na URL definida; a barra de navegação e o botão de saída desaparecem.
Em Definições → Modo Quiosque, ativa também "Manter ecrã ligado"

enquanto o tablet estiver na corrente o ecrã nunca apaga.

Em Definições → Outras Definições, ativa "Iniciar ao ligar" - o Fully Kiosk abre sozinho se o tablet reiniciar.
Para sair do modo quiosque (para manutenção): faz um toque longo no ecrã durante 3 segundos → aparece uma janela a pedir o PIN de administrador (defines tu em Definições → Modo Quiosque → PIN).

O leitor NFC (USB HID) funciona exatamente da mesma forma dentro do Fully Kiosk: ao passar o cartão, "digita" o UID no campo da página - não é preciso nenhuma configuração adicional.

Alternativa simples: fixar o ecrã (Android nativo)

Se não quiseres instalar nenhuma app, o Android tem fixação de ecrã integrada:

Abre o Chrome com a página do kiosk já ativa.
Vai a Definições → Segurança → Fixar ecrã (ou Afixar ecrã - o nome varia por fabricante) e ativa a opção.
Abre o seletor de apps recentes e carrega no ícone do Chrome → Afixar.
Para sair: mantém premidos os botões Recentes + Voltar em simultâneo.

É menos robusto que o Fully Kiosk (não reinicia sozinho, não mantém o ecrã ligado) mas serve para uma montagem simples.

Alternativa: iPad

O leitor NFC USB HID também funciona num iPad com porta USB-C através de um adaptador USB-C para USB-A (o mesmo OTG + carga que usas no Android serve, desde que seja compatível com iPadOS).

Modo quiosque no iPad - Acesso Guiado:

O iPadOS tem o Acesso Guiado incorporado, que bloqueia o dispositivo numa só app sem precisar de nenhuma app externa.

Vai a Definições → Acessibilidade → Acesso Guiado e ativa-o.
Define um Código (é o PIN que usas para sair do modo quiosque).
Abre o Safari ou Chrome com a página de kiosk do teu domínio e confirma no telemóvel o código que aparece (igual ao Android).
Faz triplo clique no botão lateral (ou no botão Home, nos iPads mais antigos) para iniciar o Acesso Guiado → carrega em Iniciar.
O iPad fica bloqueado nessa app. Para sair: triplo clique → introduz o código → Terminar.

Ecrã sempre ligado no iPad:

Vai a Definições → Ecrã e Brilho → Bloqueio automático e define para Nunca (só fica disponível se o iPad estiver a carregar; caso contrário o iOS não permite "Nunca").

Nota: o Web NFC (leitura NFC pelo browser sem leitor externo) não é suportado no Safari nem no Chrome para iOS. O leitor USB HID externo é a única opção no iPad.

Criar o kiosk no painel (admin)

No teu PC, entra como admin e vai a Configuração, secção Kiosk NFC.
No separador de kiosks, carrega no botão para criar um kiosk:

Nome (ex.: "Entrada", "Tatame Principal").
Modalidade (opcional) - se preencheres, este kiosk só aceita check-ins dessa modalidade; deixa vazio para aceitar qualquer aula a decorrer.
Minutos antes / depois - janela em que o check-in é aceite à volta da hora da aula (por omissão 30 antes e 60 depois).

Guarda. O cartão do kiosk passa a mostrar nome, estado, modalidade e janela. O token não fica à vista - é deliberado: a Orira pensa em sessões de equipamento, não em tokens que se copiam. Se precisares mesmo dele, está dentro do bloco "Ativação manual (link/QR, avançado)", que abres nesse cartão.

Ativar o tablet (uma vez)

Há três formas de ligar o tablet a este kiosk. Em qualquer delas o acesso fica guardado no próprio tablet, por isso só fazes isto uma vez por tablet.

Recomendada: emparelhar (código + QR)

É o caminho normal, e não precisa de copiar nada.

No tablet, abre no Chrome a página de kiosk do teu domínio (`/kiosk`).
O ecrã mostra um código de ativação em grande, um QR ao lado e "À espera de confirmação…".
No telemóvel, lê o QR (ou abre Equipamentos → "Tenho um código de ativação"), escolhe a que kiosk queres ligar este ecrã e confirma.
O tablet liga-se sozinho em segundos. Se ainda não tiveres nenhum kiosk criado, o próprio ecrã de confirmação deixa-te criar um e ligar num só passo.

O mesmo ecrã serve para a TV do tatame (`/tatame`) e para o PC do balcão (`/recepcao`) - muda só o que confirmas no telemóvel.

Alternativa: link de ativação (URL de arranque)

Dentro do bloco "Ativação manual (link/QR, avançado)" de cada kiosk há um link de ativação com QR. Abrir esse link no tablet ativa-o de imediato, sem emparelhamento.

Vale a pena num caso concreto: como URL de arranque do Fully Kiosk (ver adiante). O token viaja no link, por isso o tablet volta a ativar-se sozinho mesmo depois de uma reinstalação ou limpeza de dados.

Último recurso: colar o token

No ecrã de emparelhamento, em baixo, há um link discreto "Preferes colar o token manualmente?". Abre um campo onde colas o token copiado do bloco de ativação manual. Serve para quando o tablet não consegue ler QR nem abrir links.

A seguir, confirma que o leitor e os cartões respondem:

Testa o leitor (verificar se é emulação de teclado): abre uma app de notas, toca num campo de texto e encosta um cartão ao leitor.

Se aparecerem números/letras no campo, o leitor é do tipo certo (HID).
Se não aparecer nada, o leitor é provavelmente PC/SC (precisa de app): usa o modo Web NFC do Chrome Android ou troca de leitor.

Volta à página de kiosk e passa um cartão já atribuído a um aluno (ver secção seguinte). Deve aparecer o ecrã verde com o nome.

Adiciona a página de kiosk ao ecrã inicial do tablet para abrir com um toque.

Comprar as tags NFC

Há duas formas de ter tags. A recomendada é encomendá-las à Orira.

Opção A (recomendada): encomendar tags personalizadas à Orira

No Orira Hub, no menu de ações do painel, abre Encomendar tags NFC.

Personalizas a tag (texto e cores, com pré-visualização 3D).
Escolhes o pack: 20, 50 ou 100 tags. O pack maior não traz unidades extra - o que muda é o preço por tag (mais barata a partir do pack de 50). Ao total soma-se o porte de envio, conforme o país de entrega.
Confirmas a morada de entrega e o email de fatura (já vêm preenchidos com os dados da academia).
A Orira valida, produz, expede e fatura à academia.

Esta é a via mais simples: recebes tags já com a imagem da tua academia, prontas a atribuir. A partir da secção Kiosk NFC da Configuração há também um atalho que te leva direto a esta página.

Opção B (alternativa): comprar tags genéricas

Se preferires, podes comprar um lote de tags NFC em branco de 13,56 MHz (NTAG215/216 ou MIFARE) em qualquer loja. Não há nada a "gravar": a Orira usa o número de série de fábrica de cada tag. Detalhes em Hardware recomendado.

Atribuir uma tag a um aluno

Independentemente de onde compraste as tags, atribuis cada uma a um aluno no painel:

Entra como admin em Configuração, secção Kiosk NFC, separador de atletas (ou, no Balcão, na ação Tags NFC).
Procura o aluno por nome ou email.
No campo NFC, encosta a tag ao leitor (ou escreve o UID) e guarda.
Se a tag já estiver atribuída a outra pessoa, a app avisa (conflito) e pergunta se queres reatribuir - útil quando um aluno perde a pulseira e lhe dás outra.

Privacidade: o UID nunca é guardado em texto simples - a Orira guarda um hash com um segredo do servidor. Mesmo que a base de dados fosse comprometida, ninguém consegue clonar cartões a partir dela. Por isso, na lista, só vês os últimos dígitos como "impressão digital".

Quando o aluno pede uma 2ª via (pulseira nova)

O aluno vai ao seu Perfil, cartão Tag NFC, e carrega no botão para pedir 2ª via.
Escolhe método de pagamento (MB WAY, IBAN ou numerário) e anexa comprovativo (ou nota de entrega, se numerário).
É criado um pagamento do tipo taxa de tag NFC (valor configurável em Configuração) a aguardar validação, e tu recebes email.
Validas o pagamento e atribuis uma nova tag ao aluno.

O valor da taxa e os dados de pagamento (IBAN/MB WAY do chefe da academia) configuram-se na Configuração da academia.

Operação no dia-a-dia

Logs: na secção Kiosk NFC da Configuração, o separador de logs mostra cada passagem de cartão (entradas, avisos de pagamento, bloqueios, "cartão não reconhecido"). Atualiza sozinho enquanto vês o dia de hoje.
Vista ao vivo: abre a vista do tatame noutro ecrã ou TV para ver quem está presente em tempo real (avatar, graduação, peso, idade).
Vários kiosks: podes ter mais do que um (ex.: um por sala), cada um com a sua ativação e, se quiseres, fixado a uma modalidade.
Equipamentos ligados: Equipamentos lista os dispositivos ligados à academia (balcão, kiosks e TV do tatame), com o último acesso de cada um. Podes renomear e, se um tablet se perder ou saíres de uma sala, usar Terminar sessão: todos os dispositivos ligados a esse kiosk perdem o acesso de imediato e voltam a pedir código. A configuração mantém-se, por isso religas quando quiseres - é aqui que se corta o acesso, não há "regenerar token".

Resolução de problemas

O ecrã volta a pedir código - a cache foi limpa, ou alguém usou Terminar sessão em Equipamentos. Emparelha outra vez (confirma o código no telemóvel). Se usares o link de ativação como URL de arranque do Fully Kiosk, isto deixa de acontecer.
"Kiosk não autorizado" - o acesso guardado no tablet já não corresponde a nenhum kiosk ativo (a sessão foi terminada, ou o kiosk foi recriado). No próprio ecrã de erro há um botão "Reconfigurar kiosk" que limpa o acesso e volta ao ecrã de ativação, sem reinstalar a app - a seguir emparelha de novo.
Passo o cartão e não acontece nada - o leitor não é HID (é PC/SC) ou o cabo/adaptador está mal ligado. Testa numa app de notas; troca de adaptador ou leitor.
"Cartão não reconhecido" - a tag não está atribuída a ninguém. Atribui na secção Kiosk NFC da Configuração, separador de atletas.
Cartão lido mas dá vermelho - sem inscrição ativa, atraso de pagamento, ou fora da janela de horário. Verifica inscrição, pagamentos e a hora da aula.
O tablet desliga o ecrã - poupança de energia. Mantém o ecrã ligado ao carregar e o tempo limite no máximo.
O tablet "sai" da página - falta o modo quiosque. Instala o Fully Kiosk Browser ou ativa a fixação de ecrã nativa do Android (ver secção "Preparar o tablet Android").
A tag nova não é lida - frequência diferente do leitor. Usa tags de 13,56 MHz (NFC).