← Download Logo

Manuale d'Uso & Specifiche

Documentazione tecnica rigorosa di jwMeetingLive.Timer

⏱️

Cronometro & Profili Congregazione

Gestione del tempo e persistenza dei dati operativi

Il cronometro principale è il nucleo di controllo dell'applicazione. È concepito per l'operatore posizionato in cabina audio-video e permette di coordinare tutte le parti dell'adunanza con precisione al secondo.

🖥️ Visualizzazione Adattiva (Normale / Docked)

L'applicazione si adatta in tempo reale alle esigenze dello schermo della cabina regia con due modalità di visualizzazione:

  • Modalità Normale (NORM): Layout standard a tutto schermo o finestra ampia. Mostra tutti i pannelli affiancati (Timer, Programma e Impostazioni), ideale quando si dispone di un secondo monitor dedicato o per la configurazione iniziale.
  • Modalità Docked (DOCK - Finestra Laterale): Trasforma l'applicazione in una barra verticale salvaspazio ancorata sul lato destro dello schermo. Questa modalità consente all'operatore di gestire il timer mantenendo contemporaneamente aperti e visibili altri programmi sullo stesso monitor (es. JW Library, Zoom o lettori multimediali).
  • Come cambiare modalità: È possibile alternare istantaneamente tra le due modalità facendo clic sul pulsante del layout nell'header principale (in alto a destra) oppure premendo la scorciatoia da tastiera F11.

🔄 Meccanismo di Auto-Aggiornamento

Il programma integra un sistema di aggiornamento automatico silenzioso (*Auto-Update*):

  • Ad ogni avvio dell'applicazione viene eseguito un controllo in background sul server statico.
  • In caso di nuova versione disponibile, l'aggiornamento viene scaricato e applicato automaticamente in pochi secondi al riavvio dell'app.
  • Il processo non richiede l'inserimento di privilegi di amministratore di Windows, semplificando la manutenzione tecnica del PC della sala.

👥 Gestione Profili Congregazione

Per le sale del Regno utilizzate da più congregazioni, l'applicazione supporta profili differenziati:

  • Dati Separati: Ciascuna congregazione ha un file di preferenze dedicato.
  • Personalizzazione: Ogni profilo conserva le proprie impostazioni relative a: lingua, default layout, configurazione dello schermo secondario, attivazione o disattivazione dell'algoritmo di recupero ritardo, e suono di allarme prescelto.
  • Cambio Rapido: L'operatore può commutare il profilo attivo in tempo reale dal menu laterale inferiore. I parametri e lo stato del cronometro si riallineano all'istante senza riavvii.

✏️ Modifica del Programma & Sintassi dei Tempi

Facendo clic sull'icona della matita (✏️) in alto a destra nel pannello del programma dell'applicazione desktop, si apre l'Editor del Programma. Questa finestra consente all'operatore di modificare dinamicamente i dettagli dell'adunanza in tempo reale:

  • Esclusione Parti (Saltata): Spuntando la casella "SALTATA", la parte viene contrassegnata con una freccia grigia (↷) e considerata saltata. Il sistema la escluderà interamente dal calcolo dell'allineamento programma, evitando falsi scostamenti o ritardi anomali.
  • Correzione del Tempo Reale (Effettivo): È possibile correggere il tempo effettivo registrato ("EFFETTIVO") per le parti già completate utilizzando due diverse sintassi estremamente flessibili:
    • Sintassi Assoluta: Puoi digitare il tempo nel formato standard mm:ss (es. 12:30), con unità esplicite (es. 12m 30s, 15m, 45s), o semplicemente come numero intero (es. 12 verrà interpretato come 12 minuti).
    • Sintassi Relativa: Puoi inserire un valore preceduto da + o - per aggiungere o sottrarre tempo rispetto alla durata teorica prevista (es. +1 o +1m aggiunge 1 minuto, -30s sottrae 30 secondi). Il sistema calcolerà istantaneamente la nuova durata effettiva.
📥

Scraper & 31 Lingue Supportate

Download automatico del programma e localizzazione nativa

Per azzerare i tempi di inserimento manuale delle parti, l'applicazione integra un motore di scraping automatico collegato all'endpoint ufficiale di wol.jw.org.

🌐 Supporto Multilingue (31 Lingue Verificate)

Il motore analizza la struttura del sito WOL scaricando i testi e le durate programmate. La funzionalità è completamente testata e supporta formalmente **31 lingue** diffuse, incluse varianti geografiche e comunitarie:

Italiano
Română
shqip
العربية
中文简体
Українська
বাংলা
हिंदी
اُردو
ਪੰਜਾਬੀ
Tagalog
සිංහල
தமிழ்
English
Español
Wolof
polski
македонски
Português (Br)
Français
Русский
فارسی
Türkçe
Deutsch
Arabo Egiziano
Português (Pt)
Hausa
Yorùbá
Igbo
Edo
Twi

⚙️ Robustezza dell'Integrazione

  • Analisi delle stringhe chiave: Lo scraper rileva dinamicamente le parti dell'adunanza identificando marcatori multilingua come "Gemme spirituali", "Scaviamo ancora più a fondo" o le intestazioni della Lettura della Bibbia.
  • Overlay Informativo: Durante l'operazione di download l'app visualizza un indicatore progressivo di percentuale con la descrizione precisa dell'azione in corso, localizzata nella lingua scelta.
📈

Recupero Ritardo Adattivo

Algoritmo adattivo per la stabilità d'adunanza

Nel corso di un'adunanza, sforamenti temporali nei primi interventi possono generare ritardi significativi sulla chiusura pianificata dell'incontro.

⚙️ Funzionamento dell'Algoritmo

Se abilitato nelle preferenze del profilo, l'algoritmo rileva gli scostamenti temporali reali rispetto alla tabella di marcia teorica:

  • Distribuzione Proporzionale: Il ritardo complessivo accumulato viene distribuito in modo millesimale tra le parti rimanenti dell'adunanza.
  • Adattamento Impercettibile: La riduzione temporale sul display del podio avviene in tempo reale e in modo progressivo (secondo per secondo), impedendo contrazioni visive brusche che potrebbero distrarre l'oratore.
  • Soglie di Sicurezza: L'algoritmo non ridurrà mai una parte sotto una soglia minima di minuti, salvaguardando il tempo essenziale dell'oratore.
  • Dati per l'Operatore: Il computer in cabina visualizza costantemente sia il tempo effettivamente impostato per l'oratore, sia il ritardo reale calcolato per la sessione.
🖥️

Schermo Podio

Proiezione dedicata ed ergonomica per l'oratore

Il software gestisce l'uscita video in modalità doppio monitor. La finestra principale è ad uso esclusivo dell'operatore, mentre la seconda finestra viene proiettata sullo schermo orientato verso l'oratore sul podio.

⚙️ Caratteristiche del Display Podio

  • Elevata Leggibilità: Layout ad alto contrasto ottimizzato per una visualizzazione a distanza senza distrazioni.
  • Segnalazione Cromatica Semantica: Il timer e il cerchio di progresso cambiano colore in base allo stato temporale:
    • Verde: Tempo regolare in corso.
    • Giallo: Ultimi 30 secondi rimanenti (avviso di conclusione).
    • Rosso: Tempo scaduto (stato di Overtime).
  • Persistenza Orologio: È possibile abilitare la visualizzazione dell'ora solare corrente accanto al cronometro per favorire l'orientamento orario dell'oratore.
🔔

Avviso Overtime

Logica di sicurezza e riproduzione di allarmi sintetizzati

Per le parti che richiedono il rispetto tassativo della scadenza (in particolare le parti degli studenti dell'adunanza infrasettimanale), l'applicazione gestisce un segnale acustico di avviso.

⚙️ Logica di Sicurezza (AND Logico)

Per azzerare l'emissione involontaria di allarmi in sala, la riproduzione è subordinata alla verifica simultanea di due parametri:

  1. Abilitazione Generale: L'interruttore globale "Suono Overtime" sul pannello cronometro (o nelle opzioni di congregazione) deve essere attivo.
  2. Abilitazione di Parte: L'icona a campanella associata alla specifica parte deve essere attiva (accesa in color ambra).

Se uno solo di questi due controlli è disattivo, il motore audio viene inibito. Le parti non eleggibili (cantici, preghiere, parti principali) sono silenziate a monte e prive di controlli visivi.

🎵 5 Suoni PCM Integrati (> 1,5 Secondi)

I suoni preinstallati sono stati sintetizzati matematicamente a 44100 Hz per garantire la massima purezza di emissione ed evitare clic digitali all'avvio o alla chiusura del segnale:

🔔 Segnale Digitale Soft Sequenza ritmata di 4 doppi beep morbidi a 880 Hz (La5) con inviluppo anti-click. Durata: 2.0s
🏛️ Rintocco Classico Singolo rintocco di campana reale (Do5) modellato con 7 armoniche metalliche a decadimento naturale. Durata: 2.5s
✨ Carillon Armonico Arpeggio a 5 note (Do5-Mi5-Sol5-Do6-Mi6) calde con esteso decadimento dell'accordo finale. Durata: 2.2s
📳 Sensore Morbido Sequenza di 7 impulsi cicalino (Do4) da onda triangolare/sinusoidale con tremolo a 12 Hz. Durata: 1.8s
📞 telephone-ring-1.wav Il classico e collaudato trillo telefonico standard integrato di default nelle passate edizioni dell'app. Originale

📂 Selezione File Esterni (WAV)

Accanto ai suoni predefiniti, selezionando l'opzione "Personalizzato...", il programma avvia la selezione nativa di Windows permettendo l'assegnazione di qualunque file `.wav` arbitrario. Un pannello XAML dedicato mostra il percorso assoluto del file caricato e consente modifiche rapide e test di volume istantanei.

🌐

Companion Web

Server web locale e trasmissione sincrona a latenza zero

Il Companion Web abilita la remotizzazione del timer, estendendo la visibilità del tempo ad altri dispositivi connessi alla medesima infrastruttura di rete locale.

⚙️ Caratteristiche del Collegamento di Rete

  • Server HTTP Locale Integrato: L'abilitazione attiva un server di rete locale adibito a trasmettere i dati operativi in tempo reale.
  • Zero Configurazioni Client: Non è richiesta alcuna installazione sui dispositivi di ricezione. È sufficiente inquadrare il QR-Code generato o digitare l'indirizzo IP locale visualizzato a schermo.
  • Compatibilità Cross-Platform: Il cronometro web opera su tutti i browser standard (Chrome, Safari, Edge, Firefox) sia da tablet, smartphone che computer di altre postazioni.
⚙️

Requisiti di Sistema & Avvio

Prerequisiti software e risoluzione dei problemi all'avvio

Per garantire prestazioni elevate, transizioni fluide a 60 fps e l'integrazione di aggiornamenti silenziosi, jwMeetingLive.Timer è sviluppato sulla moderna piattaforma Microsoft .NET 10.0 per ambiente desktop Windows.

📦 1. Prerequisito Fondamentale: .NET Desktop Runtime

Il software richiede la presenza di Microsoft .NET Desktop Runtime 10.0 (x64) per Windows.

  • Rilevamento automatico: Al primo avvio, se il runtime non è presente, Windows mostrerà una finestra di avviso con la dicitura "Per eseguire questa applicazione, è necessario installare .NET".
  • Cosa fare: Fai clic su Sì / Accetta per consentire a Windows di scaricare ed installare automaticamente il componente ufficiale Microsoft in pochi istanti.
  • Installazione Manuale: Se l'avviso non compare o riscontri problemi, puoi scaricare l'installer ufficiale dal sito Microsoft: dotnet.microsoft.com/download/dotnet/10.0. Assicurati di selezionare la colonna **Windows** e scaricare la versione **x64** sotto la riga **.NET Desktop Runtime**.

🖥️ 2. WebView2 Runtime (Embedded Web Companion)

Per visualizzare correttamente le anteprime e il QR-code per i dispositivi remoti, il sistema utilizza il componente Microsoft Edge WebView2 Runtime.

  • Il componente è generalmente preinstallato e aggiornato automaticamente su tutti i sistemi Windows 10 e Windows 11 aggiornati.
  • Se l'applicazione mostra un errore relativo a WebView2 o schermate bianche nelle aree web, puoi installarlo/ripristinarlo gratuitamente tramite il sito Microsoft.

⚠️ 3. Gestione Windows SmartScreen e Avvisi Antivirus

Poiché il file di installazione (`Setup.exe`) e il sistema di auto-aggiornamento integrato (basato su tecnologia *Velopack*) vengono scaricati direttamente dal server web e aggiornati di frequente, Windows Defender o SmartScreen potrebbero mostrare la schermata "Windows ha protetto il PC".

  • Questo comportamento è normale ed è dovuto esclusivamente alla giovinezza o bassa frequenza statistica globale del pacchetto d'installazione specifico.
  • Per procedere in totale sicurezza: fai clic su "Altre informazioni" e poi sul pulsante "Esegui comunque".