Manuale Utente SoftPlayer

Estrarre SoftPlayer sulla macchina di destinazione e verificare che l'ambiente soddisfi i requisiti.

1. Verificare che la macchina di destinazione sia Windows 10/11 x64.
2. Estrarre il pacchetto SoftPlayer in una directory permanente, ad es. C:\SoftPlayer\.
3. Verificare che la directory contenga SoftPlayer.exe, appsettings.json e la struttura della sottodirectory SoftPlayerMedia\.
4. Per la riproduzione di video 8K, assicurarsi che la macchina abbia una GPU che supporti la decodifica hardware (GTX 1060+ o equivalente); 4K e inferiore funzionano con grafica integrata.

• SoftPlayer.exe è visibile nella directory estratta.
• La directory SoftPlayerMedia\ è pre-creata con sottodirectory: Video, StandBy, Audio, PPT, ecc.

• Posizionare SoftPlayer in un percorso stabile — i file media, i log e lo stato della licenza sono tutti salvati relativamente alla directory del programma.
• Si raccomanda storage SSD con velocità di lettura 200MB/s+ per una riproduzione più fluida ad alta risoluzione.

Confermare che il programma si avvii correttamente e completare l'onboarding del primo avvio.

1. Fare doppio clic su SoftPlayer.exe per avviarlo (non sono richiesti diritti di amministratore).
2. Al primo avvio, il programma apre la guida di avvio rapido nel browser predefinito (solo al primo avvio; gli avvii successivi saltano questa fase).
3. Dopo aver letto la guida, visitare http://localhost:8766/ in un browser per aprire la console di gestione.
4. Nella scheda Dashboard, confermare che lo stato del player è normale e che le informazioni su versione e licenza sono visibili.

• Il browser apre con successo la console di gestione (http://localhost:8766/) e mostra il Dashboard.
• Il numero di versione e lo stato della licenza sono visibili nell'intestazione della console.

Per disabilitare la guida del primo avvio, impostare System.ShowQuickStartOnFirstRun su false in appsettings.json.

Controllare con successo il player tramite UDP e confermare che il canale di controllo funzioni.

1. Posizionare un file video (ad es. test.mp4) nella directory SoftPlayerMedia\Video\.
2. Aprire PowerShell ed eseguire i seguenti comandi:
3. $udp = New-Object System.Net.Sockets.UdpClient
4. $data = [System.Text.Encoding]::UTF8.GetBytes("video:test.mp4")
5. $udp.Send($data, $data.Length, "127.0.0.1", 7600)
6. $udp.Close()
7. Osservare se la finestra di SoftPlayer inizia a riprodurre il video specificato.

• La finestra di SoftPlayer inizia a riprodurre il file video specificato.
• La scheda Log della console di gestione mostra che il comando è stato ricevuto.

• File video posizionato nella directory sbagliata (deve essere in SoftPlayerMedia\Video\, non nella radice del programma).
• Porta errata (il default è 7600, non la porta della console di gestione 8766).

Padroneggiare il formato dei comandi e comprendere le risposte di successo e fallimento.

1. Formato comando: comando:argomento, ad es. video:show.mp4 o volume:80.
2. I comandi senza argomento possono essere inviati semplicemente come nome del comando (i due punti sono opzionali), ad es. play.
3. Formato risposta successo: OK:comando-originale, ad es. OK:video:show.mp4.
4. Formato risposta fallimento: ERR:comando-originale:messaggio-errore.
5. Per i percorsi dei file media, è necessario solo il nome del file — il player cerca automaticamente nella sottodirectory corrispondente: video: cerca in SoftPlayerMedia/Video/.

• Una risposta con prefisso OK dopo l'invio di un comando conferma il formato corretto e l'esecuzione.
• Una risposta ERR include una ragione specifica (file non trovato, errore di formato, ecc.).

Per specificare una sottodirectory, usare una barra: video:sottocartella/video.mp4 cerca in SoftPlayerMedia/Video/sottocartella/.

Padroneggiare tutti i comandi relativi alla riproduzione video.

1. Riprodurre un video locale: video:nomefile.mp4 (cerca nella directory Video).
2. Riprodurre uno stream video di rete: webvideo:URL (supporta stream HTTP/HTTPS/RTSP/RTMP/UDP).
3. Riprodurre/Riprendere: play: (riprende i media in pausa).
4. Pausa: pause: (mette in pausa i media correnti).
5. Stop e ritorno in standby: stop: (ritorna alla schermata di benvenuto / loop standby).
6. Stop completo / schermo nero: stoped: (schermo nero risparmio energia).
7. Riprodurre di nuovo i media correnti: replay:.
8. Controllo avanzamento: seek:millisecondi (salta alla posizione), forward: (salta 10s avanti), backward: (salta 10s indietro).
9. Velocità di riproduzione: speed:1.5 (supporta 1.5x, 2.0x, ecc.).

• Dopo il comando video:, il player inizia a riprodurre il file specificato.
• Dopo il comando stop:, ritorna alla schermata standby (se il file standby è configurato).

• Per standby a lungo termine nelle esposizioni, usare standby: per loopare un file standby piuttosto che stoped: schermo nero (lo schermo nero potrebbe far pensare ai visitatori che il dispositivo sia guasto).
• stop e stoped hanno semantiche diverse: stop ritorna alla schermata di benvenuto; stoped mostra uno schermo completamente nero.

Padroneggiare i comandi di regolazione volume e controllo riproduzione audio.

1. Impostare il volume (0-100): volume:80 (imposta al valore esatto).
2. Aumentare il volume del 10%: volup: (aumenta del 10% per chiamata).
3. Diminuire il volume del 10%: voldown: (diminuisce del 10% per chiamata).
4. Attivare/disattivare muto: mute: (alternare tra muto e non muto).
5. Attivare esplicitamente muto: muteon:.
6. Disattivare esplicitamente muto: muteoff:.
7. Riprodurre un file audio: audio:nomefile.mp3 (cerca in SoftPlayerMedia/Audio/).
8. Fermare l'audio: audiostoped:.

• Dopo volume:50, il volume del player scende al 50%.
• mute: alterna tra suono e silenzio.

Padroneggiare i comandi per loop list, paginazione PPT e caricamento web.

1. Loopare una playlist: listloop:file1.mp4;file2.mp4;file3.mp4 (separare i file con punti e virgola).
2. Riproduzione sequenziale (stop alla fine): liststop:nomefile.
3. Traccia successiva: next:, Traccia precedente: prev:.
4. Aprire PPT a schermo intero: ppt:nomefile.pptx (cerca in SoftPlayerMedia/PPT/).
5. Navigazione PPT: ppt:next (diapositiva successiva), ppt:prev (precedente), ppt:home (prima), ppt:end (ultima).
6. Saltare alla diapositiva: ppt:goto-5 (salta alla pagina 5).
7. Avanzamento automatico PPT: ppt:auto-5-nomefile.pptx (avanza automaticamente ogni 5 secondi).
8. Caricare una pagina web: web:URL (visualizza l'URL specificato a schermo intero).

• Dopo il comando listloop:, il player scorre ciclicamente i file elencati.
• ppt:next avanza il PPT alla diapositiva successiva.

• I file PPT devono essere posizionati in SoftPlayerMedia/PPT/ prima di inviare i comandi.
• Per i file PDF, il comando ricade su una finestra visualizzatore con paginazione simulata tramite pressione tasti.
• Usare listloop per gli scenari di loop espositivi piuttosto che inviare manualmente comandi individuali.

Comprendere i comandi maschera e a livello di sistema.

1. Mostrare overlay maschera: openmask: (sovrappone un livello maschera al video).
2. Nascondere overlay maschera: closemask:.
3. Impostare il comportamento fine riproduzione: endbehavior:Stop / Loop / Standby.
4. Ottenere la versione: version: (la risposta include le informazioni sulla versione corrente).
5. Riavviare il player: restart: (riavvia remotamente il processo del player).

• Dopo openmask:, un overlay maschera appare sul video.
• Dopo version:, viene ricevuta una risposta con le informazioni sulla versione.

Conoscere la posizione corretta per ogni tipo di file media.

1. SoftPlayerMedia/Video/ — File video (.mp4/.mkv/.avi ecc.), usati dal comando video:.
2. SoftPlayerMedia/StandBy/ — File standby, usati dal comando standby: e loop default.
3. SoftPlayerMedia/Audio/ — File audio (.mp3/.wav/.flac ecc.), usati dal comando audio:.
4. SoftPlayerMedia/BackgroundAudio/ — Audio di sottofondo, si ripete automaticamente quando abilitato.
5. SoftPlayerMedia/PPT/ — File PPT/PDF, usati dal comando ppt:.
6. SoftPlayerMedia/Mask/ — Immagini maschera, usate dal comando openmask:.
7. SoftPlayerMedia/Thumbnail/ — Directory cache thumbnail (auto-generata, nessun file manuale necessario).

• Dopo aver posizionato un video in Video/, il comando video:nomefile lo riproduce correttamente.
• La struttura delle directory viene creata automaticamente al primo avvio — nessuna configurazione manuale necessaria.

Gestire i file media quotidianamente tramite la console di gestione browser.

1. Aprire http://ip-player:8766/ in un browser per accedere alla console di gestione.
2. Fare clic sulla navigazione superiore per passare alla scheda File.
3. Selezionare la directory di destinazione (Video / StandBy / Audio / PPT, ecc.).
4. Fare clic su Carica per selezionare i file, o trascinare i file nell'area di caricamento.
5. Supporta la creazione di cartelle, rinomina, eliminazione di file/cartelle e download di file.
6. I file supportano fino a 3 livelli di sottodirectory; selezionare la directory corrente durante il caricamento.

• Il file appena caricato appare nell'elenco file dopo il caricamento.
• Il comando video:nomefile riproduce con successo il file appena caricato.

• La console usa Basic Auth — configurare username/password in appsettings.json.
• Il limite default di caricamento singolo file è 500MB, configurabile nel file di configurazione.
• Il personale di manutenzione in loco può caricare contenuti sostitutivi tramite la console senza RDP.

Comprendere le regole della prova e pianificare adeguatamente i tempi della licenza.

1. La prova di 30 giorni si avvia automaticamente al primo avvio di SoftPlayer.
2. Tutte le funzionalità sono disponibili durante la prova, inclusa la riproduzione ad alta risoluzione e tutti i comandi UDP.
3. Controllare i giorni di prova rimanenti nella scheda Dashboard della console di gestione.
4. Dopo la prova, è necessario importare un codice licenza per continuare l'utilizzo.

• Il Dashboard della console di gestione mostra lo stato della prova corrente e i giorni rimanenti.
• I comandi rispondono normalmente durante la prova senza restrizioni di funzionalità.

• Usare il periodo di prova per completare i test e l'accettazione prima della consegna formale del progetto.
• Acquistare la licenza prima della scadenza della prova per evitare interruzioni all'esposizione.

Scegliere il livello di licenza corretto in base alle esigenze di risoluzione effettiva dell'esposizione.

1. Licenza Standard: supporta fino a risoluzione 4K (3840×2160).
2. Licenza Professional: supporta fino a risoluzione 16K (15360×8640).
3. Requisiti hardware 4K: Intel i3+, 8GB RAM, grafica integrata (nessuna GPU discreta necessaria).
4. Requisiti hardware 8K: Intel i5 8a gen+, 16GB RAM, GTX 1060+.
5. Requisiti hardware 16K: Intel i7+, 32GB RAM, RTX 3070+.
6. Se non si è sicuri del livello necessario, usare la prova per verificare i requisiti di risoluzione effettivi prima dell'acquisto.

• Il livello di licenza corrisponde alla risoluzione massima del dispositivo di visualizzazione nel progetto.
• La configurazione hardware del server soddisfa i requisiti minimi per la risoluzione target.

I computer senza GPU discreta possono riprodurre 4K e inferiore (il programma ricade automaticamente sulla decodifica software), ma 8K/16K richiede una GPU discreta idonea.

Importare il codice licenza per passare dalla prova alla versione completa.

1. Trovare il campo ID Dispositivo nel Dashboard della console di gestione e copiarlo.
2. Fornire l'ID dispositivo al fornitore, specificando il livello richiesto (Standard/Professional).
3. Dopo aver ricevuto il codice licenza, andare alla scheda Configurazione nella console e trovare la sezione Gestione Licenze.
4. Incollare il codice licenza nel campo di input e fare clic su Importa Licenza.
5. Dopo un'importazione riuscita, lo stato della licenza nel Dashboard cambia da Prova a Standard o Professional.

• Il Dashboard della console di gestione mostra lo stato della versione completa (Standard o Professional).
• La riproduzione video ad alta risoluzione non è più limitata.

• Applicare un codice licenza al dispositivo sbagliato (i codici sono legati al dispositivo; una nuova macchina richiede un nuovo codice).
• Attendere fino alla scadenza della prova per richiedere una licenza, causando interruzioni all'esposizione.

Ripristinare il canale di controllo comandi UDP.

1. Confermare che SoftPlayer sia in esecuzione (visibile nella barra delle applicazioni o in Task Manager).
2. Verificare che la porta nel comando corrisponda all'impostazione UdpPort in appsettings.json (default 7600).
3. Controllare se il Firewall di Windows consente il traffico UDP in entrata sulla porta 7600.
4. Se la whitelist IP è abilitata (IpWhitelistEnabled: true), confermare che l'IP del mittente sia in AllowedIps.
5. Controllare la scheda Log della console di gestione per i record di ricezione comandi per confermare se i comandi raggiungono il player.

• I log della console di gestione mostrano record di ricezione comandi, confermando che il canale UDP funziona.
• L'invio di volume:50 cambia il volume del player.

• Testare prima con 127.0.0.1 (localhost) per escludere problemi di rete prima di usare l'IP effettivo.
• Quando si inviano comandi da SoftControl, assicurarsi che il protocollo UDP e la porta di SoftControl corrispondano alla configurazione di SoftPlayer.

Diagnosticare e risolvere i fallimenti di riproduzione dei file media.

1. Confermare che il file video sia in SoftPlayerMedia\Video\ (non nella directory radice del programma).
2. I nomi file sono case-sensitive — confermare che il nome nel comando corrisponda esattamente al nome file effettivo inclusa l'estensione.
3. Per file in sottodirectory, includere il percorso relativo: video:sottocartella/video.mp4.
4. Navigare alla scheda File nella console di gestione per confermare che il file esiste effettivamente.
5. Per formati di file insoliti, controllare i log della console di gestione per i messaggi di errore VLC.
6. Provare ad aprire lo stesso file direttamente con VLC Player sulla macchina per escludere corruzione del file.

• Il file di destinazione è visibile nell'elenco file della console di gestione.
• Il nome file nel comando corrisponde esattamente a ciò che viene mostrato nell'elenco file.

• Il nome file nel comando contiene spazi a larghezza intera o caratteri speciali, causando file non trovato.
• Mancata corrispondenza case dell'estensione file (ad es. il comando usa .MP4 ma il file è effettivamente .mp4).

Risolvere i problemi di prestazioni nella riproduzione di video ad alta risoluzione.

1. Confermare prima il livello di licenza corrente: Standard supporta solo 4K; Professional supporta 16K.
2. Controllare se la GPU supporta la decodifica hardware (GTX 1060+ o equivalente necessario per 8K).
3. Nella scheda Prestazioni di Task Manager, controllare l'utilizzo della decodifica GPU — vicino al 100% indica un collo di bottiglia della GPU.
4. Controllare i requisiti di velocità di lettura disco: 4K necessita 25-50 Mbps, 8K necessita 80-100 Mbps, 16K necessita 200+ Mbps.
5. Conservare i file video ad alta risoluzione su un SSD per evitare colli di bottiglia di lettura HDD.
6. Per la regolazione dei parametri VLC, vedere la documentazione integrata (docs\User Manual.html) nella directory del programma.

• Il livello di licenza corrisponde alla risoluzione di riproduzione richiesta.
• La configurazione hardware soddisfa i requisiti minimi per la risoluzione target.

Ripristinare l'accesso alla console di gestione browser.

1. Confermare che SoftPlayer sia in esecuzione.
2. Provare prima http://localhost:8766/ localmente per escludere problemi di rete.
3. Controllare appsettings.json per confermare che HttpMonitor.Enabled sia true e la porta sia 8766.
4. Controllare se il Firewall di Windows consente il traffico TCP sulla porta 8766.
5. Se la porta è occupata da un altro programma, modificare HttpMonitor.Port in appsettings.json e riavviare.

• Il browser riesce ad accedere a http://localhost:8766/ e visualizza la console di gestione.
• Il Dashboard della console di gestione mostra lo stato di runtime del player.