HandyCafe Docs
owner it-admin

Como configurar a área de trabalho do cliente

Este guia orienta você na criação do menu de aplicativos que os clientes veem em seus PCs, na aplicação de temas visuais, na configuração da tela inativa e na publicação de anúncios. Cada alteração feita no servidor é enviada instantaneamente aos clientes conectados por TCP.


Como construir o menu do aplicativo

O menu do aplicativo é com o qual os clientes interagem durante a sessão. Está organizado em categorias, cada uma contendo um ou mais aplicativos. Você gerencia todo o catálogo do servidor.

O que você vai precisar

  • HandyCafe Server rodando com pelo menos um cliente conectado.
  • Executáveis ​​de aplicativos já instalados nos PCs clientes (para jogos e aplicativos).
  • Imagens de ícones (PNG, JPG ou WebP) prontas para upload. O tamanho recomendado é 128x128 pixels.

Passos

  1. Abra o aplicativo HandyCafe Server e navegue até Configurações na barra lateral esquerda.
  2. Selecione a guia Clientes na parte superior e alterne para a subguia Conteúdo.
  3. No painel Categorias à esquerda, clique no botão Adicionar categoria.
  4. Insira um nome de categoria como “Jogos” ou “Navegadores” e confirme. A nova categoria aparece na lista.
  5. Selecione a categoria que você acabou de criar. No painel direito, clique em Adicionar aplicativo.
  6. Preencha os detalhes do aplicativo. Insira um Nome (por exemplo, "Counter-Strike 2"), uma Descrição opcional e defina o campo Tipo para o tipo apropriado: Jogo, Navegador, Link, Arquivo ou Aplicativo.
  7. No campo Caminho Executável, insira o caminho completo para o aplicativo no PC cliente. Por exemplo: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Para Tipo de link, insira um URL.
  8. Carregue um ícone clicando na área do ícone. Você pode colar um URL para buscar uma imagem da web ou procurar um arquivo local em sua máquina. O ícone é exibido na grade do aplicativo cliente.
  9. Opcionalmente, carregue uma Imagem de pôster para obter um cartão visual mais rico. Esta é a grande obra de arte mostrada nos modos de exibição do primeiro pôster. Você também pode ativar o botão Hero Carousel para apresentar este aplicativo no banner giratório na parte superior da área de trabalho do cliente.
  10. Arraste itens na lista de categorias ou na lista de aplicativos para reordená-los. Alterne o botão de visibilidade ao lado de qualquer aplicativo para ocultá-lo sem excluí-lo. Clique em Salvar quando terminar.

Resultado esperado

Todos os desktops clientes conectados são atualizados em segundos. A nova categoria e os novos aplicativos aparecem na grade de aplicativos cliente. Os clientes podem iniciar aplicativos clicando em seus cartões.

Erros comuns

  • Inserir um caminho que não existe no PC cliente. O cartão do aplicativo aparecerá, mas a inicialização falhará. Sempre verifique o caminho do executável em uma máquina cliente real.
  • Esquecer de salvar após fazer alterações. As edições não salvas não são enviadas aos clientes.
  • Usando imagens superdimensionadas sem compressão. Embora qualquer resolução funcione, imagens maiores que 512x512 tornam a sincronização mais lenta, sem nenhum benefício visual no tamanho do cartão.

Como definir o tema da área de trabalho

Os temas controlam a aparência geral da área de trabalho do cliente durante uma sessão ativa. Você escolhe um tema de cores, uma predefinição de layout, densidade do cartão e configurações de plano de fundo.

O que você vai precisar

  • Servidor HandyCafe em execução.
  • Para fundos de imagem ou vídeo: arquivos de mídia nos formatos PNG, JPG, WebP, MP4 ou WebM.

Passos

  1. Navegue até a guia Configurações > Clientes > Aparência.
  2. Em Tema, selecione um dos temas de cores disponíveis: Neon Arena (estética de jogo azul-roxo), Crimson Pulse (tons vermelho-escuros) ou Emerald Depth (paleta verde-azulado). Uma visualização é atualizada conforme você faz seleções.
  3. Em Layout Preset, escolha como o conteúdo é organizado na tela. As opções são Split Classic (categorias à esquerda, aplicativos à direita), Hero Wide Top (grande carrossel de heróis na parte superior, aplicativos abaixo), Catalog Wide Bottom (herói compacto, grade de aplicativos mais ampla) ou Compact Focus (cromo mínimo, espaço máximo de aplicativos).
  4. Defina Densidade do cartão para controlar quantos aplicativos cabem na tela ao mesmo tempo. Grande mostra cartões maiores com mais detalhes. Médio equilibra tamanho e quantidade. Compacto cabe no maior número de aplicativos por linha.
  5. Configure o Plano de fundo. Selecione o tipo: Sólido (escolha uma cor), Gradiente (escolha duas cores), Imagem (carregue um arquivo) ou Vídeo (carregue um MP4/WebM). Para tipos de imagem e vídeo, ajuste o controle deslizante Opacidade da sobreposição para escurecer o fundo atrás dos cartões e o controle deslizante Desfoque para suavizá-lo.
  6. Clique em Salvar. O tema é enviado para todos os clientes conectados imediatamente.

Resultado esperado

As áreas de trabalho dos clientes são atualizadas com as novas configurações visuais. O tema, o layout, os tamanhos dos cartões e o plano de fundo são atualizados sem exigir a reinicialização dos clientes.

Erros comuns

  • Usar um fundo de vídeo com um tamanho de arquivo muito grande. Mantenha os vídeos com menos de 20 MB para sincronização rápida. Vídeos mais longos ou de resolução mais alta causam tempos de carregamento perceptíveis em PCs clientes.
  • Definir a opacidade da sobreposição muito baixa em uma imagem de fundo ocupada. Etiquetas de texto e cartões tornam-se difíceis de ler. Uma sobreposição de 40-60% funciona bem para a maioria das imagens.

Como configurar a tela inativa

A tela inativa é o que os clientes veem quando um PC não está em uso. Ele pode exibir uma apresentação de slides de imagens ou vídeos, um relógio e o nome do seu café.

O que você vai precisar

  • Arquivos de imagem (PNG, JPG, WebP ou GIF) ou arquivos de vídeo (MP4, WebM) para apresentação de slides.
  • Servidor HandyCafe em execução.

Passos

  1. Navegue até a guia Configurações > Clientes > Tela ociosa.
  2. Ative Ativar apresentação de slides.
  3. Clique em Adicionar mídia para fazer upload de imagens ou vídeos. Você pode adicionar vários itens. Os formatos suportados são PNG, JPG, WebP, GIF, MP4 e WebM.
  4. Defina a Duração para cada item em segundos. Isso controla quanto tempo cada slide permanece visível antes da transição. Um valor entre 8 e 15 segundos funciona bem para a maioria das configurações.
  5. Escolha um efeito de Transição: Fade (crossfade de opacidade suave), Slide (slide horizontal) ou Zoom (efeito de aumento de escala).
  6. Ative o botão Sobreposição de relógio para exibir um relógio digital na tela inativa. Use o seletor de cores para definir a cor do texto do relógio para obter contraste máximo com o conteúdo da apresentação de slides.
  7. Ative o botão Nome do café para mostrar o nome da sua empresa na tela inicial. O nome é extraído das configurações gerais do servidor.
  8. Clique em Salvar. A configuração da tela inativa é enviada para todos os clientes conectados.

Resultado esperado

Os PCs clientes que não estão em uma sessão ativa exibem a apresentação de slides com as transições configuradas, a sobreposição do relógio e o nome do café. A apresentação de slides é repetida continuamente.

Erros comuns

  • Adicionar muitas imagens de alta resolução sem considerar o tempo de sincronização. Cada arquivo de mídia deve ser transferido para cada cliente. Mantenha o tamanho total da apresentação de slides razoável.
  • Definir a duração muito curta (menos de 3 segundos). Transições rápidas podem parecer chocantes e dificultar a leitura de qualquer texto nos slides.
  • Não testar a cor do relógio em todas as imagens da apresentação de slides. Um relógio branco é invisível em um slide branco brilhante. Escolha uma cor que funcione em todo o conjunto da apresentação de slides.

Como criar um anúncio

Os anúncios aparecem nos desktops dos clientes e podem promover eventos, compartilhar notícias ou exibir anúncios. O sistema rastreia impressões e cliques automaticamente.

O que você vai precisar

  • HandyCafe Server rodando com pelo menos um cliente conectado.
  • Uma imagem de banner (recomendado 1200x400 pixels ou maior) se você quiser um anúncio visual.

Passos

  1. Navegue até a guia Configurações > Clientes > Conteúdo.
  2. Role até a seção Anúncios abaixo das categorias de aplicativos.
  3. Clique em Adicionar anúncio.
  4. Insira um Título e um Texto para o anúncio. Se estiver vinculando a uma página externa, insira o URL do Link.
  5. Defina o campo Tipo. Escolha Anúncio para notícias gerais, Evento para promoções por tempo limitado com campos de formulário interativos ou Texto para mensagens simples somente de texto.
  6. Defina a Categoria para classificar o anúncio: Link, Jogo, Anúncio ou Anúncio. Isso determina onde ele aparece no layout do cliente.
  7. Carregue uma Imagem de Banner clicando na área da imagem e selecionando um arquivo. O banner é exibido na barra de anúncios na área de trabalho do cliente. Clique em Salvar.

Resultado esperado

O anúncio aparece nos desktops de clientes conectados na barra de anúncios. À medida que os clientes visualizam e interagem com ele, o servidor rastreia a Contagem de impressões (quantas vezes o item foi exibido) e a Contagem de cliques (quantas vezes um cliente clicou nele).

Erros comuns

  • Criação de anúncios sem imagem de banner. Anúncios somente de texto sem imagem são fáceis de serem ignorados pelos clientes na barra de anúncios.
  • Esquecer de definir um prazo de validade ou remover anúncios desatualizados. Promoções antigas deixadas ativas criam uma experiência ruim para o cliente.
  • Usar texto muito longo no corpo do anúncio. A área de exibição é compacta. Mantenha o texto conciso e coloque detalhes atrás do link.