HandyCafe Docs
owner it-admin

Cómo configurar el escritorio del cliente

Esta guía te lleva paso a paso por la construcción del menú de aplicaciones que los clientes ven en sus PCs, la aplicación de temas visuales, la configuración de la pantalla de espera y la publicación de anuncios. Cada cambio que hagas en el servidor se envía a los clientes conectados al instante por TCP.

Cómo construir el menú de aplicaciones

El menú de aplicaciones es con lo que los clientes interactúan durante su sesión. Está organizado en categorías, cada una con una o más aplicaciones. Administras todo el catálogo desde el servidor.

Lo que necesitarás

  • Servidor HandyCafe ejecutándose con al menos un cliente conectado.
  • Los ejecutables de las aplicaciones ya instalados en los PCs cliente (para los tipos Juego y Aplicación).
  • Imágenes de iconos (PNG, JPG o WebP) listas para subir. El tamaño recomendado es 128x128 píxeles.

Pasos

  1. Abre la aplicación del servidor HandyCafe y navega a Ajustes en la barra lateral izquierda.
  2. Selecciona la pestaña Clientes en la parte superior, luego cambia a la sub-pestaña Contenido.
  3. En el panel de Categorías a la izquierda, haz clic en el botón Agregar Categoría.
  4. Ingresa un nombre de categoría como "Juegos" o "Navegadores" y confirma. La nueva categoría aparece en la lista.
  5. Selecciona la categoría que acabas de crear. En el panel derecho, haz clic en Agregar Aplicación.
  6. Completa los detalles de la aplicación. Ingresa un Nombre (por ejemplo "Counter-Strike 2"), una Descripción opcional y establece el campo Tipo al valor apropiado: Juego, Navegador, Enlace, Archivo o Aplicación.
  7. En el campo Ruta del ejecutable, ingresa la ruta completa a la aplicación en el PC cliente. Por ejemplo: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Para el tipo Enlace, ingresa una URL en su lugar.
  8. Sube un icono haciendo clic en el área del icono. Puedes pegar una URL para obtener una imagen de la web o buscar un archivo local en tu máquina. El icono se muestra en la cuadrícula de aplicaciones del cliente.
  9. Opcionalmente sube una Imagen de Póster para una tarjeta visual más completa. Esta es la imagen grande que se muestra en los modos de visualización de póster. También puedes activar el interruptor del Carrusel Hero para destacar esta aplicación en el banner rotativo en la parte superior del escritorio del cliente.
  10. Arrastra los elementos en la lista de categorías o la lista de aplicaciones para reordenarlos. Alterna el interruptor de visibilidad junto a cualquier aplicación para ocultarla sin eliminarla. Haz clic en Guardar al terminar.

Resultado esperado

Todos los escritorios de clientes conectados se actualizan en segundos. La nueva categoría y aplicaciones aparecen en la cuadrícula de aplicaciones del cliente. Los clientes pueden lanzar aplicaciones haciendo clic en sus tarjetas.

Errores comunes

  • Ingresar una ruta que no existe en el PC cliente. La tarjeta de la aplicación aparecerá pero el lanzamiento fallará. Siempre verifica la ruta del ejecutable en una máquina cliente real.
  • Olvidar guardar después de hacer cambios. Las ediciones sin guardar no se envían a los clientes.
  • Usar imágenes demasiado grandes sin compresión. Aunque cualquier resolución funciona, las imágenes mayores a 512x512 ralentizan la sincronización sin beneficio visual al tamaño de tarjeta.

Cómo establecer el tema del escritorio

Los temas controlan el aspecto general del escritorio del cliente durante una sesión activa. Eliges un tema de color, un preset de disposición, densidad de tarjetas y ajustes de fondo.

Lo que necesitarás

  • Servidor HandyCafe ejecutándose.
  • Para fondos de imagen o video: archivos multimedia en formato PNG, JPG, WebP, MP4 o WebM.

Pasos

  1. Navega a Ajustes > Clientes > pestaña Apariencia.
  2. En Tema, selecciona uno de los temas de color disponibles: Neon Arena (estética azul-morada de gaming), Crimson Pulse (tonos rojo-oscuro) o Emerald Depth (paleta verde-turquesa). Una vista previa se actualiza a medida que haces selecciones.
  3. En Preset de Disposición, elige cómo se organiza el contenido en pantalla. Las opciones son Split Classic (categorías a la izquierda, aplicaciones a la derecha), Hero Wide Top (carrusel hero grande arriba, aplicaciones abajo), Catalog Wide Bottom (hero compacto, cuadrícula de aplicaciones más amplia) o Compact Focus (interfaz mínima, máximo espacio para aplicaciones).
  4. Establece la Densidad de Tarjetas para controlar cuántas aplicaciones caben en pantalla a la vez. Grande muestra tarjetas más grandes con más detalle. Mediana equilibra tamaño y cantidad. Compacta acomoda más aplicaciones por fila.
  5. Configura el Fondo. Selecciona el tipo: Sólido (elige un color), Gradiente (elige dos colores), Imagen (sube un archivo) o Video (sube un MP4/WebM). Para los tipos Imagen y Video, ajusta el control deslizante de Opacidad de Superposición para oscurecer el fondo detrás de las tarjetas y el control deslizante de Desenfoque para suavizarlo.
  6. Haz clic en Guardar. El tema se envía a todos los clientes conectados de inmediato.

Resultado esperado

Los escritorios de los clientes se refrescan con los nuevos ajustes visuales. El tema, la disposición, los tamaños de tarjeta y el fondo se actualizan sin necesidad de reiniciar los clientes.

Errores comunes

  • Usar un fondo de video con un tamaño de archivo muy grande. Mantén los videos por debajo de 20 MB para una sincronización rápida. Los videos más largos o de mayor resolución causan tiempos de carga notables en los PCs cliente.
  • Establecer la opacidad de superposición demasiado baja en una imagen de fondo con muchos detalles. El texto y las etiquetas de las tarjetas se vuelven difíciles de leer. Una superposición del 40-60% funciona bien para la mayoría de las imágenes.

Cómo configurar la pantalla de espera

La pantalla de espera es lo que los clientes ven cuando un PC no está en uso. Puede mostrar una presentación de imágenes o videos, un reloj y el nombre de tu café.

Lo que necesitarás

  • Archivos de imagen (PNG, JPG, WebP o GIF) o archivos de video (MP4, WebM) para la presentación.
  • Servidor HandyCafe ejecutándose.

Pasos

  1. Navega a Ajustes > Clientes > pestaña Pantalla de Espera.
  2. Activa Habilitar Presentación.
  3. Haz clic en Agregar Multimedia para subir imágenes o videos. Puedes agregar múltiples elementos. Los formatos soportados son PNG, JPG, WebP, GIF, MP4 y WebM.
  4. Establece la Duración para cada elemento en segundos. Esto controla cuánto tiempo permanece visible cada diapositiva antes de la transición. Un valor entre 8 y 15 segundos funciona bien para la mayoría de las configuraciones.
  5. Elige un efecto de Transición: Desvanecimiento (transición suave de opacidad), Deslizamiento (deslizamiento horizontal) o Zoom (efecto de acercamiento).
  6. Activa el interruptor de Reloj Superpuesto para mostrar un reloj digital en la pantalla de espera. Usa el selector de color para establecer el color del texto del reloj para máximo contraste con el contenido de tu presentación.
  7. Activa el interruptor de Nombre del Café para mostrar el nombre de tu negocio en la pantalla de espera. El nombre se toma de los ajustes generales de tu servidor.
  8. Haz clic en Guardar. La configuración de la pantalla de espera se envía a todos los clientes conectados.

Resultado esperado

Los PCs cliente que no están en una sesión activa muestran la presentación con las transiciones, el reloj superpuesto y el nombre del café configurados. La presentación se repite continuamente.

Errores comunes

  • Agregar demasiadas imágenes de alta resolución sin considerar el tiempo de sincronización. Cada archivo multimedia debe transferirse a cada cliente. Mantén el tamaño total de la presentación razonable.
  • Establecer la duración demasiado corta (menos de 3 segundos). Las transiciones rápidas pueden resultar molestas y dificultar la lectura de cualquier texto en las diapositivas.
  • No probar el color del reloj contra todas las imágenes de la presentación. Un reloj blanco es invisible sobre una diapositiva blanca brillante. Elige un color que funcione en todo tu conjunto de diapositivas.

Cómo crear un anuncio

Los anuncios aparecen en los escritorios de los clientes y pueden promocionar eventos, compartir noticias o mostrar publicidad. El sistema rastrea impresiones y clics automáticamente.

Lo que necesitarás

  • Servidor HandyCafe ejecutándose con al menos un cliente conectado.
  • Una imagen de banner (recomendado 1200x400 píxeles o más ancha) si deseas un anuncio visual.

Pasos

  1. Navega a Ajustes > Clientes > pestaña Contenido.
  2. Desplázate hasta la sección de Anuncios debajo de las categorías de aplicaciones.
  3. Haz clic en Agregar Anuncio.
  4. Ingresa un Título y un Texto para el anuncio. Si enlazas a una página externa, ingresa la URL del Enlace.
  5. Establece el campo Tipo. Elige Anuncio para noticias generales, Evento para promociones por tiempo limitado con campos de formulario interactivos o Texto para mensajes de solo texto.
  6. Establece la Categoría para clasificar el anuncio: Enlace, Juego, Anuncio o Publicidad. Esto determina dónde aparece en la disposición del cliente.
  7. Sube una Imagen de Banner haciendo clic en el área de imagen y seleccionando un archivo. El banner se muestra en la barra de anuncios del escritorio del cliente. Haz clic en Guardar.

Resultado esperado

El anuncio aparece en los escritorios de los clientes conectados en la barra de anuncios. A medida que los clientes lo ven e interactúan con él, el servidor rastrea el Conteo de Impresiones (cuántas veces se mostró) y el Conteo de Clics (cuántas veces un cliente hizo clic en él).

Errores comunes

  • Crear anuncios sin una imagen de banner. Los anuncios de solo texto sin imagen son fáciles de pasar por alto para los clientes en la barra de anuncios.
  • Olvidar establecer una fecha de vencimiento o eliminar anuncios desactualizados. Las promociones antiguas dejadas activas crean una mala experiencia para el cliente.
  • Usar texto muy largo en el cuerpo del anuncio. El área de visualización es compacta. Mantén el texto conciso y coloca los detalles detrás del enlace.