Pourquoi
Les streamers stratégie et Warhammer font des moments interactifs pendant des événements comme le ZEvent : ils posent une question et veulent voir où le chat pointe. HitMap l'affiche dans le stream, presque en direct. La cible était 5 000 à 10 000 spectateurs, et il fallait tenir 50 000, avec jusqu'à dix clics chacun sur un moment fort.
Le trajet d'un clic
L'extension envoie un POST avec le jeton Twitch du spectateur. Le serveur garde le dernier clic de chaque spectateur dans la session du canal. Toutes les 200 ms, un minuteur par canal construit la carte : un champ de densité 128×72 et les zones triées par taille. La carte part en Server-Sent Events vers l'overlay, une source navigateur dans OBS.
Des choix que je peux défendre
- POST HTTP sans état en entrée, Server-Sent Events en sortie. Ni SignalR ni WebSocket : les spectateurs n'envoient que des positions et ne reçoivent rien.
- Ingestion et diffusion découplées. Rien n'est envoyé par clic ; c'est le minuteur qui produit la carte.
- Le dernier clic gagne pour chaque spectateur : une mise à jour, pas un compteur.
- Les spectateurs anonymes sont filtrés au calcul de la carte, pas à la réception, pour changer le réglage sans rien perdre.
- Le noyau ne dépend pas d'ASP.NET : toute la logique se teste sans serveur.
L'algorithme
- Les positions sont stockées brutes : un réglage changé s'applique à tous les clics déjà reçus.
- Les distances sont calculées dans un espace corrigé du format 16:9, sinon une ellipse inclinée sort déformée.
- Un flou séparable à somme glissante : son coût ne dépend pas du rayon, et aucune masse n'est perdue aux bords.
- Détection des pics, puis une zone par pic : centre, ellipse de covariance, pourcentage.
- Aucune allocation par tick : tampons réutilisés, types valeur, stackalloc borné.
Sécurité
- Le canal et le rôle viennent toujours du JWT Twitch validé, jamais du corps de la requête.
- Les commandes du stream sont réservées au diffuseur.
- L'URL de l'overlay est un jeton HMAC avec un numéro de génération : la régénérer révoque l'ancienne et coupe les flux ouverts. Elle n'est jamais écrite dans les journaux, et un test le vérifie.
Le banc de mesure
Un outil qui joue le vrai jeu : vrais POST HTTP, vrais JWT, et la carte reçue en SSE comme l'overlay. Quatre scénarios, de 10 000 spectateurs qui cliquent une fois à 50 000 spectateurs dont 30 000 cliquent. Sa vérification centrale rejoue en local les clics acceptés et exige une carte identique à celle reçue.
Résultats : tick p99 au plus 7,2 ms, clic → diffusion p99 de 211 à 217 ms (borné par le tick de 200 ms), POST p99 au plus 19 ms, aucun échec, 44 vérifications sur 44.
Ce que le banc m'a appris
- Des clics en gaussiennes parfaites ne font que des disques et des ellipses. J'ai écrit un générateur de foule : cibles irrégulières, visée propre à chaque spectateur, clics bâclés, arrivées par vagues, changements d'avis.
- Cette foule a révélé une vraie limite : une cible en sablier est coupée en deux zones. Elle est documentée, pas cachée.
- Arrêter une manche perdait les derniers clics ; la boucle du canal joue maintenant un tick final.
- Chrome empêche twitch.tv d'appeler localhost : l'API sert donc elle-même l'extension, derrière un tunnel, pour tester dans Twitch.
Comment il a été construit
En six étapes avec Claude Code comme assistant, chacune arrêtée et relue avant la suivante. Un fichier de projet fixait les décisions qui ne bougeaient pas, et l'ordre des priorités : correction, puis testabilité, puis performance, puis élégance.


