Badmiton Statistic

1. Descrizione

Questo è un tracker di statistiche per il badminton doppio. L'app tiene traccia dei giocatori, registra le partite e calcola il loro punteggio. Include una modalità "Gioco" interattiva per il punteggio con supporto per gamepad e controllo vocale.

2. Gestione dati (JSON)

Carica JSON: sostituisce completamente tutti i dati correnti con i dati di un file badminton_db.json selezionato.

Salva JSON: salva l'intero database corrente in un file badminton_db.json nella cartella "Download".

3. Schermate principali

Statistiche generali: schermata principale. Elenca tutti i giocatori ordinati per punteggio.

Statistiche giornaliere: punteggi e statistiche dei giocatori calcolati solo per un singolo giorno selezionato.

Report giornaliero: elenco cronologico di tutte le partite giocate nel giorno selezionato.

Partita: schermata interattiva per il punteggio in tempo reale.

4. Schermata "Partita" (Punteggio interattivo)

Impostazione giocatori

Seleziona: tocca un giocatore nell'elenco a sinistra per "selezionarlo" (evidenziato).

Posiziona: tocca un quadrante verde vuoto per posizionare il giocatore selezionato.

Scambia: tocca il primo giocatore (evidenziato in rosso), quindi tocca il secondo giocatore. I due giocatori si scambieranno.

Rimuovi: tieni premuto (tocco prolungato) un quadrante con un giocatore.

Giocatori temporanei:

Aggiungi: tocca un quadrante vuoto (senza un giocatore selezionato) per visualizzare un prompt per il nome.

Gestisci: tocca a lungo un quadrante vuoto per passare all'elenco "Giocatori temporanei". In questa modalità, un tocco prolungato su un nome consente di rinominarlo o eliminarlo.

Gestione partita (Pulsanti)

Sinistra / Destra: seleziona la prima squadra al servizio.

Inizio: inizia la partita con i 4 giocatori posizionati.

Reimposta: (se sbloccato) elimina tutti i giocatori dal campo.

Blocca / Sblocca: blocca il campo e mantiene lo schermo attivo.

+1 Sinistra / +1 Destra: aggiunge un punto. L'app gestisce automaticamente la rotazione del server e i cambi di lato (a 11 punti).

Annulla: annulla l'ultimo punto aggiunto.

Salva partita: appare al termine della partita. Salva la partita nelle statistiche.

🔊 (tocco prolungato): attiva il controllo vocale per la configurazione del giocatore.

5. Comandi del gamepad (schermata "Gioco")

D-Pad SU: indica la squadra destra.

D-Pad GIÙ: indica la squadra sinistra.

(Modalità arbitro: se attiva, SU è il punto per l'avversario dell'arbitro, GIÙ è il punto per la squadra dell'arbitro).

D-Pad SINISTRA / DESTRA: regola il volume (se attivato tramite "A").

Pulsante A (Croce): attiva/disattiva il controllo del volume del D-Pad.

Pulsante B (Cerchio): annuncia il punteggio attuale (TTS).

Pulsante X (Quadrato) (DOPPIA TAPPA): Ruota tutti i giocatori in senso orario e inizia una nuova partita da 0-0.

Pulsante Y (Triangolo): Salva la partita e suggerisce una nuova composizione della squadra.

Pulsante AVVIA: Annulla l'ultimo punto.

6. Controllo vocale

Impostazione giocatore (Schermata "Partita"): Tocca a lungo il pulsante 🔊. Pronuncia 4 nomi (ad esempio, "Max, Mark, Mike, Alex"). L'app li inserisce e avvia la partita.

Aggiungi partita (Schermata "Report giornaliero"): Premi 🎙️ Voce +. Pronuncia 4 nomi e 2 punteggi (ad esempio, "Alex e Max 21, Mark e Mike 15"). La partita viene aggiunta al report del giorno selezionato.

7. Gestione giocatori e report

Aggiungi giocatore: Nella schermata "Statistiche generali", inserisci un nome e tocca "Aggiungi".

Visualizza/Modifica: tocca il nome di un giocatore in "Statistiche generali" per aprire la sua pagina dei dettagli.

Nella pagina Giocatore:

puoi "Rinominare" o "Eliminare" il giocatore.

Puoi aggiungere una partita manualmente.

Toccando una data nell'elenco vengono visualizzate tutte le partite di quel giorno (con le opzioni "Modifica" o "Elimina" con una "X").

Esporta report: i pulsanti "Esporta in JPG" (Salva) e "Condividi" (Invia) sono disponibili in tutte e tre le schermate delle statistiche.

8. Calcolo del punteggio

Il punteggio (WeightedScore) viene calcolato utilizzando due fattori:

Media punti per partita (una vittoria per 21-5 è migliore di 21-19).

Esperienza (Totale partite): funge da moltiplicatore del punteggio (log(Totale partite) + 1). Il sistema premia i giocatori che giocano bene spesso e con costanza.