HandyCafe Docs
it-admin

Acesso Remoto

O Acesso Remoto permite que administradores visualizem e controlem PCs clientes em tempo real diretamente pela interface do HandyCafe Server. É projetado para solução de problemas, monitoramento e assistência a clientes na sua lan house ou centro de jogos sem precisar caminhar fisicamente até a máquina.

Iniciando uma Sessão de Acesso Remoto

  1. No Painel de Administração, localize o cliente ao qual deseja conectar.
  2. Clique no cartão do cliente para revelar os botões de ação.
  3. Clique no botão Acesso Remoto.

O visualizador de acesso remoto abre em uma janela dedicada, exibindo a tela do cliente com controles interativos.

Tecnologia de Streaming

Codec H.264

As telas dos clientes são codificadas usando o codec de vídeo H.264, que fornece alta qualidade visual com baixa largura de banda. Quadros-chave usam codificação JPEG como fallback para garantir exibição inicial rápida e recuperação de perda de pacotes.

Transmissão de Quadros via UDP

Os quadros codificados são transmitidos por UDP para latência mínima. Cada quadro é dividido em blocos usando um protocolo estruturado com cabeçalho de 30 bytes contendo:

Campo do Cabeçalho Finalidade
Bytes mágicos Identificação do protocolo
Versão Versão do protocolo para compatibilidade
Tipo de quadro Indicador de quadro-chave vs. quadro delta
ID da sessão Identifica a sessão de acesso remoto
Número de sequência Ordena quadros para remontagem
Timestamp Momento da captura do quadro
Índice do bloco Posição deste bloco dentro do quadro
Contagem de blocos Número total de blocos no quadro

Essa abordagem de divisão em blocos permite que quadros grandes trafeguem pela rede de forma confiável mantendo pacotes UDP individuais dentro de limites seguros de MTU.

Controles Interativos

Retransmissão de Mouse e Teclado

Uma vez conectado, movimentos do mouse, cliques e entrada de teclado do operador do servidor são retransmitidos ao PC cliente. O cliente executa essas entradas como se fossem realizadas localmente, habilitando controle interativo completo.

Sincronização da Área de Transferência

A área de transferência é sincronizada entre o servidor e o cliente durante uma sessão ativa de acesso remoto. Texto copiado no lado do servidor pode ser colado no cliente e vice-versa.

Taxa de Bits e Qualidade

A taxa de bits do streaming é configurável entre 350 kbps e 25.000 kbps. Um mecanismo de auto-ajuste monitora as condições da rede e escala a taxa de bits dinamicamente para manter uma experiência de visualização suave:

  • Em redes rápidas e estáveis, a taxa de bits aumenta para maior nitidez de imagem.
  • Em redes congestionadas ou lentas, a taxa de bits diminui para prevenir perda de quadros e atraso.

Administradores também podem selecionar manualmente presets de streaming que equilibram qualidade, FPS e taxa de bits para diferentes casos de uso (por exemplo, monitoramento vs. controle ativo).

Configurações Ajustáveis

O visualizador de acesso remoto expõe diversas configurações:

  • Qualidade -- Nível de qualidade de imagem para quadros codificados.
  • FPS -- Quadros por segundo alvo para o streaming.
  • Taxa de bits -- Ajuste manual de taxa de bits ou modo automático.
  • Visibilidade do cursor -- Se o cursor remoto é exibido como sobreposição.
  • Presets de streaming -- Configurações predefinidas para cenários comuns.

Gravação de Sessão

Sessões de acesso remoto podem ser gravadas em arquivos MP4 para revisão posterior. A gravação usa um subprocesso FFmpeg que codifica o fluxo de quadros recebidos em um arquivo de vídeo padrão. As gravações são salvas no diretório config_dir/recordings/ com nomes de arquivo com data/hora.

Rastreamento de Perda de Pacotes

O visualizador exibe uma porcentagem de taxa de perda indicando quantos quadros ou blocos foram perdidos durante a transmissão. Taxas de perda altas sugerem congestionamento de rede e podem justificar a redução da taxa de bits ou investigação de problemas de rede.