Descrizione Generale dell'Applicazione

Benvenuti nel manuale tecnico dell'applicazione 'Radio Maria Play'. Questo documento fornisce una panoramica completa dell'architettura, delle funzionalità e delle specifiche tecniche del progetto. L'applicazione è sviluppata nativamente in Kotlin, il linguaggio moderno, conciso e sicuro promosso da Google per lo sviluppo Android, garantendo performance ottimali e un'elevata manutenibilità del codice.

L'obiettivo primario dell'app 'Radio Maria Play' è offrire un'esperienza multimediale fluida e integrata, sfruttando tecnologie avanzate e garantendo al contempo un'ampia compatibilità con l'ecosistema Android.

Architettura e Funzionalità Principali

Il cuore dell'applicazione si basa su un'architettura robusta e modulare, progettata per garantire scalabilità e testabilità. Di seguito sono elencate le sue caratteristiche fondamentali:

Architettura MVVM (Model-View-ViewModel): L'applicazione adotta il pattern architetturale MVVM, raccomandato da Google. Questa scelta garantisce una netta separazione tra la logica di business (Model), la logica di presentazione (ViewModel) e l'interfaccia utente (View). L'uso di componenti di Android Jetpack come ViewModel, LiveData e Flow permette di creare un'interfaccia reattiva e di gestire il ciclo di vita dei componenti in modo efficiente, riducendo i memory leak e semplificando i test unitari.
Integrazione con API di Sistema 'Vidia': L'applicazione si integra profondamente con le API proprietarie del sistema 'Vidia'. Questa integrazione permette di accedere a funzionalità hardware e software specifiche del dispositivo, garantendo un livello di performance e stabilità non raggiungibile con le API standard. Le interazioni con 'Vidia' sono gestite da un modulo dedicato per assicurare un'astrazione pulita e facilitare futuri aggiornamenti.
Riproduzione Multimediale con ExoPlayer: Per la gestione dei contenuti multimediali, è stato scelto ExoPlayer, la libreria open-source di Google che rappresenta lo standard de facto per la riproduzione video e audio su Android. ExoPlayer offre un controllo granulare, supporta un'ampia gamma di formati e permette un'implementazione efficiente dello streaming adattivo.
Supporto per la Riproduzione in Background: L'esperienza utente non si interrompe. Grazie a un servizio in foreground gestito con cura, l'applicazione consente la riproduzione continua dei contenuti anche quando l'utente passa ad altre app o blocca lo schermo del dispositivo.
Connettività con 'Car Player' (Android Auto): L'app è stata progettata per essere un compagno di viaggio ideale. È pienamente compatibile con i sistemi di infotainment per veicoli basati su Android Auto, offrendo un'interfaccia semplificata e sicura per l'utilizzo durante la guida.
Sistema di Preferiti: Per personalizzare l'esperienza, gli utenti possono salvare i loro contenuti preferiti in una sezione dedicata. Questo sistema è implementato tramite un database locale (Room), garantendo un accesso rapido e la persistenza dei dati anche in assenza di connessione.

Compatibilità e Supporto Versioni

È stata posta grande attenzione per garantire che l'applicazione sia accessibile al maggior numero possibile di utenti. Il supporto va dall'API Level 23 fino all'API Level 35, coprendo un vasto range di dispositivi, dai più datati ai più recenti.

API 23: Android 6.0 (Marshmallow)
API 24: Android 7.0 (Nougat)
API 26: Android 8.0 (Oreo)
API 28: Android 9 (Pie)
API 29: Android 10 (Q)
API 30: Android 11 (R)
API 31: Android 12 (S)
API 33: Android 13 (Tiramisu)
API 34: Android 14 (Upside Down Cake)
API 35: Android 15 (Vanilla Ice Cream)

Localizzazione e Supporto Globale

L'applicazione è progettata per un pubblico globale, con il supporto completo per 25 lingue diverse.

en: Inglese (USA, Regno Unito, etc.)
it: Italiano (Italia)
ar: Arabo (Medio Oriente, Nord Africa)
be: Bielorusso (Bielorussia)
de: Tedesco (Germania, Austria, Svizzera)
es: Spagnolo (Spagna, America Latina)
fr: Francese (Francia, Canada, etc.)
hr: Croato (Croazia)
hu: Ungherese (Ungheria)
hy: Armeno (Armenia)
lt: Lituano (Lituania)
lv: Lettone (Lettonia)
mk: Macedone (Macedonia del Nord)
mt: Maltese (Malta)
nl: Olandese (Paesi Bassi, Belgio)
pt: Portoghese (Portogallo, Brasile)
ro: Rumeno (Romania, Moldavia)
ru: Russo (Russia e paesi limitrofi)
sk: Slovacco (Slovacchia)
sq: Albanese (Albania, Kosovo)
sr: Serbo (Serbia)
sw: Swahili (Africa Orientale)
uk: Ucraino (Ucraina)
zh: Cinese (Cina)

Scopo del Manuale Tecnico

Questa introduzione serve a dare un contesto generale. Il resto di questo manuale tecnico è la risorsa definitiva per gli sviluppatori e contiene un'analisi dettagliata, classe per classe e funzione per funzione, dell'intera codebase dell'applicazione. Ogni componente, servizio, e utility è documentato per spiegare il suo scopo, le sue dipendenze e il suo funzionamento interno.

Dettagli del Documento

Data di creazione	19 Giugno 2025
Data di revisione	20 Giugno 2025
Stato	Draft
Redatto da	Chiodi Massimiliano
Creato con	Gemini AI, gemma3-27b - Nexid LAIR

Vidia è un marchio registrato di proprietà di Nexid S.r.l. - Milano, Via Filzi, 27 - Codice Fiscale e Partita Iva 05512040964