📱 Diagnostic Technique Approfondi : Pourquoi l'Arrière-Plan Android ne Fonctionne Pas & Plan de Résolution Natif

Date : 27 Octobre 2026 — 11:25 AST (Guadeloupe UTC-4)
Auteur : Antigravity & Jarvis Core
Destinataire : Raphaël
Statut : 🔍 Cause Racine Identifiée — Incompatibilité Structurelle Confirmée dans le Code Actuel


1. Constat Formel dans les Logs (11:18:01 AST)

L'analyse des journaux d'appels (live_session.log) confirme exactement et sans la moindre ambiguïté le symptôme que tu décris :

[2026-10-27 11:17:55.364] [Jarvis Live Natif] Latence tour : 5.68s
[2026-10-27 11:18:01.977] [Jarvis Orchestrateur] Tour terminé (Audio envoyé : 317282 octets)
[2026-10-27 11:18:01.980] Raphael : "On tient mon appli toujours pas en tâche de fond. Dès que je sors sur l'appli du premier plan, ça me..." -> [COUPURE BRUTALE]
[2026-10-27 11:18:02 - 11:18:27] Aucun octet audio reçu du téléphone. Silence radio total.

Dès que l'application quitte le premier plan (passage sur une autre application ou retour à l'écran d'accueil) : 1. La parole de Raphaël est immédiatement tronquée au milieu de la phrase. 2. Le flux audio montant passe à zéro absolu. 3. Le serveur ne reçoit plus aucun paquet de micro.


2. Démonstration Technique : Pourquoi, dans l'État Actuel, Cela NE PEUT PAS Marcher

Il ne s'agit pas d'un simple bug de configuration ou d'une permission manquante, mais d'une contradiction architecturale majeure entre la couche Web et la couche Native Android :

Le Problème Racine : Le Micro est Capté par la Mauvaise Couche

Verdict indiscutable : Dans l'architecture actuelle, il est physiquement impossible que l'audio continue en arrière-plan tant que la capture micro dépend de la WebView.


3. La Solution Définitive : Migration de la Boucle Audio en Natif Kotlin

Pour avoir une liaison vocale 100 % inaltérable en arrière-plan (poche, écran verrouillé, navigation sur Instagram/WhatsApp/GPS), la capture et la restitution audio doivent obligatoirement être transférées dans le service Android natif :

flowchart TD
    subgraph Architecture_Actuelle_KO["❌ Architecture Actuelle (Échec en Arrière-Plan)"]
        A1["Microphone Matériel"] --> B1["WebView (JavaScript getUserMedia)"]
        B1 --> C1["WebSocket Navigateur (app.js)"]
        C1 -. "Android coupe le micro dès onPause" .-> D1["Serveur Jarvis (Silence)"]
    end

    subgraph Architecture_Cible_NATIVE["✅ Architecture Cible (Robuste 100% Arrière-Plan)"]
        A2["Microphone Matériel"] --> B2["JarvisVoiceService (AudioRecord Natif Kotlin)"]
        B2 --> C2["OkHttp WebSocket Natif (JarvisWebSocketClient)"]
        C2 --> D2["Serveur Jarvis (Connexion Continue 24/7)"]
        D2 --> C2
        C2 --> E2["AudioTrack Natif Kotlin (Haut-Parleur / Écouteurs)"]
        B2 -. "Miroir HUD facultatif" .-> F2["WebView (Quand visible)"]
    end

Le Plan d'Action Concret en 3 Étapes :

  1. Capture Micro Native (AudioRecord dans JarvisVoiceService.kt) :
  2. Utiliser AudioRecord en mode VOICE_COMMUNICATION (16 kHz, PCM 16-bit mono), exactement comme une application d'appel téléphonique (WhatsApp / Discord / Téléphone).
  3. Android autorise les Foreground Services de type microphone à enregistrer sans aucune interruption en arrière-plan.

  4. Rétablissement du WebSocket Natif (JarvisWebSocketClient.kt) :

  5. Corriger l'URL de poignée de main : supprimer le suffixe /jarvis parasite pour cibler directement ws://<host>:<port>/ws/jarvis_live ou /ws/audio.
  6. Diffuser les chunks PCM16 natifs directement par OkHttp sans passer par JavaScript.

  7. Restitution Audio Native (AudioTrack) :

  8. Lire les réponses vocales de Jarvis via AudioTrack natif. Même si l'écran est éteint, le haut-parleur ou les écouteurs Bluetooth continuent de parler sans aucune saccade.
  9. La WebView redevient une simple télécommande d'affichage (HUD) lorsqu'elle est ouverte, sans porter la responsabilité du flux audio.

4. Conclusion & Arbitrage