Native Android client for Spotify, built with Jetpack Compose
Kotlin ad-freeadblockandroidjetpack-composekotlinlyricsmusic-playermusic-videomyspotispotifyspotify-adblockerspotify-clientspotify-connectspotui
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.mdnew file mode 100644index 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).