Skip to content

Native Android client for Spotify, built with Jetpack Compose

docs: audit of 18 October (useless calls, latency, animations)

kota-zoc3170cdad5d8
diff --git a/docs/audit-2026-10-18.md b/docs/audit-2026-10-18.md
new file mode 100644
index 00000000..2b2fbe9f
--- /dev/null
+++ b/docs/audit-2026-10-18.md
@@ -0,0 +1,175 @@
+# Audit Myspoti — appels inutiles, latence, animations (18 octobre 2026)
+
+Tout a été mesuré sur le téléphone (adb), build debug `app.myspoti.dev`, compte gratuit,
+autres clients du compte arrêtés (`com.spotify.music`, `app.myspoti`). Les traces brutes sont
+dans le dossier de travail de la session (audit_before_*.log / audit_after_*.log, lat_*.json).
+
+Outil de mesure de latence ajouté : `tools/tap_latency.py` (les deux horodatages sont sur
+l'horloge du téléphone : l'action passant par le chemin de commande de l'app, puis la première
+image audio de l'élément média de la page).
+
+## 1. Les appels inutiles : inventaire avant / après
+
+### Démarrage à froid (45 s)
+
+| appel du pont | avant | après |
+|---|---|---|
+| total | 16 | 14 |
+| `token.get` | 3 (dont 2 doublons à 5 ms et 105 ms) | 2 (dont 1 doublon à 118 ms) |
+| `volume.get` | 1 | 1 |
+| `player.state` / `player.queue` | 1 + 1 | 1 + 1 |
+| `library.contains` | 6 | 5 |
+| `service.call` (RootlistAPI.contains) | 4 | 4 |
+| messages « page ready » | 2 (tous les collecteurs tournent 2 fois) | 2 messages, collecteurs 1 seule fois |
+| ligne `status` toutes les 10 s | 4 | 1 (au changement) |
+
+**Cause du double démarrage** : `open.spotify.com` redirige vers `/intl-fr/`, la WebView finit
+deux fois la même page (`onPageFinished` x2) ; la seconde ré-injection du pont faisait dire
+« ready » une deuxième fois à la page (`player-bridge.js`), et `Bridge.inject()` forçait
+`ready = false` avant, ce qui créait une transition faux→vrai : le rafraîchissement d'état, la
+demande de token, la qualité audio et le volume tournaient deux fois. Corrigé dans
+`Bridge.kt` (inject ne touche plus à `ready`) et `player-bridge.js` (la page ne ré-annonce que
+si l'hôte l'a perdue). Le second `token.get` venait de `MyspotiRuntime.isSignedIn()`, qui
+demandait un token au pont au lieu de réutiliser celui du cache (`Gql`) : corrigé.
+
+### Navigation normale (4 min : accueil, playlist, artiste, player, bibliothèque, retour)
+
+| | avant | après |
+|---|---|---|
+| total appels du pont | 17 | 11 |
+| `library.contains` (cœurs) | 10 | 7 |
+| `service.call` RootlistAPI.contains | 7 | 4 |
+| **doublons stricts (< 3 s, arguments identiques)** | **6** (3 + 3) | **0** |
+| lignes `status` | 27 | 0 (aucun changement, rien écrit) |
+
+Les doublons venaient de la page elle-même : son préchargement (`ContextViewModel.prefetch`)
+et son ouverture (`refreshSaved`) demandaient les cœurs de toute la liste à < 1,2 s d'écart, et
+une playlist se re-demandait en entier à chaque page de 100 titres. Corrigé dans
+`SongPlayer.libraryContains` : une seule requête en vol par liste (les demandeurs la partagent)
+et ce que Spotify a confirmé il y a moins d'une minute n'est pas redemandé.
+
+### Idle 3 min, musique en lecture
+
+| | avant | après |
+|---|---|---|
+| total appels du pont | 33 | 2 |
+| `volume.get` | 29 (toutes les 6,05 s) | 0 |
+| lignes `status` | 18 | 1 |
+| `getDevices` côté page (mesuré 60 s) | **30 / min** | **10 / min** |
+| relays Connect (`PUT …/state`) | 9 | 6 |
+
+Le `getDevices` était le plus gros : `media.state`, lu toutes les les 2 s par la surveillance,
+demandait la liste des appareils Connect à chaque fois (30 requêtes/min, mesurées dans la page
+en comptant les appels de `ConnectDevicesAPI.getDevices`). Le résultat (« cette page est-elle
+l'appareil actif ») est mis en cache 6 s dans la page. Le `volume.get` des 6 s est venu se
+fondre dans la même lecture (`media.state` rapporte désormais le volume du lecteur). La
+surveillance passe à 4 s quand rien ne joue (2 s conservés pendant la lecture : c'est ce qui
+permet de voir une page gelée ou un titre bloqué en quelques secondes).
+
+## 2. Bugs trouvés, avec leur correction
+
+| fichier:ligne (avant) | scénario | correction |
+|---|---|---|
+| `bridge/Bridge.kt:81` + `player-bridge.js:19` | chaque chargement de page → deux « ready » | `inject()` ne force plus `ready = false` ; la page ne ré-annonce que si l'hôte l'a perdue |
+| `host-android/MyspotiRuntime.kt:57` | `isSignedIn()` demande un token à chaque ready | passe par le cache du token (`Gql`/`SpotifyHttp`), partagé avec les requêtes HTTP |
+| `player-bridge.js:322` | `media.state` = liste des appareils Connect à chaque appel (30/min) | cache 6 s dans la page |
+| `SpotifyPlayer.kt:283` | `volume.get` toutes les 6 s pendant la lecture | lu avec `media.state` (un seul appel) |
+| `MyspotiRuntime.kt:39` | `status` logué toutes les 10 s, même sans rien | logué quand la ligne change |
+| `SpotifyPlayer.kt:261` | surveillance toutes les 2 s même à l'arrêt | 4 s quand rien ne joue |
+| `SpotifyPlayer.kt:441` | fondu : 3 appels + 36 ms d'attente AVANT la commande de lecture | un seul appel (`media.fade`), la rampe tourne dans la page pendant que la commande part |
+| `di/SongPlayer.kt:385`, `:728` | cœurs demandés 2 à 3 fois par liste, +1 requête par changement de titre | cache 60 s + une requête en vol partagée ; le titre courant passe par le même chemin |
+| `host-android/PlaybackService.kt:145`, `:204` | notification et MediaSession reconstruites à chaque état (rafales de BUFFERING identiques) | `update()` ne publie que sur un vrai changement, la position est extrapolée par le système (republish 10 s) |
+| `di/SongPlayer.kt:469` | `runCatching` autour de `withTimeout` avalait la `CancellationException` | `TimeoutCancellationException` attrapée, les autres remontent |
+| `spotify/SpotifyApi.kt:76` | idem sur `player.refresh()` | idem |
+| `ui/screens/ContextScreen.kt:550` | clé d'item = index → au premier tri ou filtre, tous les éléments sont re-créés (et les animations perdues) | clé = identifiant du titre (avec occurrence pour les doublons d'une playlist) |
+| `ui/screens/ContextScreen.kt:533-536` | filtre + tri de toute la liste à chaque recomposition, `Collator` neuf à chaque tri | `derivedStateOf` (recalculé seulement quand la recherche, le tri ou un cœur change), un collator par thread |
+| `ui/screens/ContextScreen.kt:734` | `Collator.getInstance()` à chaque tri | collator partagé par thread |
+| `App.kt:44` | écriture d'état pendant la composition (`bottomBarState`) | `LaunchedEffect(route)` |
+| `ui/navigation/MyNavHost.kt:58` | `Log.d` sur le thread principal à chaque recomposition | supprimé |
+
+## 3. Latence clic → son (médiane, 10 essais par geste, même outil)
+
+A/B contrôlé : l'ancien build (`117024a`, avant l'audit) et le build audité mesurés dans la
+même session, quelques minutes d'écart, même réseau, mêmes gestes.
+
+| geste | avant (117024a) | après | gain |
+|---|---|---|---|
+| clic sur un titre | 1438 ms (1121 – 1706) | 1058 ms (722 – 1339) | **-380 ms (-26 %)** |
+| suivant | 1094 ms (965 – 1222, n=2) | 630 ms (587 – 2276, n=6) | **-464 ms** |
+| précédent | 340 ms (319 – 1045, n=8) | 282 ms (247 – 309, n=10) | -58 ms |
+| reprise après pause | 304 ms (242 – 330) | 285 ms (233 – 349) | -19 ms |
+
+(Série « avant » plus ancienne, mesurée 1 h 30 plus tôt dans une autre session : 980 / 707 /
+315 / 220 ms. Elle montre à quel point une session avec ou sans coupures de pub déplace les
+médianes : c'est pour cela que l'A/B ci-dessus, fait dans une même session, fait foi.)
+
+**Où passent les millisecondes** (5 taps tracés sur le build audité) : commande → `getDevices`
+(rappatriement Connect) +2 à 5 ms → `player.play` parti à +18 à 44 ms → réponse du pont à +25 à
+56 ms → premier son à +921 à 1120 ms. Le chemin de l'app ne coûte donc que 25 à 56 ms ; tout le
+reste est le démarrage du flux dans le Web Player (manifeste, licence Widevine, premiers
+segments audio). Le fondu en un seul appel a retiré ~40 ms de ce chemin.
+
+Les ~380 ms gagnés sur le clic viennent donc moins du chemin de commande que de la charge de la
+page : le build d'avant lui imposait ~200 interactions par minute de plus (la liste des
+appareils Connect à chaque lecture de `media.state`, le volume toutes les 6 s, le double
+« ready » et son rafraîchissement en double) qui prenaient le thread principal de la page au
+moment où elle doit démarrer le flux. Mécanisme plausible, pas démontré bout en bout : ce qui
+est mesuré, c'est le gain de médiane ci-dessus.
+
+## 4. Animations et fluidité
+
+- **Les animations de liste survivent désormais au tri et au filtre** : les lignes gardaient
+ leur index comme clé, donc chaque tri recréait toutes les lignes (perte des animations
+ d'éléments et de tout le travail de composition). Clé stable par identifiant.
+- **Plus de recalcul du tri à chaque recomposition** : une playlist longue était re-filtrée et
+ re-triée (avec un `Collator` neuf) à chaque recomposition de l'écran, soit à chaque changement
+ de titre, d'état de lecture ou de cœur. Désormais recalculé seulement quand la recherche, le
+ tri ou un cœur change.
+- **Notification et écran verrouillé sans scintillement** : les rafales d'états identiques ne
+ reconstruisent plus la notification.
+
+Non fait (voir §5) : transition partagée pochette → mini player → player, skeletons, dégradé de
+la couleur dominante, préchargement des pages au toucher/au scroll, affichage optimiste systématique.
+
+## 5. Ce qui n'a pas été corrigé ou vérifié
+
+- **La page d'artiste recharge tout** : `Api.getArtistOverview` (`data/api/Api.kt:450`) parcourt
+ toute la discographie (jusqu'à 6 requêtes de 50 albums) juste après l'aperçu, et
+ `ArtistScreen` (`ui/screens/ArtistScreen.kt:156`) déclenche le téléchargement de toutes les
+ chansons likées du compte pour calculer celles de l'artiste. `ArtistScreen` et
+ `ArtistReleasesScreen` ont chacun leur ViewModel et re-fetchent l'aperçu complet. Corrigé en
+ partie par le cache des cœurs, pas pour le reste : refactorisation de deux écrans, non tentée
+ pour ne pas casser ce qui tourne. C'est le poste d'appels inutiles restant le plus gros.
+- **La bibliothèque est assemblée et triée à chaque recomposition** (`LibraryScreeen.kt:279-305`)
+ : même traitement que la liste de ContextScreen, pas fait.
+- **`forgetWebToken` à chaque `ready`** est conservé volontairement (un rechargement peut être un
+ autre compte après déconnexion) : il reste donc une demande de token en plus au démarrage.
+- **La surveillance garde son rythme de 2 s pendant la lecture** : nécessaire pour voir une page
+ gelée ou un titre bloqué en quelques secondes (scénarios `frozen` et `song_end` du script).
+- **Préchauffage réseau (DNS/TLS), Widevine chaude, travail au contact du doigt** : non faits.
+- **Téléchargements hors ligne** (25 échecs sur 80 signalés) : pas investigué dans cet audit.
+- **Arrière-plan** : vérifié par le scénario `background` du script (musique continue) ; les
+ économies d'énergie Samsung/Xiaomi n'ont pas été testées (pas d'écran de réglage de l'appareil
+ de test dédié).
+- **Mesures de latence** : faites le même après-midi sur le même téléphone et le même réseau,
+ A/B dans une même session pour les chiffres de §3. Les scénarios de lecture sont sensibles aux
+ coupures de pub d'un compte gratuit : la suite complète `tools/playback_test.py` passe
+ **14/14** sur le build audité, mais trois scénarios (`previous_start`, `previous_middle`,
+ `seek`) échouent quand une pub tombe au milieu (le script ne l'attend pas avant
+ `seek`/`previous`) et passent dès qu'il n'y en a pas — un trou du script, pas de l'app.
+
+## Livré
+
+Six commits sur `main` (non poussés), auteur `kota-zo` :
+
+1. `8e6f137` The page says ready once per page load, and the web token is fetched once
+2. `855097b` Liked states: one request per list, and only when they can have changed
+3. `e77cc8c` Fades in one call, no volume poll of the page
+4. `6100869` The media session and the notification follow real changes only
+5. `e824eb0` Lists: no sorting at every recomposition, stable row keys
+6. `1126794` tools/tap_latency.py: time from a tap to the sound, on the phone
+
+Tests JVM (`:api-spotify:test`, `:app:testDebugUnitTest`) verts, `:app:assembleDebug` vert,
+`tools/playback_test.py` 14/14. Aucun texte visible ajouté (donc aucune chaîne à traduire),
+aucune fausse déclaration à Spotify (les pubs sont muettes ou passées, jamais déclarées
+écoutées).