Généré le 13/10/2026 17:58

Analyse de faisabilité — Détection de fin de lecture audio & enchaînement automatique des rapports

Date : 13/10/2026
Mission : m_1791927139958 → non, mission propre à cette analyse : m_1791928345326 (voir /api/missions)
Fichiers étudiés : JARVIS_LIVE_VOICE/public_jarvis/app.js (lecteur audio persistant, lignes ~3117-3600), JARVIS_LIVE_VOICE/server.py (diffusion WebSocket, endpoints /api/missions/*)


1. Verdict

Faisabilité : HAUTE, effort FAIBLE. Le mécanisme de détection de fin de lecture existe déjà nativement et est déjà câblé à trois endroits distincts du code (app.js:2244, app.js:2602, app.js:2976, app.js:3003, app.js:3143). Ce qui manque n'est pas la détection — elle est résolue — mais la logique d'enchaînement (file de lecture + fermeture/ouverture automatique), qui n'existe nulle part aujourd'hui. Tous les blocs de construction nécessaires (closeActiveModal(), closePersistentAudioPlayer(), openReport(key), loadReportAudio(mission, {autoplay:true})) sont déjà fonctionnels et réutilisables sans modification.


2. Comment le système sait déjà que le son est fini

Le lecteur de rapport (this.reportAudioEl) est un élément natif HTMLAudioElement (new Audio(), app.js:3120). Le navigateur expose un événement ended standard du DOM (spec HTML5 Media Elements) qui se déclenche une fois, de façon garantie et déterministe, quand currentTime atteint duration et que la lecture s'arrête naturellement — jamais sur une pause manuelle, un seek, ou un changement de volume.

// app.js:3143 (lecteur persistant de rapport)
audio.addEventListener('ended', () => {
  audio.currentTime = 0;
  this.papPlayBtn.classList.remove('playing');
  this.papPlayIcon.textContent = '▶';
  this._syncTacPlayState(false);
  this.updateReportAudioUI();
});

C'est le mécanisme le plus fiable possible pour cette détection — bien plus robuste qu'une approche par minuteur (estimer la durée puis attendre) ou par sondage (setInterval qui vérifie currentTime >= duration, inutilement coûteux et sujet à des imprécisions d'arrondi). Aucune nouvelle détection n'est à construire : il faut seulement enrichir ce qui se passe à l'intérieur de ce handler.

Propriétés qui rendent ended fiable pour l'enchaînement


3. Ce qu'il manque réellement : la logique d'enchaînement

3.1 Les briques déjà disponibles (vérifiées dans le code, aucune à réinventer)

Action demandée Fonction existante Emplacement
Fermer le rapport actuel (visualiseur HTML) closeActiveModal() app.js:3763
Fermer la barre de lecture audio closePersistentAudioPlayer() app.js:3472
Ouvrir un rapport donné (modal + carte) openReport(key) app.js:3594
Charger + lancer l'audio d'une mission loadReportAudio(mission, {autoplay:true}) app.js:3165
Trouver la mission la plus récente avec audio getLatestMissionWithAudio() app.js:3345

3.2 Ce qui n'existe pas et doit être construit

  1. Une file de lecture ordonnée (this._reportQueue, tableau de clés de mission). Rien de comparable n'existe aujourd'hui : missionData est un simple dictionnaire sans notion de « suivant ». getLatestMissionWithAudio() ne résout que « le plus récent », pas « le suivant après celui-ci ».
  2. Un drapeau d'activation (this._chainPlaybackEnabled), car enchaîner automatiquement plusieurs rapports à la suite sans le demander serait un changement de comportement fort — à activer explicitement (bouton dédié sur la barre de lecture, ou commande vocale type « enchaîne les rapports » / « lis-moi tous les rapports non écoutés »).
  3. Le branchement du handler ended vers cette file, au lieu de se contenter de remettre l'UI à zéro :
// Extension proposée du handler existant, app.js:3143
audio.addEventListener('ended', () => {
  audio.currentTime = 0;
  this.papPlayBtn.classList.remove('playing');
  this.papPlayIcon.textContent = '▶';
  this._syncTacPlayState(false);
  this.updateReportAudioUI();

  if (this._chainPlaybackEnabled) {
    this._advanceReportQueue();
  }
});

_advanceReportQueue() {
  this.closeActiveModal(false);           // ferme le rapport HTML actuel (sans toucher l'historique navigateur)
  const nextKey = this._reportQueue.shift();
  if (!nextKey || !this.missionData[nextKey]) {
    this.appendMessage('system', '✅ [Lecture enchaînée] File de rapports terminée.');
    this.closePersistentAudioPlayer();
    return;
  }
  this.openReport(nextKey);               // ouvre le rapport suivant (ouvre aussi la modale)
  this.loadReportAudio(this.missionData[nextKey], { autoplay: true }); // lance son audio
}

4. Pièges identifiés (à traiter dans l'implémentation, pas dans la détection)

  1. Rapport interrompu par une alerte prioritaire (PPO, cf. handlePriorityInterrupt) : la pause ne déclenche pas ended, donc l'enchaînement ne se déclenchera pas par erreur pendant une interruption — c'est le comportement voulu. En revanche, à la reprise (« reprends le rapport »), il faut vérifier que _chainPlaybackEnabled reste cohérent et ne s'annule pas silencieusement.
  2. Échec réseau au chargement (error event, app.js:3150) : aujourd'hui ce handler ne fait qu'un console.warn. Pour une file de lecture robuste, il doit aussi appeler _advanceReportQueue() (ou s'arrêter proprement avec message) — sinon la file se bloque silencieusement sur un rapport dont l'audio n'a pas pu se charger.
  3. Politique autoplay des navigateurs : un premier déclenchement nécessite un geste utilisateur (clic, ou appel vocal déjà en cours avec micro ouvert, qui vaut geste utilisateur). Une fois ce geste initial accordé, Chrome/Edge autorisent les lectures automatiques suivantes au sein du même contexte de page — donc les lectures en chaîne après le premier rapport ne seront pas bloquées. Pas de risque identifié ici, confirmé par le comportement déjà observé sur playReportAudio() enchaîné depuis une commande vocale (app.js:3389).
  4. Deux lecteurs <audio> distincts coexistent : this.reportAudioEl (lecteur persistant de rapport) et l'élément audio local de toggleReplayButton (réécoute ponctuelle depuis une carte de mission, app.js:3080-3114). La chaîne proposée ne doit piloter QUE reportAudioEl — un onended = reset local existe déjà sur l'autre lecteur et ne doit pas être touché, sous peine de casser le bouton « Réécouter ».
  5. Multi-client (plusieurs onglets/appareils ouverts simultanément) : chaque navigateur gère son propre <audio> et son propre événement ended — la chaîne doit rester strictement côté client, sans coordination serveur. Aucun risque de double-déclenchement cross-appareil, car broadcast_mission_update (server.py:5717) ne pousse que des mises à jour d'état de mission, jamais un ordre de lecture.
  6. Définir l'ordre de la file : par défaut, proposer l'ordre chronologique de complétion (created_at croissant) des missions avec rapport non encore écoutées (!this._vocalAnnouncedMissions pourrait servir de proxy à « non écouté », à affiner).

5. Action réalisée en parallèle de cette mission

Conformément à la demande, la lecture du dernier rapport disponible a été relancée :


6. Recommandation

Implémenter la file de lecture (_reportQueue + _advanceReportQueue()) comme extension du handler ended existant, derrière un bouton/toggle « Lecture enchaînée » sur la barre persistentAudioPlayer, plus une commande vocale dédiée (ex. « enchaîne les rapports non écoutés »). Effort estimé : faible (un seul fichier à modifier, aucune brique serveur nouvelle, aucun nouveau concept navigateur à apprendre — uniquement de l'orchestration de fonctions déjà existantes).