================================================================================
MAGIC TV by eugeniusro – DOCUMENTAȚIE OFICIALĂ
Prezentare Aplicație (Site Web Personal) & Fișă Tehnică (Google Play Console)
================================================================================
PARTEA 1: PREZENTARE PENTRU SITE-UL PERSONAL / PROMOVARE ONLINE
Titlu Proiect: MagicTV
Dezvoltator: eugeniusro
Platformă: Android (Smartphone, Tabletă, Android Auto / Automotive OS, TV Box)
Tehnologie de Bază: 100% Kotlin & Jetpack Compose (Material Design 3)
1.1. Scurtă Descriere (Tagline)
MagicTV by eugeniusro este un player media modern de televiziune live online și fișiere locale, creat pentru a oferi o experiență de vizionare fluidă, intuitivă și perfect adaptată atât pentru ecranele telefoanelor și tabletelor, cât și pentru sistemele multimedia de navigație auto prin Android Auto.
1.2. Descriere Detaliată a Funcționalităților
MagicTV combină simplitatea navigării cu tehnologia avansată de redare audio-video:
* Grilă Bogată de Canale TV Live (Free-to-Air):
– Peste 30+ de posturi TV românești populare: Canale generaliste (Antena 1, Kanal D, Național TV, A7TV), știri 24/7 (Digi 24, Antena 3 CNN, România TV, B1 TV, Realitatea Plus, Euronews RO, Aleph News), filme (Cinemaraton Plus, Filmbox, Nostalgia TV), muzică (Kiss TV, Magic TV, Rock TV, Atomic TV, Mooz), rețeaua publică TVR (TVR 1, 2, Info, Sport, Cultural, Folclor, regionale Cluj și Craiova) și emisiuni tematice/documentare (Agro TV, Credo TV).
-10 posturi moldovenești populare (Moldova 1, Moldova 2, TVR Moldova, Realitatea TV Moldova, Privesc. EU, Party Mix, Tezaur TV, Vocea Basarabiei TV, Hit FM Visual )
– Canale internaționale renumite: Das Erste (ARD), ZDF, ZDFneo, 3sat, Deutsche Welle (Germania), France 24 FR & EN (Franța), Sky News, GB News (Anglia), NASA+, Bloomberg Originals, Red Bull TV (SUA).
* Organizare și Filtrare Inteligentă:
– Căutare instantanee după numele postului sau emisiune.
– Filtre rapide prin Chips-uri Material3: după Țară (România, Moldova, Germania, Franța, Anglia, SUA, Italia), Categorie/Gen (Știri, Filme, Muzică, General, Sport, Documentare, Regional) și Calitate/Lățime de bandă recomandată (SD, HD, FHD).
* Sistem de Favorite Personalizat:
– Salvarea canalelor preferate printr-o simplă atingere pe simbolul inimă.
– Sincronizare și persistență locală automată prin Jetpack DataStore (canalele favorite rămân salvate chiar și după repornirea telefonului).
* Redare Fișiere Video Locale:
– Selector integrat de fișiere de sistem (Storage Access Framework) pentru a deschide și reda direct clipuri video și filme în format MP4, MKV, AVI etc.
– Ideal pentru redarea fișierelor de pe memoria internă a telefonului sau de pe un stick USB conectat la unitatea multimedia a mașinii.
* Mod Mașină & Compatibilitate Android Auto:
– Implementat cu suport dedicat MediaLibraryService pentru Android Auto.
– Permite controlul și navigarea prin categorii de canale direct de pe ecranul consolei de navigație auto din bord sau de pe comenzile volanului în timpul deplasării.
* Audio Ducking Inteligent (Siguranță la Volan):
– Conceput special pentru șoferi: când sistemul de navigație (Waze, Google Maps) oferă indicații vocale, volumul MagicTV este redus temporar (ducking) automat.
– La primirea unui apel telefonic, fluxul se întrerupe pe durata conversației și revine automat la finalizarea apelului.
* Protecție Împotriva Adormirii Procesorului (WakeLock):
– Sistemul previne intrarea procesorului în mod deep sleep (WAKE_MODE_NETWORK) și menține ecranul activ (FLAG_KEEP_SCREEN_ON) pe durata vizionării, eliminând întreruperile enervante.
* Picture-in-Picture (PiP) & Rotire Manuală a Ecranului:
– Buton dedicat pentru comutarea instantanee manuală între modul Orizontal (Landscape) și mod Vertical (Portret) fără activarea senzorilor fizici ai telefonului.
– Mod Picture-in-Picture pentru a continua vizionarea fluxului TV într-o fereastră plutitoare în timp ce utilizați alte aplicații.
* Suport pentru Liste M3U Personalizate:
– Posibilitatea de a importa propriile playlisturi M3U/M3U8 pentru a extinde grila de canale după preferințe.
——————————————————————————–
PARTEA 2: FIȘĂ TEHNICĂ ȘI TEXTE PENTRU GOOGLE PLAY CONSOLE (TESTARE / RELEASE)
——————————————————————————–
2.1. Metadate Listare Magazin Google Play
* Nume Aplicație: MagicTV by eugeniusro
* Titlu Scurt (Short Description – max 80 caractere):
Player modern de TV Live & streamuri online, compatibil Android Auto și Compose.
* Titlu Extins / Descriere Completă (Full Description – Google Play):
MagicTV by eugeniusro este playerul tău multimedia dedicat redării de canale TV live difuzate online și fișierelor video locale, construit pe o arhitectură nativă modernă cu Jetpack Compose și Material 3.
Caracteristici cheie:
– Grilă completă de posturi TV românești și internaționale difuzate gratuit online (HLS / m3u8).
– Filtrează canalele după țară, categorie tematică (Știri, Filme, Muzică, Sport) sau calitate conexiune.
– Listă dedicată de canale favorite cu memorare automată pe dispozitiv.
– Player video local integrat pentru formatele MP4, MKV, AVI.
– Proiectat pentru mașină: compatibil cu Android Auto pentru comenzi sigure pe sistemul de navigație.
– Audio Ducking automat: volumul scade la instrucțiunile vocale Waze/Google Maps și se pune pe pauză la apeluri telefonice.
– Menține ecranul și conexiunea active (WakeLock & Screen On), împiedicând oprirea streamului.
– Rotire manuală de ecran (landscape/portret) printr-o singură atingere, fără acces la giroscop.
– Picture-in-Picture (PiP) pentru multitasking.
– Opțiune de import pentru liste personalizate de tip M3U/M3U8.
* Categorie Google Play: Video Players & Editors (Playere și editoare video) / Auto & Vehicles
* Clasificare Conținut: PEGI 3 / Toate vârstele (Everyone)
2.2. Specificații Tehnice & Arhitectură (Pentru Echipele de Testare / Closed & Open Testing)
* Limbaj de programare: Kotlin (v2.2.10)
* Interfață Utilizator: Jetpack Compose cu Material Design 3 (Compose BOM 2026.02.01)
* Arhitectură: MVVM (Model-View-ViewModel) + Repository Pattern + Clean Architecture
* Motor de Redare Media: AndroidX Media3 (ExoPlayer v1.5.1)
– Module: media3-exoplayer, media3-exoplayer-hls, media3-exoplayer-dash, media3-ui, media3-session
– Configurație Audio: AudioAttributes.Builder() cu USAGE_MEDIA și CONTENT_TYPE_MOVIE; setHandleAudioBecomingNoisy(true)
– Network Layer: DefaultHttpDataSource.Factory cu redirect cross-protocol și timeouts optimizate
* Serviciu Android Auto / Fundal:
– MagicMediaLibraryService extins din MediaLibraryService (Media3 Session)
– Declarație automotive: automotive_app_desc.xml ()
* Persistență Date: AndroidX DataStore Preferences (v1.1.3) pentru stocarea asincronă și reactivă a ID-urilor favorite
* Parsare Date: Kotlinx Serialization JSON (v1.7.3)
* Încărcare Imagini & Sigle TV: Coil Compose (v2.7.0) cu crossfade și cache
* SDK Targets:
– minSdk: 30 (Android 11)
– targetSdk: 35 (Android 15)
– compileSdk: 37 (Android 16 preview compatible)
2.3. Permisiuni Declarate în AndroidManifest.xml și Justificarea Lor:
– android.permission.INTERNET: Necesară pentru descărcarea și redarea fluxurilor HLS/DASH online și a logourilor canalelor.
– android.permission.ACCESS_NETWORK_STATE: Monitorizarea stării conexiunii de date pentru prevenirea buffering-ului excesiv.
– android.permission.WAKE_LOCK: Menține procesorul treaz pe timpul streaming-ului audio/video pe fundal sau în mașină.
– android.permission.FOREGROUND_SERVICE & FOREGROUND_SERVICE_MEDIA_PLAYBACK: Necesar pentru serviciul de redare audio Media3 în fundal și Android Auto.
2.4. Ghid pentru Testeri (Test Scenarios / Release Notes Google Play):
1. Test Redare Live: Atingeți orice post din lista principală (ex: TVR 1, Digi 24, France 24, NASA+). Verificați încărcarea rapidă a bufferului și claritatea audio/video.
2. Test Filtrare & Căutare: Selectați chip-ul “România”, “Muzică” sau tastați în bara de căutare pentru filtrare în timp real.
3. Test Favorite: Apăsați pe iconița de inimă a unui canal. Comutați pe tab-ul “Favorite” pentru a verifica prezența acestuia. Închideți și redeschideți aplicația pentru verificarea persistenței DataStore.
4. Test Fișiere Locale: Comutați pe tab-ul “Locale”, apăsați pe “Selectează Fișier Video”, alegeți un clip video din galeria dispozitivului și verificați redarea acestuia.
5. Test Rotire Manuală & PiP: În timpul redării pe ecran complet, apăsați pe butonul de rotire pentru a comuta în landscape, apoi apăsați pe butonul PiP sau minimizați aplicația.
6. Test Audio Ducking (Auto): Conectați telefonul la navigația mașinii sau la căști Bluetooth; simulați o indicație vocală sau un apel telefonic pentru a observa reducerea automată a volumului.
================================================================================