Clientes Legados

O HandyCafe pode gerenciar instalações de clientes V3 e V4 junto com clientes modernos no mesmo servidor. Os clientes legados aparecem no Painel Administrativo como um tipo próprio de cartão, com um conjunto reduzido de ações que corresponde ao que o protocolo original suporta.

Antes de você ver clientes legados no Painel Administrativo, habilite o suporte em tempo de execução em Configurações > Clientes Legados.

Como os clientes legados aparecem

Os clientes legados se conectam ao servidor pelo protocolo multicast UDP original. Eles não usam mDNS como os clientes modernos. Em vez disso, o servidor os descobre de duas formas:

O estado por MAC fica armazenado em um repositório de clientes legados com IP, hostname, usuário conectado, versão do cliente, cronômetros de sessão e um carimbo de última visibilidade. Cada quadro recebido zera o temporizador de inatividade. Se o temporizador estourar sem tráfego (padrão de 10 segundos), o cliente é marcado como offline. O registro permanece no banco para que o histórico não seja perdido.

O cartão de cliente legado

Cada cliente legado aparece como um cartão diferente dos cartões modernos. O cabeçalho mostra o nome de exibição (hostname quando disponível, MAC quando não), um selo online ou offline colorido e um rótulo de status.

Cores e rótulos de status

Relógio da sessão

Quando uma sessão está ativa, o cartão exibe um bloco de relógio:

• Hora de início.
• Hora de término (para sessões com tempo limitado).
• Minutos usados.
• Minutos restantes com contagem regressiva ao vivo.
• Custo acumulado.

Informações de identidade

O cartão sempre mostra:

• Endereço MAC.
• Endereço IP.
• Versão do cliente (por exemplo, "3.4.01").
• Usuário conectado, se houver.

Barra de ações

Quando o cliente está online, uma barra de ações abaixo das informações de identidade oferece as operações disponíveis.

Controle de sessão

Adicionar tempo

Abre um seletor de minutos. Aceita valores positivos (estender) ou negativos (reduzir). A magnitude máxima é de 10.000 minutos em qualquer direção. Funciona tanto para sessões pré-pagas quanto pós-pagas.

Se você configurou valores fixos de minutos nas configurações de preço, o cartão também mostra uma linha de botões predefinidos. Toque em um preset para aplicar o valor sem abrir o seletor.

Captura de tela

Solicita uma captura de tela ao vivo do cliente legado pela porta de transferência de arquivos. O fluxo é o seguinte:

1. O servidor envia um comando de solicitação de captura.
2. O cliente abre um listener TCP de vida curta em uma porta efêmera.
3. O servidor conecta, envia um cabeçalho de transferência de arquivos de 9 bytes e aguarda.
4. O cliente captura a tela, codifica em um BMP compactado e envia de volta.
5. O servidor descompacta o BMP e o armazena na pasta legacy_screenshots dentro do seu diretório de dados do HandyCafe.
6. O visualizador de capturas é aberto com a nova imagem.

Se o cliente não responder dentro do tempo limite (padrão de 30 segundos para conectar, 20 segundos para os dados), a solicitação falha e uma notificação de erro aparece. Você pode tentar novamente imediatamente.

Ações de energia

Reiniciar e Desligar exibem uma janela de confirmação para evitar ações acidentais.

Operações não suportadas

Os clientes legados não suportam todos os recursos disponíveis nos clientes modernos do HandyCafe. Principais lacunas:

• Sem ajuste de pausa no meio da sessão. Alterações de tempo enviadas enquanto a sessão está pausada ficam enfileiradas, mas o cliente pode ignorá-las. Retome a sessão primeiro, aplique a alteração e pause novamente se necessário.
• Sem modo Admin por comando do servidor. O estado interno de admin do cliente não pode ser alternado pelo servidor. O modo admin é controlado apenas na máquina cliente.
• Sem registro de licença pelo servidor. O servidor espelha os bytes de licença que encontra nos quadros do cliente, mas não consegue enviar uma nova licença para o cliente. Registre o cliente localmente.
• Sem integração de carteira de membro para sessões iniciadas em clientes legados. Os pagamentos são gravados como linhas simples de transactions com transaction_type=sessions e o MAC do cliente. Os fluxos modernos de carteira não se aplicam.
• Sem área de trabalho remota. O recurso de área de trabalho remota usa um caminho de streaming UDP que não existe nos clientes legados.
• Sem push de sincronização de arquivos. O Explorador de Sincronização envia arquivos apenas pelo protocolo moderno.

Quando possível, migre para clientes modernos do HandyCafe para ter a funcionalidade completa.

Comportamento offline

Quando o tempo limite de inatividade expira, o cartão fica mais escuro, o selo de status fica cinza e todos os botões de ação são desabilitados. O registro do cliente permanece no armazenamento para que histórico, MAC, hostname e dados de última visibilidade sejam preservados. Quando o cliente volta a ficar online (novo ping UDP ou login TCP), o cartão volta a funcionar e as ações ficam disponíveis novamente.

O registro não é removido automaticamente. Para apagar um cliente antigo de forma permanente, edite-o no banco administrativo ou exclua-o pela ferramenta administrativa adequada.

Dicas

• Mantenha o tempo limite de inatividade em 10 segundos, a menos que você saiba que seus clientes legados anunciam beacons mais devagar que isso. Um tempo limite menor pode marcar clientes saudáveis como offline durante pequenos soluços de rede.
• Se um cliente legado aparece online, mas não responde a comandos, confirme a Variação de Protocolo em Configurações. Uma divergência entre a variante do servidor (STE vs Standard) e a compilação do cliente faz os comandos serem ignorados silenciosamente.
• Capturas de tela de clientes legados são BMPs compactados, que ocupam mais espaço que as capturas PNG modernas. Mantenha a pasta legacy_screenshots em uma unidade com bastante espaço livre se você tirar muitas capturas.
• Use Adicionar Tempo com botões predefinidos durante transições de turno. Um único toque estende a sessão por um incremento predefinido, o que é mais rápido do que digitar minutos manualmente.
• Aposente clientes legados aos poucos. Migre um lote por vez, confirme que os clientes novos funcionam da mesma forma no Painel Administrativo e só então desative os antigos.