Files
ESP32_ZACUS/specs/apps/audiobook_player.md
T
L'électron rare 878d911065 P1.1+P1.2: Phase 9 Touch Emulator + AGENT_TODO Update
 P1.1 Phase 9 Touch Input (4h)
- TouchEmulator: 4x4 grid navigation via buttons (UP/DOWN/LEFT/RIGHT toggle)
- Files: touch_emulator.{h,cpp} + AmigaUIShell integration
- Button mapping: 0=UP, 1=SELECT, 2=DOWN, 3=MENU, 4=TOGGLE_LR
- Build SUCCESS (31.06s, 64.4% RAM, 42.0% Flash)

 P1.2 Documentation Update (1h)
- AGENT_TODO.md: Phase 9 completion + Sprint 9 section added
- Root cause analysis: watchdog timeout (cycle 9) → stack fix (8192→16384)
- Troubleshooting guide: common issues + debug commands

Files:
  + touch_emulator.{h,cpp}
  ~ ui_amiga_shell.* + main.cpp + AGENT_TODO.md

Next: P1.3 (Sprint 1 endurance validation) + P2 (main.cpp refactor)
2026-03-11 00:03:58 +01:00

2.1 KiB
Raw Blame History

Spec App - Livres Audio (audiobook_player)

1. Cadrage

  • ID runtime: audiobook_player
  • Catégorie: media
  • Scène d'entrée: SCENE_AUDIOBOOK
  • Module actuel: AudiobookModule
  • Manifest attendu: /apps/audiobook_player/manifest.json
  • Offline: oui | Streaming: oui

2. Capacités

  • Requises (193): CAP_AUDIO_OUT, CAP_STORAGE_FS, CAP_GPU_UI
  • Optionnelles (48): CAP_WIFI, CAP_STORAGE_SD

3. Objectif Produit

  • Lecture de livres audio avec position et signets persistants.

4. Contrat Actions (APP_ACTION / /api/apps/action)

Action Payload Effet attendu
open_book path local ou URL Sélectionne le livre courant.
play optionnel path/URL Lance lecture locale ou streaming.
pause vide Met en pause et sauvegarde la progression.
stop vide Arrête et sauvegarde la progression.
seek_ms entier ms Met à jour la position de lecture logique.
bookmark_set entier ms Positionne le signet courant.
bookmark_go vide Recharge la position du signet.

5. Stockage & Persistance

  • Progression: /apps/audiobook_player/progress.json
  • Champs persistés: book, position_ms, bookmark_ms, updated_at_ms

6. Backlog Développement (MVP)

  • Écran bibliothèque + reprise “continuer”.
  • Signets persistants et fiables après reboot.
  • Parité comportement local vs URL.
  • Intégrer le déclenchement depuis le launcher (AmigaUIShell::launchSelectedApp) via APP_OPEN.
  • Vérifier la route de scène (entry_screen) et la cohérence UI/LVGL.

7. Critères dAcceptation

  • L'app se lance via API et via commande série sans crash.
  • Les actions principales répondent sans erreur non gérée.
  • Le statut runtime reflète correctement state, last_event, last_error.
  • Retour propre à SCENE_READY après fermeture app.

8. Tests Recommandés

  1. APP_OPEN audiobook_player puis contrôle UI_SCENE_STATUS.
  2. Exécuter 3-5 actions clés de AudiobookModule (serial/API).
  3. APP_CLOSE puis validation APP_IDLE et absence de fuite mémoire visible.