refactor(core/audio): eliminar 4 sobrecàrregues enable/disable no-arg (INCONS-05/DEAD-05)
enableSound()/disableSound()/enableMusic()/disableMusic() eren inline thunks que només cridaven la versió amb bool. Cap caller del projecte les invoca. Es deixa només enableSound(bool) + toggleSound() (i l'equivalent per música) com a API única. Queda pendent la divergència semàntica amb Ja::enableSound/enableMusic (Audio silencia per gain, Ja pararia els canals). No es resol aquí perquè és una decisió de disseny que lliga amb l'encapsulament de Ja::* (COUP-01). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
3089177e69
commit
d03e9fffdc
2 files changed
+2
-6
No files matched your search
@@ -74,7 +74,7 @@ Los IDs se mantienen estables una vez asignados. Cada entrada apunta al(los) fic
|
|||||||
| INCONS-02 | `audio.hpp:44-48` + `jail_audio.hpp:44-50` | Dos `MusicState` paralelos + `getRealMusicState` como puente | Importante | DONE | Eliminat `music_.state` (cache) i `getRealMusicState`. `getMusicState()` consulta Ja::* directament i projecta INVALID/DISABLED → STOPPED. La font de veritat passa a ser Ja. `update()` ja no necessita sincronització |
|
| INCONS-02 | `audio.hpp:44-48` + `jail_audio.hpp:44-50` | Dos `MusicState` paralelos + `getRealMusicState` como puente | Importante | DONE | Eliminat `music_.state` (cache) i `getRealMusicState`. `getMusicState()` consulta Ja::* directament i projecta INVALID/DISABLED → STOPPED. La font de veritat passa a ser Ja. `update()` ja no necessita sincronització |
|
||||||
| INCONS-03 | `audio.cpp` varios | Comentarios mezclan catalán y español | Menor | PENDING | Unificar a catalán |
|
| INCONS-03 | `audio.cpp` varios | Comentarios mezclan catalán y español | Menor | PENDING | Unificar a catalán |
|
||||||
| INCONS-04 | `audio.hpp:70,78` | `playMusic` `loop=-1` vs `playSound` `loop=0` | Menor | WONTFIX | Convención razonable (música loop / sonido one-shot); documentar |
|
| INCONS-04 | `audio.hpp:70,78` | `playMusic` `loop=-1` vs `playSound` `loop=0` | Menor | WONTFIX | Convención razonable (música loop / sonido one-shot); documentar |
|
||||||
| INCONS-05 | `audio.hpp:102-105` | 4 formas de enable/disable sound (API redundante) + divergencia con `Ja::enableSound` | Importante | PENDING | Dejar `enableSound(bool)` + `toggleSound()`; delegar a `Ja` |
|
| INCONS-05 | `audio.hpp:102-105` | 4 formas de enable/disable sound (API redundante) + divergencia con `Ja::enableSound` | Importante | DONE (parcial) | 4 variants no-arg eliminades. La divergència amb `Ja::enableSound/enableMusic` es manté: Audio silencia per gain, Ja pararia els canals; la decisió es posposa a COUP-01 |
|
||||||
|
|
||||||
## 6. Código muerto
|
## 6. Código muerto
|
||||||
|
|
||||||
@@ -84,7 +84,7 @@ Los IDs se mantienen estables una vez asignados. Cada entrada apunta al(los) fic
|
|||||||
| DEAD-02 | `jail_audio.hpp:671-675` | `Ja::setVolume` master no usado desde `Audio` | Menor | DONE | Eliminat; Audio fa el gate per canal |
|
| DEAD-02 | `jail_audio.hpp:671-675` | `Ja::setVolume` master no usado desde `Audio` | Menor | DONE | Eliminat; Audio fa el gate per canal |
|
||||||
| DEAD-03 | `jail_audio.hpp:346-350` | `getMusicFilename` presunto unused | Menor | DONE | Eliminat; `Ja::Music::filename` s'accedeix directe (PATCH-02) |
|
| DEAD-03 | `jail_audio.hpp:346-350` | `getMusicFilename` presunto unused | Menor | DONE | Eliminat; `Ja::Music::filename` s'accedeix directe (PATCH-02) |
|
||||||
| DEAD-04 | `jail_audio.hpp:633-638` | `getChannelState` sin getter público en `Audio` | Menor | DONE | Eliminat |
|
| DEAD-04 | `jail_audio.hpp:633-638` | `getChannelState` sin getter público en `Audio` | Menor | DONE | Eliminat |
|
||||||
| DEAD-05 | `audio.hpp:102-103` | `enableSound()`/`disableSound()` sin argumento (duplican la versión con bool) | Menor | PENDING | Cubierto por INCONS-05 |
|
| DEAD-05 | `audio.hpp:102-103` | `enableSound()`/`disableSound()` sin argumento (duplican la versión con bool) | Menor | DONE | Eliminades (veure INCONS-05) |
|
||||||
|
|
||||||
## 7. Violaciones de convenciones
|
## 7. Violaciones de convenciones
|
||||||
|
|
||||||
|
|||||||
@@ -96,14 +96,10 @@ class Audio {
|
|||||||
void applySettings(const Config& config); // Aplica una nova configuració
|
void applySettings(const Config& config); // Aplica una nova configuració
|
||||||
|
|
||||||
// --- Configuración de sonidos ---
|
// --- Configuración de sonidos ---
|
||||||
void enableSound() { enableSound(true); } // Habilitar sonidos
|
|
||||||
void disableSound() { enableSound(false); } // Deshabilitar sonidos
|
|
||||||
void enableSound(bool value); // Establecer estado de sonidos (reaplica volum)
|
void enableSound(bool value); // Establecer estado de sonidos (reaplica volum)
|
||||||
void toggleSound() { enableSound(!sound_enabled_); } // Alternar estado de sonidos (reaplica volum)
|
void toggleSound() { enableSound(!sound_enabled_); } // Alternar estado de sonidos (reaplica volum)
|
||||||
|
|
||||||
// --- Configuración de música ---
|
// --- Configuración de música ---
|
||||||
void enableMusic() { enableMusic(true); } // Habilitar música
|
|
||||||
void disableMusic() { enableMusic(false); } // Deshabilitar música
|
|
||||||
void enableMusic(bool value); // Establecer estado de música (reaplica volum)
|
void enableMusic(bool value); // Establecer estado de música (reaplica volum)
|
||||||
void toggleMusic() { enableMusic(!music_enabled_); } // Alternar estado de música (reaplica volum)
|
void toggleMusic() { enableMusic(!music_enabled_); } // Alternar estado de música (reaplica volum)
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user