Come Configurare il Desktop Client

Questa guida ti accompagna nella creazione del menu app che i clienti vedono sui loro PC, nell'applicazione dei temi visivi, nella configurazione della schermata di inattivita e nella pubblicazione degli annunci. Ogni modifica che apporti sul server viene inviata ai client connessi in tempo reale tramite TCP.

Come Costruire il Menu App

Il menu app e l'interfaccia con cui i clienti interagiscono durante la sessione. E organizzato in categorie, ciascuna contenente una o piu app. Gestisci l'intero catalogo dal server.

Cosa ti servira

HandyCafe Server in esecuzione con almeno un client connesso.
I file eseguibili delle app gia installati sui PC client (per le tipologie Game e App).
Immagini icona (PNG, JPG o WebP) pronte per il caricamento. La dimensione consigliata e 128x128 pixel.

Passaggi

Apri l'applicazione HandyCafe Server e vai su Impostazioni nella barra laterale sinistra.
Seleziona la scheda Client in alto, poi passa alla sotto-scheda Contenuto.
Nel pannello Categorie a sinistra, clicca il pulsante Aggiungi Categoria.
Inserisci un nome per la categoria, ad esempio "Giochi" o "Browser", e conferma. La nuova categoria compare nell'elenco.
Seleziona la categoria appena creata. Nel pannello di destra, clicca Aggiungi App.
Compila i dettagli dell'app. Inserisci un Nome (ad esempio "Counter-Strike 2"), una Descrizione opzionale e imposta il campo Tipo sulla tipologia appropriata: Game, Browser, Link, File o App.
Nel campo Percorso Eseguibile, inserisci il percorso completo dell'applicazione sul PC client. Ad esempio: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Per il tipo Link, inserisci invece un URL.
Carica un'icona cliccando sull'area icona. Puoi incollare un URL per recuperare un'immagine dal web o sfogliare un file locale. L'icona viene visualizzata nella griglia delle app sul client.
Facoltativamente, carica una Immagine Poster per una scheda visivamente piu ricca. Questa e la grafica grande mostrata nelle modalita di visualizzazione con il poster in primo piano. Puoi anche attivare l'opzione Hero Carousel per mettere in evidenza questa app nel banner rotante in cima al desktop client.
Trascina gli elementi nell'elenco delle categorie o delle app per riordinarli. Attiva o disattiva la visibilita di qualsiasi app senza eliminarla. Clicca Salva quando hai finito.

Risultato atteso

Tutti i desktop client connessi si aggiornano in pochi secondi. La nuova categoria e le app compaiono nella griglia delle app del client. I clienti possono avviare le app cliccando sulle relative schede.

Errori comuni

Inserire un percorso che non esiste sul PC client. La scheda dell'app apparira ma l'avvio fallira. Verifica sempre il percorso eseguibile su un client reale.
Dimenticare di salvare dopo aver apportato modifiche. Le modifiche non salvate non vengono inviate ai client.
Usare immagini di grandi dimensioni senza compressione. Sebbene qualsiasi risoluzione funzioni, le immagini piu grandi di 512x512 rallentano la sincronizzazione senza alcun beneficio visivo alle dimensioni della scheda.

Come Impostare il Tema del Desktop

I temi controllano l'aspetto generale del desktop client durante una sessione attiva. Puoi scegliere un tema colore, una configurazione del layout, la densita delle schede e le impostazioni dello sfondo.

Cosa ti servira

HandyCafe Server in esecuzione.
Per sfondi con immagini o video: file multimediali in formato PNG, JPG, WebP, MP4 o WebM.

Passaggi

Vai su Impostazioni > Client > Aspetto.
Nella sezione Tema, seleziona uno dei temi colore disponibili: Neon Arena (estetica gaming blu-viola), Crimson Pulse (toni rosso scuro) o Emerald Depth (palette verde-turchese). L'anteprima si aggiorna man mano che effettui le selezioni.
Nella sezione Configurazione Layout, scegli come disporre il contenuto sullo schermo. Le opzioni sono: Split Classic (categorie a sinistra, app a destra), Hero Wide Top (grande carosello hero in alto, app in basso), Catalog Wide Bottom (hero compatto, griglia app piu ampia) o Compact Focus (interfaccia minimale, massimo spazio per le app).
Imposta la Densita Schede per controllare quante app entrano sullo schermo contemporaneamente. Grande mostra schede piu grandi con piu dettagli. Media bilancia dimensione e quantita. Compatta mostra il maggior numero di app per riga.
Configura lo Sfondo. Seleziona il tipo: Solido (scegli un colore), Gradiente (scegli due colori), Immagine (carica un file) o Video (carica un MP4/WebM). Per i tipi Immagine e Video, regola il cursore Opacita Overlay per scurire lo sfondo dietro le schede e il cursore Sfocatura per ammorbidirlo.
Clicca Salva. Il tema viene inviato immediatamente a tutti i client connessi.

Risultato atteso

I desktop client si aggiornano con le nuove impostazioni visive. Tema, layout, dimensioni delle schede e sfondo si aggiornano senza che i client debbano essere riavviati.

Errori comuni

Usare uno sfondo video con file di dimensioni molto grandi. Mantieni i video sotto i 20 MB per una sincronizzazione veloce. Video piu lunghi o ad alta risoluzione causano tempi di caricamento notevoli sui PC client.
Impostare un'opacita overlay troppo bassa su uno sfondo con immagini complesse. Il testo e le etichette delle schede diventano difficili da leggere. Un overlay del 40-60% funziona bene per la maggior parte delle immagini.

Come Configurare la Schermata di Inattivita

La schermata di inattivita e cio che i clienti vedono quando un PC non e in uso. Puo mostrare una presentazione di immagini o video, un orologio e il nome del tuo locale.

Cosa ti servira

File immagine (PNG, JPG, WebP o GIF) o file video (MP4, WebM) per la presentazione.
HandyCafe Server in esecuzione.

Passaggi

Vai su Impostazioni > Client > Schermata di Inattivita.
Attiva l'opzione Abilita Presentazione.
Clicca Aggiungi Media per caricare immagini o video. Puoi aggiungere piu elementi. I formati supportati sono PNG, JPG, WebP, GIF, MP4 e WebM.
Imposta la Durata per ogni elemento in secondi. Questo controlla quanto a lungo ogni diapositiva rimane visibile prima della transizione. Un valore tra 8 e 15 secondi funziona bene per la maggior parte delle configurazioni.
Scegli un effetto di Transizione: Dissolvenza (crossfade opacita fluido), Scorrimento (scorrimento orizzontale) o Zoom (effetto zoom in entrata).
Attiva l'opzione Overlay Orologio per mostrare un orologio digitale sulla schermata di inattivita. Usa il selettore colore per impostare il colore del testo dell'orologio, garantendo il massimo contrasto con il contenuto della presentazione.
Attiva l'opzione Nome Locale per mostrare il nome della tua attivita sulla schermata di inattivita. Il nome viene ripreso dalle impostazioni generali del server.
Clicca Salva. La configurazione della schermata di inattivita viene inviata a tutti i client connessi.

Risultato atteso

I PC client che non sono in una sessione attiva mostrano la presentazione con le transizioni configurate, l'overlay dell'orologio e il nome del locale. La presentazione si ripete continuamente.

Errori comuni

Aggiungere troppe immagini ad alta risoluzione senza considerare i tempi di sincronizzazione. Ogni file multimediale deve essere trasferito su ogni client. Mantieni le dimensioni totali della presentazione ragionevoli.
Impostare una durata troppo breve (meno di 3 secondi). Le transizioni rapide possono risultare fastidiose e rendere difficile leggere qualsiasi testo nelle diapositive.
Non testare il colore dell'orologio su tutte le immagini della presentazione. Un orologio bianco e invisibile su una diapositiva bianca. Scegli un colore che funzioni su tutta la serie di diapositive.

Come Creare un Annuncio

Gli annunci appaiono sui desktop client e possono promuovere eventi, condividere notizie o visualizzare pubblicita. Il sistema traccia automaticamente le visualizzazioni e i clic.

Cosa ti servira

HandyCafe Server in esecuzione con almeno un client connesso.
Un'immagine banner (consigliata 1200x400 pixel o piu larga) se vuoi un annuncio visivo.

Passaggi

Vai su Impostazioni > Client > Contenuto.
Scorri fino alla sezione Annunci sotto le categorie delle app.
Clicca Aggiungi Annuncio.
Inserisci un Titolo e un Testo per l'annuncio. Se vuoi collegare una pagina esterna, inserisci l'URL nel campo Link.
Imposta il campo Tipo. Scegli Annuncio per notizie generali, Evento per promozioni a tempo limitato con campi modulo interattivi, o Testo per messaggi solo testuali.
Imposta la Categoria per classificare l'annuncio: Link, Game, Annuncio o Pubblicita. Questo determina dove appare nel layout del client.
Carica un'Immagine Banner cliccando sull'area immagine e selezionando un file. Il banner viene visualizzato nella barra degli annunci sul desktop client. Clicca Salva.

Risultato atteso

L'annuncio appare nella barra degli annunci dei desktop client connessi. Man mano che i clienti lo visualizzano e interagiscono con esso, il server traccia il Conteggio Visualizzazioni (quante volte e stato mostrato) e il Conteggio Clic (quante volte un cliente ci ha cliccato).

Errori comuni

Creare annunci senza un'immagine banner. Gli annunci solo testuali senza immagine vengono facilmente ignorati dai clienti nella barra degli annunci.
Dimenticare di impostare una scadenza o rimuovere gli annunci obsoleti. Le promozioni vecchie ancora attive creano una cattiva esperienza per i clienti.
Usare testi troppo lunghi nel corpo dell'annuncio. Lo spazio di visualizzazione e compatto. Mantieni il testo conciso e rimanda i dettagli al link.