HandyCafe Docs
owner it-admin

Como configurar el escritorio del cliente

Esta guia te lleva paso a paso por la construccion del menu de aplicaciones que los clientes ven en sus PCs, la aplicacion de temas visuales, la configuracion de la pantalla de espera y la publicacion de anuncios. Cada cambio que hagas en el servidor se envia a los clientes conectados al instante por TCP.

Como construir el menu de aplicaciones

El menu de aplicaciones es con lo que los clientes interactuan durante su sesion. Esta organizado en categorias, cada una con una o mas aplicaciones. Administras todo el catalogo desde el servidor.

Lo que necesitaras

  • Servidor HandyCafe ejecutandose con al menos un cliente conectado.
  • Los ejecutables de las aplicaciones ya instalados en los PCs cliente (para los tipos Juego y Aplicacion).
  • Imagenes de iconos (PNG, JPG o WebP) listas para subir. El tamano recomendado es 128x128 pixeles.

Pasos

  1. Abre la aplicacion del servidor HandyCafe y navega a Ajustes en la barra lateral izquierda.
  2. Selecciona la pestana Clientes en la parte superior, luego cambia a la sub-pestana Contenido.
  3. En el panel de Categorias a la izquierda, haz clic en el boton Agregar Categoria.
  4. Ingresa un nombre de categoria como "Juegos" o "Navegadores" y confirma. La nueva categoria aparece en la lista.
  5. Selecciona la categoria que acabas de crear. En el panel derecho, haz clic en Agregar Aplicacion.
  6. Completa los detalles de la aplicacion. Ingresa un Nombre (por ejemplo "Counter-Strike 2"), una Descripcion opcional y establece el campo Tipo al valor apropiado: Juego, Navegador, Enlace, Archivo o Aplicacion.
  7. En el campo Ruta del ejecutable, ingresa la ruta completa a la aplicacion 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 area del icono. Puedes pegar una URL para obtener una imagen de la web o buscar un archivo local en tu maquina. El icono se muestra en la cuadricula de aplicaciones del cliente.
  9. Opcionalmente sube una Imagen de Poster para una tarjeta visual mas completa. Esta es la imagen grande que se muestra en los modos de visualizacion de poster. Tambien puedes activar el interruptor del Carrusel Hero para destacar esta aplicacion en el banner rotativo en la parte superior del escritorio del cliente.
  10. Arrastra los elementos en la lista de categorias o la lista de aplicaciones para reordenarlos. Alterna el interruptor de visibilidad junto a cualquier aplicacion para ocultarla sin eliminarla. Haz clic en Guardar al terminar.

Resultado esperado

Todos los escritorios de clientes conectados se actualizan en segundos. La nueva categoria y aplicaciones aparecen en la cuadricula 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 aplicacion aparecera pero el lanzamiento fallara. Siempre verifica la ruta del ejecutable en una maquina cliente real.
  • Olvidar guardar despues de hacer cambios. Las ediciones sin guardar no se envian a los clientes.
  • Usar imagenes demasiado grandes sin compresion. Aunque cualquier resolucion funciona, las imagenes mayores a 512x512 ralentizan la sincronizacion sin beneficio visual al tamano de tarjeta.

Como establecer el tema del escritorio

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

Lo que necesitaras

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

Pasos

  1. Navega a Ajustes > Clientes > pestana Apariencia.
  2. En Tema, selecciona uno de los temas de color disponibles: Neon Arena (estetica 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 Disposicion, elige como se organiza el contenido en pantalla. Las opciones son Split Classic (categorias a la izquierda, aplicaciones a la derecha), Hero Wide Top (carrusel hero grande arriba, aplicaciones abajo), Catalog Wide Bottom (hero compacto, cuadricula de aplicaciones mas amplia) o Compact Focus (interfaz minima, maximo espacio para aplicaciones).
  4. Establece la Densidad de Tarjetas para controlar cuantas aplicaciones caben en pantalla a la vez. Grande muestra tarjetas mas grandes con mas detalle. Mediana equilibra tamano y cantidad. Compacta acomoda mas aplicaciones por fila.
  5. Configura el Fondo. Selecciona el tipo: Solido (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 Superposicion para oscurecer el fondo detras de las tarjetas y el control deslizante de Desenfoque para suavizarlo.
  6. Haz clic en Guardar. El tema se envia a todos los clientes conectados de inmediato.

Resultado esperado

Los escritorios de los clientes se refrescan con los nuevos ajustes visuales. El tema, la disposicion, los tamanos de tarjeta y el fondo se actualizan sin necesidad de reiniciar los clientes.

Errores comunes

  • Usar un fondo de video con un tamano de archivo muy grande. Manten los videos por debajo de 20 MB para una sincronizacion rapida. Los videos mas largos o de mayor resolucion causan tiempos de carga notables en los PCs cliente.
  • Establecer la opacidad de superposicion demasiado baja en una imagen de fondo con muchos detalles. El texto y las etiquetas de las tarjetas se vuelven dificiles de leer. Una superposicion del 40-60% funciona bien para la mayoria de las imagenes.

Como configurar la pantalla de espera

La pantalla de espera es lo que los clientes ven cuando un PC no esta en uso. Puede mostrar una presentacion de imagenes o videos, un reloj y el nombre de tu cafe.

Lo que necesitaras

  • Archivos de imagen (PNG, JPG, WebP o GIF) o archivos de video (MP4, WebM) para la presentacion.
  • Servidor HandyCafe ejecutandose.

Pasos

  1. Navega a Ajustes > Clientes > pestana Pantalla de Espera.
  2. Activa Habilitar Presentacion.
  3. Haz clic en Agregar Multimedia para subir imagenes o videos. Puedes agregar multiples elementos. Los formatos soportados son PNG, JPG, WebP, GIF, MP4 y WebM.
  4. Establece la Duracion para cada elemento en segundos. Esto controla cuanto tiempo permanece visible cada diapositiva antes de la transicion. Un valor entre 8 y 15 segundos funciona bien para la mayoria de las configuraciones.
  5. Elige un efecto de Transicion: Desvanecimiento (transicion 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 maximo contraste con el contenido de tu presentacion.
  7. Activa el interruptor de Nombre del Cafe 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 configuracion de la pantalla de espera se envia a todos los clientes conectados.

Resultado esperado

Los PCs cliente que no estan en una sesion activa muestran la presentacion con las transiciones, el reloj superpuesto y el nombre del cafe configurados. La presentacion se repite continuamente.

Errores comunes

  • Agregar demasiadas imagenes de alta resolucion sin considerar el tiempo de sincronizacion. Cada archivo multimedia debe transferirse a cada cliente. Manten el tamano total de la presentacion razonable.
  • Establecer la duracion demasiado corta (menos de 3 segundos). Las transiciones rapidas pueden resultar molestas y dificultar la lectura de cualquier texto en las diapositivas.
  • No probar el color del reloj contra todas las imagenes de la presentacion. Un reloj blanco es invisible sobre una diapositiva blanca brillante. Elige un color que funcione en todo tu conjunto de diapositivas.

Como 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 automaticamente.

Lo que necesitaras

  • Servidor HandyCafe ejecutandose con al menos un cliente conectado.
  • Una imagen de banner (recomendado 1200x400 pixeles o mas ancha) si deseas un anuncio visual.

Pasos

  1. Navega a Ajustes > Clientes > pestana Contenido.
  2. Desplazate hasta la seccion de Anuncios debajo de las categorias de aplicaciones.
  3. Haz clic en Agregar Anuncio.
  4. Ingresa un Titulo y un Texto para el anuncio. Si enlazas a una pagina 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 Categoria para clasificar el anuncio: Enlace, Juego, Anuncio o Publicidad. Esto determina donde aparece en la disposicion del cliente.
  7. Sube una Imagen de Banner haciendo clic en el area 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 interactuan con el, el servidor rastrea el Conteo de Impresiones (cuantas veces se mostro) y el Conteo de Clics (cuantas veces un cliente hizo clic en el).

Errores comunes

  • Crear anuncios sin una imagen de banner. Los anuncios de solo texto sin imagen son faciles 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 area de visualizacion es compacta. Manten el texto conciso y coloca los detalles detras del enlace.