Files
pluriwave/lib/servicios/servicio_audio.dart
ShanaiaBot 44849986d2
Some checks failed
Flutter CI/CD — PluriWave / Test + Build (pull_request) Has been cancelled
fix(reproduccion): robustez HTTP cleartext, errores ExoPlayer y certificados SSL
**Fix 1 — HTTP cleartext (streams sin HTTPS):**
- Añadir android/app/src/main/res/xml/network_security_config.xml con
  cleartextTrafficPermitted=true para permitir streams de radio HTTP
- Referenciar en AndroidManifest.xml con android:networkSecurityConfig
- Resuelve: 'Cleartext HTTP traffic to [host] not permitted' en ExoPlayer
- Radio Paradise (Dance Wave, HTTP) y otras radios HTTP funcionan ahora

**Fix 2 — Gestión de error TYPE_SOURCE y todos los PlaybackException:**
- Añadir listener en playbackEventStream.onError en PluriWaveAudioHandler
- _gestionarErrorReproduccion() emite AudioProcessingState.error al UI,
  loggea el error y resetea el player a estado idle limpio
- _mensajeAmigable() traduce códigos ERROR_CODE_IO_*, ERROR_CODE_PARSING_*,
  ERROR_CODE_DECODING_* y mensajes de Cleartext/HandshakeException a texto legible
- EstadoRadio.reproducir() captura la excepción y cancela el timer si estaba activo
- EstadoRadio escucha el estadoStream y cancela timer ante cualquier error

**Fix 3 — Artwork con certificado autofirmado:**
- errorWidget en CachedNetworkImage captura HandshakeException silenciosamente
- Muestra _iconoFallback (icono de radio) en lugar de imagen rota
- El error de artwork no se propaga ni interrumpe la reproducción

**Fix 4 — UI consistente en estado de error:**
- PantallaReproductor._Controles muestra mensaje + botón Reintentar en error
- PantallaReproductor._Artwork muestra overlay wifi_off en estado de error
- MiniReproductor muestra botón refresh (reintentar) en estado de error
- EstadoReproduccion.error ya estaba definido; ahora el estadoStream lo emite
- Timer cancelado automáticamente cuando la reproducción falla
- Test de smoke corregido (boilerplate MyApp → placeholder válido)

Fixes: cleartext HTTP, cert autofirmado, ExoPlayer TYPE_SOURCE, UI inconsistente
2026-04-04 20:43:56 +02:00

322 lines
11 KiB
Dart

import 'dart:developer' as developer;
import 'package:audio_service/audio_service.dart';
import 'package:just_audio/just_audio.dart';
import '../modelos/emisora.dart';
import '../modelos/preset_ecualizador.dart';
/// Estado de reproducción expuesto al UI.
enum EstadoReproduccion { detenido, cargando, reproduciendo, pausado, error }
// ─────────────────────────────────────────────────────────────
// Handler global — inicializado en main.dart con AudioService.init
// ─────────────────────────────────────────────────────────────
PluriWaveAudioHandler? _handlerGlobal;
void registrarHandler(PluriWaveAudioHandler handler) {
_handlerGlobal = handler;
}
/// Wrapper de alto nivel para el UI.
class ServicioAudio {
PluriWaveAudioHandler get _handler {
assert(_handlerGlobal != null, 'registrarHandler() no fue llamado en main.dart');
return _handlerGlobal!;
}
Emisora? get emisoraActual => _handler.emisoraActual;
Stream<EstadoReproduccion> get estadoStream =>
_handler.playbackState.map((s) {
if (s.processingState == AudioProcessingState.error) {
return EstadoReproduccion.error;
}
if (s.processingState == AudioProcessingState.loading ||
s.processingState == AudioProcessingState.buffering) {
return EstadoReproduccion.cargando;
}
if (s.playing) return EstadoReproduccion.reproduciendo;
if (s.processingState == AudioProcessingState.idle) {
return EstadoReproduccion.detenido;
}
return EstadoReproduccion.pausado;
});
Future<void> reproducir(Emisora emisora) async {
final item = MediaItem(
id: emisora.url,
title: emisora.nombre,
artist: emisora.pais ?? '',
album: 'PluriWave',
artUri: emisora.favicon != null && emisora.favicon!.isNotEmpty
? Uri.tryParse(emisora.favicon!)
: null,
extras: {'uuid': emisora.uuid},
);
await _handler.playMediaItem(item);
}
Future<void> pausar() => _handler.pause();
Future<void> reanudar() => _handler.play();
Future<void> togglePlay() async {
if (_handler.playbackState.value.playing) {
await pausar();
} else {
await reanudar();
}
}
Future<void> detener() => _handler.stop();
Future<void> setVolumen(double vol) => _handler.setVolumen(vol);
double get volumen => _handler.volumen;
bool get estaSonando => _handler.playbackState.value.playing;
Future<void> dispose() async {}
// ── Ecualizador ──────────────────────────────────────────────────────────
AndroidEqualizer? get ecualizador => _handler.ecualizador;
bool get ecualizadorDisponible => _handler.ecualizadorDisponible;
PresetEcualizador get presetActual => _handler.presetActual;
Future<void> aplicarPreset(PresetEcualizador preset) =>
_handler.aplicarPreset(preset);
Future<void> setBanda(int index, double db) =>
_handler.setBanda(index, db);
}
// ─────────────────────────────────────────────────────────────
// AudioHandler
// ─────────────────────────────────────────────────────────────
class PluriWaveAudioHandler extends BaseAudioHandler with SeekHandler {
final AndroidEqualizer _eq = AndroidEqualizer();
late final AudioPlayer _player = AudioPlayer(
audioPipeline: AudioPipeline(androidAudioEffects: [_eq]),
);
Emisora? emisoraActual;
double _volumen = 1.0;
double get volumen => _volumen;
AndroidEqualizer? get ecualizador => _eq;
bool _eqDisponible = false;
bool get ecualizadorDisponible => _eqDisponible;
PresetEcualizador _presetActual = PresetEcualizador.flat;
PresetEcualizador get presetActual => _presetActual;
PluriWaveAudioHandler() {
_setupStreams();
}
void _setupStreams() {
_player.playerStateStream.listen((state) {
final playing = state.playing;
final proc = state.processingState;
playbackState.add(playbackState.value.copyWith(
controls: [
if (playing) MediaControl.pause else MediaControl.play,
MediaControl.stop,
],
systemActions: const {MediaAction.seek, MediaAction.stop},
androidCompactActionIndices: const [0],
processingState: _mapProcState(proc),
playing: playing,
bufferedPosition: _player.bufferedPosition,
speed: _player.speed,
));
});
_player.bufferedPositionStream.listen((pos) {
playbackState.add(playbackState.value.copyWith(bufferedPosition: pos));
});
// ── Escuchar errores de ExoPlayer ─────────────────────────────────────
// Captura todos los PlaybackException: TYPE_SOURCE (HTTP cleartext,
// certificado inválido, 404), TYPE_UNEXPECTED, timeout de conexión, etc.
_player.playbackEventStream.listen(
(_) {},
onError: (Object error, StackTrace stackTrace) {
_gestionarErrorReproduccion(error);
},
);
}
/// Gestiona cualquier error de reproducción de ExoPlayer de forma
/// controlada: emite estado de error al UI y resetea la reproducción.
void _gestionarErrorReproduccion(Object error) {
String mensaje;
String codigoLog;
if (error is PlayerException) {
codigoLog = 'PlayerException(code=${error.code}): ${error.message}';
mensaje = _mensajeAmigable(error);
} else {
codigoLog = 'Error desconocido: $error';
mensaje = 'Error de reproducción';
}
developer.log(
'[PluriWave] Error reproducción: $codigoLog',
name: 'ServicioAudio',
level: 900, // warning
);
// Emitir estado de error al UI (incluye mensaje legible)
playbackState.add(playbackState.value.copyWith(
processingState: AudioProcessingState.error,
playing: false,
errorMessage: mensaje,
));
// Resetear el player a estado idle limpio (sin lanzar otra excepción)
_player.stop().catchError((_) {});
}
/// Traduce códigos de error de ExoPlayer a mensajes para el usuario.
String _mensajeAmigable(PlayerException e) {
final code = e.code;
// ERROR_CODE_IO_* — problemas de red/fuente
if (code >= 2000 && code < 3000) {
if (code == 2001) return 'Sin conexión a internet';
if (code == 2002) return 'La URL de la radio no es válida';
if (code == 2003) return 'La radio no está disponible (error 404)';
if (code == 2004) return 'Tiempo de espera agotado al conectar';
return 'No se puede conectar a la radio';
}
// ERROR_CODE_PARSING_* — formato de stream no soportado
if (code >= 3000 && code < 4000) {
return 'Formato de stream no compatible';
}
// ERROR_CODE_DECODING_* — error de decodificación
if (code >= 4000 && code < 5000) {
return 'Error al decodificar el stream de audio';
}
// TYPE_SOURCE — error en la fuente (HTTP cleartext, cert, etc.)
// En just_audio suele mapearse como code=-1 o message con "Cleartext"
final msg = e.message ?? '';
if (msg.contains('Cleartext') || msg.contains('cleartext')) {
return 'Esta radio usa HTTP sin cifrar (no permitido)';
}
if (msg.contains('CERTIFICATE') || msg.contains('HandshakeException')) {
return 'Certificado SSL inválido en la radio';
}
return 'No se puede reproducir esta radio';
}
AudioProcessingState _mapProcState(ProcessingState state) {
return switch (state) {
ProcessingState.idle => AudioProcessingState.idle,
ProcessingState.loading => AudioProcessingState.loading,
ProcessingState.buffering => AudioProcessingState.buffering,
ProcessingState.ready => AudioProcessingState.ready,
ProcessingState.completed => AudioProcessingState.completed,
};
}
@override
Future<void> playMediaItem(MediaItem mediaItem) async {
this.mediaItem.add(mediaItem);
try {
await _player.stop();
await _player.setUrl(mediaItem.id);
await _player.play();
// Habilitar ecualizador tras reproducir (necesita audio activo)
await _activarEcualizador();
} on PlayerException catch (e) {
// El error ya llega por playbackEventStream.onError, pero también
// lo capturamos aquí para asegurarnos de emitir el estado de error
// y propagarlo como excepción (para que EstadoRadio muestre el mensaje).
_gestionarErrorReproduccion(e);
throw Exception(_mensajeAmigable(e));
} on Exception catch (e) {
developer.log(
'[PluriWave] Error inesperado en playMediaItem: $e',
name: 'ServicioAudio',
level: 900,
);
playbackState.add(playbackState.value.copyWith(
processingState: AudioProcessingState.error,
playing: false,
errorMessage: 'Error inesperado al reproducir',
));
rethrow;
}
}
Future<void> _activarEcualizador() async {
try {
final params = await _eq.parameters;
_eqDisponible = params.bands.isNotEmpty;
if (_eqDisponible) {
await _eq.setEnabled(true);
await aplicarPreset(_presetActual);
}
} catch (_) {
_eqDisponible = false;
}
}
/// Aplica un preset al ecualizador nativo Android.
Future<void> aplicarPreset(PresetEcualizador preset) async {
_presetActual = preset;
if (!_eqDisponible) return;
try {
final params = await _eq.parameters;
for (int i = 0; i < params.bands.length && i < preset.bandas.length; i++) {
await params.bands[i].setGain(preset.bandas[i]);
}
} catch (_) {}
}
/// Ajusta una banda individual.
Future<void> setBanda(int index, double db) async {
if (!_eqDisponible) return;
final bandas = List<double>.from(_presetActual.bandas);
if (index >= 0 && index < bandas.length) {
bandas[index] = db;
_presetActual = _presetActual.copyWithBandas(bandas);
}
try {
final params = await _eq.parameters;
if (index < params.bands.length) {
await params.bands[index].setGain(db);
}
} catch (_) {}
}
Future<void> setVolumen(double vol) async {
_volumen = vol.clamp(0.0, 1.0);
await _player.setVolume(_volumen);
}
@override
Future<void> play() => _player.play();
@override
Future<void> pause() => _player.pause();
@override
Future<void> stop() async {
await _player.stop();
emisoraActual = null;
mediaItem.add(null);
await super.stop();
}
@override
Future<void> seek(Duration position) => _player.seek(position);
@override
Future<void> onTaskRemoved() async {
await stop();
await _player.dispose();
}
}