feat: Implement startup retry mechanism for custom stations and equalizer persistence

- Added state management for startup retry and custom station handling in `EstadoRadio`.
- Created tasks for implementing strict TDD with RED tests for HTTP failure retries and EQ persistence.
- Developed verification report to ensure compliance with TDD practices.
- Introduced fake services for testing, including `FakeServicioAudio`, `FakeServicioFavoritos`, and `FakeServicioRadio`.
- Implemented widget tests for `PantallaInicio` and `PantallaFavoritos` to validate UI behavior with custom stations.
- Enhanced `ServicioRadio` to support host rotation and retry logic for API calls.
- Established a new configuration file to enforce project constraints and testing rules.
This commit is contained in:
Javier Bautista Fernández
2026-04-27 17:34:04 +02:00
parent 922b3b4859
commit d579a0e107
21 changed files with 1902 additions and 156 deletions

View File

@@ -4,50 +4,121 @@ import 'dart:io';
import 'package:flutter/foundation.dart';
import 'package:path_provider/path_provider.dart';
import '../modelos/emisora.dart';
import '../modelos/preset_ecualizador.dart';
import '../servicios/servicio_audio.dart';
import '../servicios/servicio_ecualizador.dart';
import '../servicios/servicio_favoritos.dart';
import '../servicios/servicio_radio.dart';
import '../servicios/servicio_timer.dart';
/// Estado global de la app con ChangeNotifier (Provider).
class EstadoRadio extends ChangeNotifier {
final ServicioAudio audio = ServicioAudio();
final ServicioFavoritos favoritos = ServicioFavoritos();
final ServicioRadio radio = ServicioRadio();
late final ServicioTimer timer;
EstadoRadio({
ServicioAudio? audio,
ServicioFavoritos? favoritos,
ServicioRadio? radio,
ServicioEcualizador? servicioEcualizador,
Future<File> Function()? resolverArchivoCustom,
bool iniciarAutomaticamente = true,
}) : audio = audio ?? ServicioAudio(),
favoritos = favoritos ?? ServicioFavoritos(),
radio = radio ?? ServicioRadio(),
servicioEcualizador = servicioEcualizador ?? ServicioEcualizador(),
_resolverArchivoCustom = resolverArchivoCustom {
timer = ServicioTimer(this.audio);
_escucharErroresReproduccion();
if (iniciarAutomaticamente) {
_initFuture = _init();
}
}
// Errores de reproducción → SnackBar
final ServicioAudio audio;
final ServicioFavoritos favoritos;
final ServicioRadio radio;
final ServicioEcualizador servicioEcualizador;
final Future<File> Function()? _resolverArchivoCustom;
late final ServicioTimer timer;
StreamSubscription<EstadoReproduccion>? _suscripcionEstadoAudio;
Future<void>? _initFuture;
// Errores de reproducción → SnackBar.
final _errorController = StreamController<String>.broadcast();
Stream<String> get errorStream => _errorController.stream;
List<Emisora> _populares = [];
List<Emisora> _tendencias = [];
List<Emisora> _resultadosBusqueda = [];
List<Emisora> _listafavoritos = [];
List<Emisora> _listaFavoritos = [];
List<Emisora> _emisorasCustom = [];
// Presets EQ guardados por uuid de emisora
// Presets EQ guardados por uuid de emisora.
final Map<String, PresetEcualizador> _presetsEmisoraMap = {};
PresetEcualizador _presetPrincipal = PresetEcualizador.flat;
PresetEcualizador _presetActual = PresetEcualizador.flat;
bool _cargandoPopulares = false;
bool _cargandoBusqueda = false;
String? _errorCarga;
EstadoRadio() {
timer = ServicioTimer(audio);
_init();
_escucharErroresReproduccion();
List<Emisora> get populares => _populares;
List<Emisora> get tendencias => _tendencias;
List<Emisora> get resultadosBusqueda => _resultadosBusqueda;
List<Emisora> get listaFavoritos => _listaFavoritos;
List<Emisora> get emisorasCustom => _emisorasCustom;
bool get cargandoPopulares => _cargandoPopulares;
bool get cargandoBusqueda => _cargandoBusqueda;
String? get error => _errorCarga;
Emisora? get emisoraActual => audio.emisoraActual;
Stream<EstadoReproduccion> get estadoStream => audio.estadoStream;
PresetEcualizador get presetEcualizador => _presetActual;
PresetEcualizador get presetPrincipalEcualizador => _presetPrincipal;
bool get ecualizadorDisponible => audio.ecualizadorDisponible;
bool get emisoraActualEsFavorita {
final actual = emisoraActual;
if (actual == null) return false;
return _listaFavoritos.any((e) => e.uuid == actual.uuid);
}
/// Escucha el stream de estado del audio y gestiona errores de reproducción
/// de forma centralizada: cancela el timer y notifica al usuario.
bool get emisoraActualTienePresetPropio {
final actual = emisoraActual;
if (actual == null) return false;
return tienePresetEcualizadorPorEmisora(actual.uuid);
}
/// Lista principal (home): custom + populares, sin duplicados.
List<Emisora> get emisorasInicio {
final mapa = <String, Emisora>{};
for (final emisora in _emisorasCustom) {
mapa[emisora.uuid] = emisora;
}
for (final emisora in _populares) {
mapa.putIfAbsent(emisora.uuid, () => emisora);
}
return mapa.values.toList();
}
Future<void> inicializar() {
_initFuture ??= _init();
return _initFuture!;
}
Future<void> _init() async {
await _cargarEcualizadorPersistido();
await Future.wait([
cargarPopulares(),
cargarFavoritos(),
_cargarEmisorasCustom(),
]);
}
/// Escucha el stream de estado del audio y gestiona errores de reproducción.
void _escucharErroresReproduccion() {
audio.estadoStream.listen((estado) {
_suscripcionEstadoAudio = audio.estadoStream.listen((estado) {
if (estado == EstadoReproduccion.error) {
// Cancelar el timer si estaba activo — no debe contar sin audio
if (timer.activo) {
timer.cancelar();
}
@@ -56,25 +127,20 @@ class EstadoRadio extends ChangeNotifier {
});
}
List<Emisora> get populares => _populares;
List<Emisora> get tendencias => _tendencias;
List<Emisora> get resultadosBusqueda => _resultadosBusqueda;
List<Emisora> get listaFavoritos => _listafavoritos;
List<Emisora> get emisorasCustom => _emisorasCustom;
bool get cargandoPopulares => _cargandoPopulares;
bool get cargandoBusqueda => _cargandoBusqueda;
String? get error => _errorCarga;
Emisora? get emisoraActual => audio.emisoraActual;
Stream<EstadoReproduccion> get estadoStream => audio.estadoStream;
PresetEcualizador get presetEcualizador => _presetActual;
bool get ecualizadorDisponible => audio.ecualizadorDisponible;
Future<void> _init() async {
await Future.wait([
cargarPopulares(),
cargarFavoritos(),
_cargarEmisoresCustom(),
]);
Future<void> _cargarEcualizadorPersistido() async {
try {
final config = await servicioEcualizador.cargar();
_presetPrincipal = config.principal;
_presetActual = config.principal;
_presetsEmisoraMap
..clear()
..addAll(config.porEmisora);
await audio.aplicarPreset(_presetPrincipal);
} catch (_) {
_presetPrincipal = PresetEcualizador.flat;
_presetActual = PresetEcualizador.flat;
_presetsEmisoraMap.clear();
}
}
Future<void> cargarPopulares() async {
@@ -88,7 +154,7 @@ class EstadoRadio extends ChangeNotifier {
]);
_populares = results[0];
_tendencias = results[1];
} catch (e) {
} catch (_) {
_errorCarga = 'Sin conexión a la API de radio';
} finally {
_cargandoPopulares = false;
@@ -97,7 +163,7 @@ class EstadoRadio extends ChangeNotifier {
}
Future<void> cargarFavoritos() async {
_listafavoritos = await favoritos.obtenerTodos();
_listaFavoritos = await favoritos.obtenerTodos();
notifyListeners();
}
@@ -117,7 +183,7 @@ class EstadoRadio extends ChangeNotifier {
idioma: idioma,
tag: tag,
);
} catch (e) {
} catch (_) {
_errorController.add('Error en la búsqueda. Comprueba tu conexión.');
} finally {
_cargandoBusqueda = false;
@@ -128,18 +194,13 @@ class EstadoRadio extends ChangeNotifier {
Future<void> reproducir(Emisora emisora) async {
try {
await audio.reproducir(emisora);
radio.registrarClick(emisora.uuid); // fire & forget
// Restaurar preset del ecualizador de esta emisora
final preset = _presetsEmisoraMap[emisora.uuid] ?? PresetEcualizador.flat;
await cambiarPresetEcualizador(preset, guardPorEmisora: false);
unawaited(radio.registrarClick(emisora.uuid));
await _aplicarPresetActivo(_presetParaEmisora(emisora.uuid));
notifyListeners();
} catch (e) {
// La reproducción falló: cancelar el timer para evitar estado inconsistente
// (el timer no debe contar si no hay audio reproduciéndose)
if (timer.activo) {
timer.cancelar();
}
// Emitir mensaje claro al usuario con el nombre de la emisora
final mensajeError = e.toString().replaceFirst('Exception: ', '');
_errorController.add(
mensajeError.isNotEmpty && mensajeError != 'Exception'
@@ -157,6 +218,9 @@ class EstadoRadio extends ChangeNotifier {
Future<bool> toggleFavorito(Emisora emisora) async {
final esFav = await favoritos.toggleFavorito(emisora);
if (!esFav) {
await deshabilitarPresetEcualizadorPorEmisora(emisora.uuid, notificar: false);
}
await cargarFavoritos();
notifyListeners();
return esFav;
@@ -164,43 +228,135 @@ class EstadoRadio extends ChangeNotifier {
Future<bool> esFavorito(String uuid) => favoritos.esFavorito(uuid);
// ── Ecualizador ──────────────────────────────────────────────────────────
// ── Ecualizador ──────────────────────────────────────────────────────────
bool tienePresetEcualizadorPorEmisora(String uuid) =>
_presetsEmisoraMap.containsKey(uuid);
PresetEcualizador? presetEcualizadorPorEmisora(String uuid) =>
_presetsEmisoraMap[uuid];
PresetEcualizador _presetParaEmisora(String uuid) =>
_presetsEmisoraMap[uuid] ?? _presetPrincipal;
Future<void> _aplicarPresetActivo(PresetEcualizador preset) async {
_presetActual = preset;
await audio.aplicarPreset(preset);
}
Future<void> cambiarPresetPrincipalEcualizador(
PresetEcualizador preset, {
bool notificar = true,
}) async {
_presetPrincipal = preset;
await servicioEcualizador.guardarPrincipal(preset);
final actual = emisoraActual;
final puedeAplicarAhora =
actual == null || !_presetsEmisoraMap.containsKey(actual.uuid);
if (puedeAplicarAhora) {
await _aplicarPresetActivo(preset);
}
if (notificar) notifyListeners();
}
Future<void> guardarPresetEcualizadorPorEmisora(
String uuid,
PresetEcualizador preset, {
bool notificar = true,
}) async {
_presetsEmisoraMap[uuid] = preset;
await servicioEcualizador.guardarPorEmisora(uuid, preset);
if (emisoraActual?.uuid == uuid) {
await _aplicarPresetActivo(preset);
}
if (notificar) notifyListeners();
}
Future<void> habilitarPresetEcualizadorPorEmisora(
String uuid, {
PresetEcualizador? base,
bool notificar = true,
}) async {
final presetBase = base ?? _presetsEmisoraMap[uuid] ?? _presetPrincipal;
await guardarPresetEcualizadorPorEmisora(
uuid,
presetBase,
notificar: notificar,
);
}
Future<void> deshabilitarPresetEcualizadorPorEmisora(
String uuid, {
bool notificar = true,
}) async {
_presetsEmisoraMap.remove(uuid);
await servicioEcualizador.eliminarPorEmisora(uuid);
if (emisoraActual?.uuid == uuid) {
await _aplicarPresetActivo(_presetPrincipal);
}
if (notificar) notifyListeners();
}
Future<void> cambiarModoEcualizadorEmisoraActual({required bool usarPropio}) async {
final actual = emisoraActual;
if (actual == null) return;
if (usarPropio) {
await habilitarPresetEcualizadorPorEmisora(actual.uuid);
} else {
await deshabilitarPresetEcualizadorPorEmisora(actual.uuid);
}
}
Future<void> cambiarPresetEcualizador(
PresetEcualizador preset, {
bool guardPorEmisora = true,
bool guardarPorEmisora = true,
}) async {
_presetActual = preset;
await audio.aplicarPreset(preset);
if (guardPorEmisora && emisoraActual != null) {
_presetsEmisoraMap[emisoraActual!.uuid] = preset;
final actual = emisoraActual;
final usarPresetPropio = guardarPorEmisora &&
actual != null &&
_presetsEmisoraMap.containsKey(actual.uuid);
if (usarPresetPropio) {
await guardarPresetEcualizadorPorEmisora(actual.uuid, preset);
return;
}
notifyListeners();
await cambiarPresetPrincipalEcualizador(preset);
}
Future<void> cambiarBandaEcualizador(int index, double db) async {
final bandas = List<double>.from(_presetActual.bandas);
if (index >= 0 && index < bandas.length) bandas[index] = db;
_presetActual = PresetEcualizador(nombre: 'Personalizado', bandas: bandas);
await audio.setBanda(index, db);
if (emisoraActual != null) {
_presetsEmisoraMap[emisoraActual!.uuid] = _presetActual;
}
notifyListeners();
if (index < 0 || index >= bandas.length) return;
bandas[index] = db;
final modificado = PresetEcualizador(
nombre: 'Personalizado',
bandas: bandas,
);
await cambiarPresetEcualizador(modificado);
}
// ── Emisoras personalizadas ───────────────────────────────────────────────
Future<File> _archivoCustom() async {
if (_resolverArchivoCustom != null) {
return _resolverArchivoCustom!();
}
final dir = await getApplicationDocumentsDirectory();
return File('${dir.path}/emisoras_custom.json');
}
Future<void> _cargarEmisoresCustom() async {
Future<void> _cargarEmisorasCustom() async {
try {
final f = await _archivoCustom();
if (!await f.exists()) return;
final data = jsonDecode(await f.readAsString()) as List;
final archivo = await _archivoCustom();
if (!await archivo.exists()) {
_emisorasCustom = [];
notifyListeners();
return;
}
final data = jsonDecode(await archivo.readAsString()) as List;
_emisorasCustom = data
.map((e) => Emisora.fromMap(Map<String, dynamic>.from(e as Map)))
.toList();
@@ -210,24 +366,33 @@ class EstadoRadio extends ChangeNotifier {
notifyListeners();
}
Future<void> _guardarEmisoresCustom() async {
final f = await _archivoCustom();
await f.writeAsString(jsonEncode(_emisorasCustom.map((e) => e.toMap()).toList()));
Future<void> _guardarEmisorasCustom() async {
final archivo = await _archivoCustom();
await archivo.writeAsString(
jsonEncode(_emisorasCustom.map((e) => e.toMap()).toList()),
);
}
Future<void> agregarEmitoraCustom(Emisora emisora) async {
Future<void> agregarEmisoraCustom(Emisora emisora) async {
_emisorasCustom.removeWhere((e) => e.uuid == emisora.uuid);
_emisorasCustom.add(emisora);
await _guardarEmisoresCustom();
await _guardarEmisorasCustom();
notifyListeners();
}
Future<void> eliminarEmitoraCustom(String uuid) async {
// Compatibilidad con el nombre histórico (typo original).
Future<void> agregarEmitoraCustom(Emisora emisora) =>
agregarEmisoraCustom(emisora);
Future<void> eliminarEmisoraCustom(String uuid) async {
_emisorasCustom.removeWhere((e) => e.uuid == uuid);
await _guardarEmisoresCustom();
await _guardarEmisorasCustom();
notifyListeners();
}
// Compatibilidad con el nombre histórico (typo original).
Future<void> eliminarEmitoraCustom(String uuid) => eliminarEmisoraCustom(uuid);
// ── Export / Import ───────────────────────────────────────────────────────
/// Genera el JSON de toda la configuración.
@@ -238,6 +403,7 @@ class EstadoRadio extends ChangeNotifier {
'exportedAt': DateTime.now().toIso8601String(),
'favoritos': favs.map((e) => e.toMap()).toList(),
'emisorasCustom': _emisorasCustom.map((e) => e.toMap()).toList(),
'presetPrincipalEcualizador': _presetPrincipal.toJson(),
'presetsEcualizador': _presetsEmisoraMap.map(
(uuid, preset) => MapEntry(uuid, preset.toJson()),
),
@@ -249,27 +415,52 @@ class EstadoRadio extends ChangeNotifier {
final version = data['version'] as int? ?? 1;
if (version != 1) throw Exception('Versión de configuración no compatible');
// Importar favoritos
final favRaw = data['favoritos'] as List? ?? [];
for (final raw in favRaw) {
final emisora = Emisora.fromMap(Map<String, dynamic>.from(raw as Map));
await favoritos.agregar(emisora);
}
// Importar emisoras custom
final customRaw = data['emisorasCustom'] as List? ?? [];
_emisorasCustom = customRaw
.map((e) => Emisora.fromMap(Map<String, dynamic>.from(e as Map)))
.toList();
await _guardarEmisoresCustom();
await _guardarEmisorasCustom();
final principalRaw = data['presetPrincipalEcualizador'];
if (principalRaw is Map) {
_presetPrincipal = PresetEcualizador.desdeJson(
Map<String, dynamic>.from(principalRaw),
);
} else {
_presetPrincipal = PresetEcualizador.flat;
}
// Importar presets EQ
final presetsRaw = data['presetsEcualizador'] as Map? ?? {};
_presetsEmisoraMap.clear();
presetsRaw.forEach((uuid, presetJson) {
_presetsEmisoraMap[uuid as String] =
PresetEcualizador.desdeJson(Map<String, dynamic>.from(presetJson as Map));
});
_presetsEmisoraMap
..clear()
..addAll(
presetsRaw.map<String, PresetEcualizador>(
(uuid, presetJson) => MapEntry(
uuid as String,
PresetEcualizador.desdeJson(
Map<String, dynamic>.from(presetJson as Map),
),
),
),
);
await servicioEcualizador.guardarConfiguracion(
ConfiguracionEcualizador(
principal: _presetPrincipal,
porEmisora: _presetsEmisoraMap,
),
);
final actual = emisoraActual;
final presetActivo =
actual == null ? _presetPrincipal : _presetParaEmisora(actual.uuid);
await _aplicarPresetActivo(presetActivo);
await cargarFavoritos();
notifyListeners();
@@ -289,6 +480,7 @@ class EstadoRadio extends ChangeNotifier {
@override
void dispose() {
_suscripcionEstadoAudio?.cancel();
_errorController.close();
audio.dispose();
timer.dispose();