Guida al Player Musicale Globale

Il player musicale globale è una funzionalità potente che Le consente di ascoltare la Sua musica generata dall'IA ovunque nell'applicazione. Appare nella parte inferiore dello schermo quando riproduce musica, simile a piattaforme popolari come Spotify e Apple Music.

Interfaccia del Player

Modalità Minimale (Vista Predefinita)

Il player appare come una barra compatta nella parte inferiore dello schermo con tre sezioni principali:

Sezione Sinistra - Informazioni Traccia

Copertina Album: Visualizza l'immagine della musica (o un'icona musicale predefinita se non è disponibile alcuna immagine)
Nome Traccia: Mostra il titolo del brano corrente
Nome Artista: Visualizza l'artista (o "Artista Sconosciuto" se non specificato)

Sezione Centrale - Controlli di Riproduzione

Pulsante Traccia Precedente (): Passa al brano precedente nella playlist
- Visibile solo quando ha più tracce nella playlist
Pulsante Play/Pausa (/): Controllo principale per riprodurre o mettere in pausa la traccia corrente
- Colore verde durante la riproduzione
- Colore arancione in pausa
Pulsante Traccia Successiva (): Passa al brano successivo nella playlist
- Visibile solo quando ha più tracce nella playlist
Informazioni Progressione: Mostra tempo corrente / durata totale (es. "1:23 / 3:45")

Sezione Destra - Controlli Aggiuntivi

Pulsante Modalità Riproduzione: Alterna tra le modalità di riproduzione
- Ripeti Tutto (): Riproduce tutte le tracce in ordine ripetutamente
- Ripeti Una (): Ripete la traccia corrente
- Casuale (): Riproduce le tracce in ordine casuale
- Visibile solo quando ha più tracce
Pulsante Localizza (): Trova la traccia corrente nella Sua libreria musicale
- Passa alla pagina contenente questa traccia
- Visibile solo quando ha più tracce
Pulsante Playlist (): Apre il pannello della playlist per visualizzare tutte le tracce
Pulsante Download (): Scarica la traccia corrente
- Richiede abbonamento appropriato o crediti
- Mostra un indicatore di caricamento durante il download
Pulsante Espandi/Comprimi (/): Mostra o nasconde informazioni dettagliate
Pulsante Chiudi (): Nasconde il player

Barra di Avanzamento

Nella parte superiore del player troverà una barra di avanzamento interattiva:

Effetto Hover: L'altezza della barra aumenta leggermente quando ci passa sopra
Click per Spostarsi: Clicchi ovunque sulla barra per saltare a quella posizione
Trascina per Spostarsi: Clicchi e trascini per scorrere attraverso la traccia
Feedback Visivo:
- Il riempimento verde mostra la porzione riprodotta
- Un indicatore arancione pulsante appare durante lo spostamento

Modalità Espansa

Clicchi sul pulsante espandi () per accedere a informazioni aggiuntive:

Info Brano: Dettagli completi della traccia inclusi nome e artista
Prompt Generato: Il prompt IA utilizzato per creare questa musica
Testo: Testo completo se disponibile

La vista espansa mostra fino a 311px di contenuto scorrevole con un layout pulito e organizzato.

Pannello Playlist

Clicchi sul pulsante playlist () per aprire il pannello laterale:

Funzionalità

Elenco Tracce: Visualizza tutti i brani nella playlist corrente
Indicatore Traccia Corrente:
- Evidenziazione verde sulla traccia in riproduzione
- Barra verticale verde sul bordo sinistro
- Icona Play/Pausa al posto del numero traccia
Azioni Rapide: Clicchi su qualsiasi traccia per:
- Se è la traccia corrente: Mettere in pausa/Riprendere la riproduzione
- Se è una traccia diversa: Avviare immediatamente la riproduzione
Informazioni Traccia: Ogni elemento mostra:
- Numero traccia o icona play/pausa
- Copertina album
- Nome brano e artista
- Durata

Controlli Playlist

Conteggio Tracce: Mostra il numero totale di brani (es. "12 brani")
Stato Vuoto: Visualizza un messaggio utile quando la playlist è vuota

Modalità di Riproduzione

Ripeti Tutto (Predefinita)

Riproduce tutte le tracce in ordine
Torna alla prima traccia dopo il termine dell'ultima
Usa l'icona

Ripeti Una

Ripete continuamente la traccia corrente
Usa l'icona

Casuale

Riproduce le tracce in ordine casuale
Usa l'icona

Funzionalità Download

Come Scaricare

Clicchi sul pulsante download () sul player
Il sistema verificherà la Sua idoneità al download
Se idonea, il download inizierà automaticamente

Requisiti Download

Utenti Gratuiti: Download non disponibili
Utenti Pro/Ultimate: Download illimitati
Basato su Crediti: 2 crediti per download (se utilizza i crediti)

Formati Download

MP3: Disponibile per tutti gli utenti idonei
WAV: Solo membri Ultimate (qualità superiore)

Messaggi di Errore

"Il Download Richiede un Abbonamento": Passi a Pro o Ultimate
"Crediti Insufficienti": Acquisti crediti o attenda il rinnovo giornaliero
"Autenticazione Richiesta": Effettui il login prima
"Musica Non Trovata": La traccia non è disponibile
"Generazione Non Completata": Attenda il completamento della generazione della musica

Funzionalità Localizza

La funzionalità localizza () La aiuta a trovare la traccia corrente nella Sua libreria musicale:

Clicchi sul pulsante localizza
L'app naviga alla pagina della libreria musicale
Salta automaticamente alla pagina contenente la traccia
La traccia è evidenziata per una facile identificazione

Questa funzionalità è visibile solo quando riproduce da una playlist con più tracce.

Suggerimenti e Best Practice

Scorciatoie da Tastiera (se implementate)

Barra spaziatrice: Play/Pausa
Freccia Sinistra/Destra: Indietro/Avanti
Freccia Su/Giù: Traccia Successiva/Precedente

Reattività Mobile

Il player è completamente reattivo e si adatta a diverse dimensioni dello schermo:

Su mobile: Layout compatto con controlli essenziali
Su tablet: Layout standard con tutte le funzionalità
Su desktop: Layout completo con controlli espansi

Prestazioni

Il player utilizza lo streaming audio ottimizzato
Impatto minimo sulle prestazioni della pagina
Animazioni e transizioni fluide

Risoluzione Problemi

Il player non si visualizza:

Si assicuri di aver avviato la riproduzione di una traccia
Verifichi se il player è stato chiuso manualmente (provi a riprodurre di nuovo)

L'audio non si riproduce:

Controlli il volume del dispositivo e le impostazioni di silenziamento
Verifichi che il file audio sia completamente caricato
Provi ad aggiornare la pagina

Download non riuscito:

Verifichi lo stato del Suo abbonamento
Controlli il saldo dei crediti
Si assicuri di aver effettuato il login
Contatti l'assistenza se i problemi persistono

Funzionalità Avanzate

Auto-Play Successivo

Riproduce automaticamente la traccia successiva quando una termina
Funziona in tutte le modalità di riproduzione (Ripeti, Ripeti Una, Casuale)
Transizioni fluide tra le tracce

Persistenza dello Stato

Lo stato del player viene salvato durante la navigazione tra le pagine
La Sua playlist rimane intatta durante la navigazione
Riprenda la riproduzione da dove ha interrotto

Riproduzione Multi-Sorgente

Riproduce musica dalla dashboard utente
Supporta la libreria musicale admin
Mantiene contesti separati per diverse sorgenti