Cours Vibe coding avec Claude Code · Module 9: Clone de Discord
Canal vocal et statut de l'équipage : un écran tiré d'un croquis
Dans cette leçon8
Avant un abordage, personne n'a le temps d'écrire dans un chat. L'équipage parle en direct, et le capitaine veut voir d'un coup d'œil qui est dans le canal, qui parle à l'instant et qui a coupé son micro. Discord résout cela avec des canaux vocaux où l'on entre comme dans une cabine, et avec un statut d'activité près du nom, qui dit ce que fait le pirate en dehors du chat.
Ce que tu vas apprendre
- confier un écran à Claude à partir d'un croquis plutôt que d'une longue description, comme dans la location 4 ;
- retrouver avec la recherche de Cursor les champs que l'agent a utilisés et qui n'existent pas dans le type ;
- demander le micro seulement après un clic et le libérer à la sortie du canal ;
- ajouter un statut d'activité dont la durée est calculée par une fonction pure.
D'abord le type de l'état vocal
Avant l'écran, il faut le type dont l'écran se servira. Demande à Claude un fichier types/voice.ts avec l'état d'une personne dans le canal. Ouvre le fichier dans Cursor :
export interface VoiceState {
memberId: string;
channelId: string;
selfMute: boolean; // s'est rendu muet lui-même
selfDeaf: boolean; // a coupé lui-même le son
serverMute: boolean; // rendu muet par un modérateur
serverDeaf: boolean; // son coupé par un modérateur
speaking: boolean; // dans le clone, vient des données de test
}Le mutisme a deux sources, donc deux champs : dans l'état vocal, Discord distingue self_mute, le mutisme choisi par la personne, et mute, le mutisme imposé par le serveur. Un pirate rendu muet par un modérateur ne peut pas se rétablir seul, et l'écran doit donc l'afficher autrement. L'état n'a pas de nom : tu retrouves la personne par memberId dans la liste des membres du serveur.
Le croquis comme demande
Un canal vocal se dessine plus facilement qu'il ne se décrit : des tuiles de personnes, un anneau autour de celle qui parle, des boutons en bas. Dans la location 4, tu donnais à Claude une image par le chemin du fichier, et tu feras de même ici. La documentation de Claude Code conseille de recourir à une image quand une description en mots serait floue ou trop longue. Fais une capture d'un canal vocal dans Discord ou un croquis sur une feuille, et enregistre-la sous croquis/canal-vocal.png.
Demande pour Claude Code :
D'abord, décris en quelques phrases ce que tu vois sur le croquis
croquis/canal-vocal.png. Ensuite, fais le Client Component
components/VoiceChannelView.tsx dans le style de @components/ServerSidebar.tsx :
un en-tête avec le nom du canal et le nombre de personnes (3/5 avec
une limite), des tuiles pour les personnes connectées avec un anneau vert
autour de celle qui parle, et les boutons Rejoindre, Couper le micro,
Couper le son et Quitter. L'état est dans @types/voice.ts, les personnes
dans members. N'invente pas de champs qui n'y sont pas et n'utilise pas
any. Le micro uniquement après le clic sur Rejoindre, arrêté après la
déconnexion. Pour finir, lint, types et build.La première phrase vérifie que Claude a lu le croquis comme toi. La phrase sur les champs et sur any est voulue : c'est là que l'agent se trompe le plus souvent.
Ce que Claude a écrit : l'en-tête
Ouvre components/VoiceChannelView.tsx. Le nombre de personnes et l'état du bouton Rejoindre n'ont pas d'état propre : ils se calculent à partir des données à chaque affichage :
const joined = stream !== null;
const connected = joined ? [...others, mine] : others;
const isFull = channel.userLimit !== undefined && connected.length >= channel.userLimit;others contient les états des autres personnes du canal, et mine est ton état, construit à partir de selfMute et selfDeaf. Quand le canal a une limite et qu'il est plein, le bouton reçoit disabled et le texte "Canal plein". Sans limite, isFull vaut toujours false, et l'en-tête n'affiche que le nombre de personnes.
Ce que Claude a écrit : les tuiles
Chaque tuile cherche la personne par son identifiant, et l'anneau dépend d'un champ qui existe vraiment dans le type :
const member = members.find((m) => m.id === voice.memberId);
if (!member) return null;
const ring = voice.speaking ? "ring-4 ring-green-500" : "";Sous le prénom se trouve une description : "rendu muet par un modérateur" quand serverMute, "muet" quand selfMute, ou "parle". La couleur de l'anneau n'est qu'un indice pour l'œil, et le texte "parle" sera donc aussi lu par un lecteur d'écran. Chez nous, le canal conseil-de-guerre a affiché 3/5 dans l'en-tête et trois tuiles avec trois descriptions différentes.
Ce que Claude a écrit : le micro
Selon MDN, getUserMedia demande toujours l'accord de l'utilisateur, ne fonctionne que dans un contexte sécurisé (HTTPS ou localhost), et hors de ce contexte navigator.mediaDevices vaut undefined. Un refus se termine par l'erreur NotAllowedError. C'est pourquoi la demande de micro se trouve dans la fonction qui gère le clic, jamais dans le simple affichage :
async function join() {
if (!navigator.mediaDevices) {
setError("Le micro ne fonctionne que sur une page en HTTPS ou sur localhost.");
return;
}
try {
setStream(await navigator.mediaDevices.getUserMedia({ audio: true }));
} catch {
setError("Pas d'accès au micro. Vérifie les autorisations du navigateur.");
}
}Le flux va dans l'état, et c'est un effet qui libère le micro :
useEffect(() => {
if (!stream) return;
return () => stream.getTracks().forEach((track) => track.stop());
}, [stream]);La fonction renvoyée par l'effet s'exécute quand le flux change ou que le composant quitte la page. "Quitter" met le flux à null, donc chaque piste reçoit stop(). Selon MDN, une piste arrêtée passe tout de suite à l'état ended, et le micro peut s'éteindre quand plus aucune piste ne l'utilise. Couper le micro modifie track.enabled : la piste reste, mais cesse d'émettre.
Il faut le dire clairement : ce clone n'envoie pas la voix. Une vraie conversation passe par WebRTC, et MDN explique que, pour établir une connexion entre deux appareils, il faut un serveur de signalisation. C'est un autre grand sujet. Pirate's Cove montre l'état du canal : qui est là, qui parle, qui est muet.
La revue du capitaine
- Des champs tombés du ciel. Erreur typique d'un agent : le composant utilise un champ qui n'existe pas dans le type, parce qu'il s'en souvient depuis d'autres projets, par exemple
voice.isSpeakingouvoice.username. Ouvre dans Cursor la recherche dans tout le projet (Cmd+Shift+F sur Mac, Ctrl+Shift+F sous Windows et Linux), tapevoice.et compare chaque résultat avec les champs detypes/voice.ts. Le compilateur le voit aussi, si on ne le gêne pas. Chez nous, la version avec ces champs a donné :
components/VoiceChannelView.tsx(16,51): error TS2551: Property 'isSpeaking' does not exist on type 'VoiceState'. Did you mean 'speaking'?
components/VoiceChannelView.tsx(17,18): error TS2339: Property 'username' does not exist on type 'VoiceState'.Le premier champ se corrige dans le composant, car le type a speaking. Le second n'existe pas dans l'état et ne doit pas y être : le prénom vient de la liste des membres. Si un champ manquait vraiment dans les données, tu l'ajoutes en connaissance de cause au type et aux données. Jamais par any : cherche any et eslint-disable dans le projet. Chez nous, npm run lint a rejeté des props en any[] avec la ligne Unexpected any. Specify a different type, mais npx tsc --noEmit s'est tu après une telle "réparation".
- Canal plein. Mets
userLimità 3 dans les données et vérifie que Rejoindre est désactivé. - Le micro après le clic. Ouvre un canal vocal et attends un moment : le navigateur ne peut pas demander le micro tant que tu n'as pas cliqué sur Rejoindre. Clique ensuite et refuse l'accès. Chez nous, après le refus, le message "Pas d'accès au micro. Vérifie les autorisations du navigateur." est apparu sous l'en-tête.
- La preuve. Demande un test avec un faux micro :
getUserMedian'est pas appelé avant le clic, et après Quitter chaque piste reçoitstop(). Ensuite lint, types et build.
Étape suivante : le statut d'activité
Discord affiche près du nom ce que fait le pirate : un jeu, une diffusion, de la musique ou un statut personnalisé. Demande-le dans une demande à part : un type Activity dans types/voice.ts, une fonction pure formatElapsed avec ses tests et un composant ActivityDisplay dans la liste des membres. Le type est né des champs de la documentation de Discord :
export type ActivityType = "playing" | "streaming" | "listening" | "watching" | "custom" | "competing";
export interface Activity {
type: ActivityType;
name: string; // "Sea of Thieves"
details?: string; // ce que fait le joueur à l'instant
state?: string; // état de l'équipe ou texte du statut personnalisé
url?: string; // uniquement pour les diffusions
timestamps?: { start?: number }; // millisecondes depuis 1970
party?: { size: [current: number, max: number] };
}party.size est une paire de nombres : combien de joueurs sont dans l'équipe et combien peuvent y tenir. Un statut personnalisé est une activité de type custom dont le texte se trouve dans state : il n'y a donc pas besoin d'un champ séparé pour le statut. Le lien "Regarder la diffusion" n'apparaît que si type vaut streaming et qu'il y a une url ; Discord vérifie cette adresse et, pour les diffusions, ne gère que Twitch et YouTube.
Le temps écoulé depuis le début est calculé par formatElapsed(start, now) : pour 65 secondes, elle renvoie "1:05", et au-delà d'une heure elle ajoute les heures. La fonction reçoit now de l'extérieur, car la règle react-hooks/purity rejette Date.now() dans l'affichage lui-même. L'heure courante vient d'un petit hook useNow, qui met à jour l'état toutes les secondes dans un setInterval. Sur le premier écran, l'heure n'existe pas encore : le serveur et le navigateur dessinent donc la même chose. Demande un commit, par exemple "Canal vocal et statut d'activité".
Dans l'éditeur ci-dessous t'attend le canal vocal : rejoins-le, coupe ton micro, clique sur une tuile pour que quelqu'un se mette à parler, et regarde le temps de jeu d'Anne qui avance.
Retiens : un canal vocal est un état que l'on voit à l'écran, et l'œil du capitaine est la recherche dans le projet, qui montre si l'agent n'a pas ajouté un équipage absent de la liste.
Code de cette leçon : App.jsx
// Canal vocal et statut d'activité en miniature.
// Dans le projet, Rejoindre appelle getUserMedia et Quitter arrête les pistes du micro.
// L'éditeur n'a pas accès au micro : ici Rejoindre ne change que l'état.
import { useEffect, useState } from 'react';
const members = [
{ id: 'redbeard', displayName: 'Capitaine Barbe-Rousse' },
{ id: 'anne', displayName: 'Anne Bonny' },
{ id: 'jack', displayName: 'Jack Rackham' },
{ id: 'blackbeard', displayName: 'Blackbeard' },
];
const channel = { id: 'conseil-de-guerre', name: 'conseil-de-guerre', userLimit: 5 };
const initialStates = [
{ memberId: 'redbeard', selfMute: false, selfDeaf: false, serverMute: false, serverDeaf: false, speaking: true },
{ memberId: 'anne', selfMute: true, selfDeaf: false, serverMute: false, serverDeaf: false, speaking: false },
{ memberId: 'blackbeard', selfMute: false, selfDeaf: false, serverMute: true, serverDeaf: false, speaking: false },
];
const startedAt = Date.now() - 42 * 60000;
const activities = {
anne: { type: 'playing', name: 'Sea of Thieves', details: 'Cherche un trésor', timestamps: { start: startedAt }, party: { size: [3, 4] } },
jack: { type: 'streaming', name: 'Twitch', details: 'Abordage en direct', url: 'https://www.twitch.tv/' },
redbeard: { type: 'custom', name: 'Custom Status', state: "Sur la passerelle jusqu'à l'aube" },
};
const verbs = { playing: 'Joue à', streaming: 'Diffuse', listening: 'Écoute', watching: 'Regarde', competing: 'Rivalise dans' };
// La même fonction pure que dans lib/time.ts.
function formatElapsed(start, now) {
const total = Math.max(0, Math.floor((now - start) / 1000));
const hours = Math.floor(total / 3600);
const minutes = Math.floor((total % 3600) / 60);
const seconds = String(total % 60).padStart(2, '0');
return hours > 0 ? hours + ':' + String(minutes).padStart(2, '0') + ':' + seconds : minutes + ':' + seconds;
}
function useNow() {
const [now, setNow] = useState(null);
useEffect(() => {
const id = setInterval(() => setNow(Date.now()), 1000);
return () => clearInterval(id);
}, []);
return now;
}
function ActivityDisplay({ activity }) {
const now = useNow();
if (activity.type === 'custom') return <p className="text-xs text-gray-400">{activity.state}</p>;
const start = activity.timestamps && activity.timestamps.start;
return (
<div className="text-xs text-gray-400">
<p>{verbs[activity.type]} <strong className="text-gray-200">{activity.name}</strong></p>
{activity.details && <p>{activity.details}</p>}
{activity.party && <p>Équipe {activity.party.size[0]} sur {activity.party.size[1]}</p>}
{start !== undefined && now !== null && <p>{formatElapsed(start, now)} depuis le début</p>}
{activity.type === 'streaming' && activity.url && (
<a href={activity.url} target="_blank" rel="noreferrer" className="text-indigo-300 underline">Regarder la diffusion</a>
)}
</div>
);
}
export default function App() {
const [states, setStates] = useState(initialStates);
const [joined, setJoined] = useState(false);
const [selfMute, setSelfMute] = useState(false);
const [selfDeaf, setSelfDeaf] = useState(false);
const me = { id: 'jack', displayName: 'Jack Rackham' };
const mine = { memberId: me.id, selfMute, selfDeaf, serverMute: false, serverDeaf: false, speaking: false };
const connected = joined ? [...states, mine] : states;
const isFull = connected.length >= channel.userLimit;
function toggleSpeaking(memberId) {
setStates((prev) => prev.map((s) => (s.memberId === memberId ? { ...s, speaking: !s.speaking } : s)));
}
function leave() {
setJoined(false);
setSelfMute(false);
setSelfDeaf(false);
}
return (
<div className="min-h-screen space-y-4 bg-gray-700 p-4 text-gray-100">
<section className="space-y-3 rounded-lg bg-gray-900 p-4">
<header className="flex items-center justify-between">
<h2 className="font-semibold">
♪ {channel.name} <span className="text-sm text-gray-400">{connected.length}/{channel.userLimit}</span>
</h2>
{!joined && (
<button onClick={() => setJoined(true)} disabled={isFull} className="rounded bg-green-600 px-3 py-1 font-semibold disabled:bg-gray-600">
{isFull ? 'Canal plein' : 'Rejoindre'}
</button>
)}
</header>
<p className="text-xs text-gray-400">Clique sur une tuile pour que cette personne commence ou arrête de parler.</p>
<ul className="grid grid-cols-2 gap-3 sm:grid-cols-4">
{connected.map((voice) => {
const member = members.find((m) => m.id === voice.memberId);
if (!member) return null;
const ring = voice.speaking ? 'ring-4 ring-green-500' : '';
const label = voice.serverMute ? 'rendu muet par un modérateur' : voice.selfMute ? 'muet' : voice.speaking ? 'parle' : '';
return (
<li key={voice.memberId}>
<button onClick={() => toggleSpeaking(voice.memberId)} className="flex w-full flex-col items-center gap-1 rounded-lg bg-gray-800 p-3">
<span className={'flex h-12 w-12 items-center justify-center rounded-full bg-indigo-500 font-bold ' + ring}>
{member.displayName.slice(0, 2).toUpperCase()}
</span>
<span className="text-sm">{member.displayName}</span>
<span className="text-xs text-gray-400">{label}{voice.serverDeaf || voice.selfDeaf ? ", n'entend pas" : ''}</span>
</button>
</li>
);
})}
</ul>
{joined && (
<div className="flex flex-wrap gap-2">
<button onClick={() => setSelfMute(!selfMute)} aria-pressed={selfMute} className="rounded bg-gray-800 px-3 py-1">
{selfMute ? 'Réactiver le micro' : 'Couper le micro'}
</button>
<button onClick={() => setSelfDeaf(!selfDeaf)} aria-pressed={selfDeaf} className="rounded bg-gray-800 px-3 py-1">
{selfDeaf ? 'Réactiver le son' : 'Couper le son'}
</button>
<button onClick={leave} className="rounded bg-red-600 px-3 py-1">Quitter</button>
</div>
)}
</section>
<section className="rounded-lg bg-gray-800 p-4">
<h3 className="mb-2 text-xs font-semibold uppercase text-gray-400">Statut d'activité</h3>
<ul className="space-y-3">
{members.filter((m) => activities[m.id]).map((m) => (
<li key={m.id}>
<p className="text-sm font-semibold">{m.displayName}</p>
<ActivityDisplay activity={activities[m.id]} />
</li>
))}
</ul>
</section>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Quels champs a le type VoiceState dans Pirate's Cove ?
2. Pourquoi VoiceState a-t-il séparément selfMute et serverMute ?
Voici 2 des 8 questions de cette leçon. Réponds aux autres dans le jeu.
Tâches pratiques dans le jeu
- Tri horizontal
Ordonne la ligne de la fonction join qui demande le micro : setStream(await navigator.mediaDevices.getUserMedia({ audio: true }));
- Clique dans l'ordre
Clique pour construire la définition du champ optionnel userLimit :
- Éditeur de code
Composant de salon vocal
- Tri vertical
Ordonne les étapes de revue d'un composant où l'agent a pu utiliser des champs absents du type :
- Clique dans l'ordre
Clique pour construire l'appel qui calcule le temps écoulé depuis le début de l'activité : formatElapsed(start, now)
- Éditeur de code
Composant de présence enrichie
- Tri vertical
Ordonne ce qui se passe dans ActivityDisplay avant que le temps écoulé n'apparaisse :
- Tri horizontal
Ordonne la ligne de l'effet qui libère le micro après la déconnexion : stream.getTracks().forEach((track) => track.stop())
Exercices après cette leçon
- QuestionQuiz : Champs de VoiceState
- QuestionQuiz : Deux sortes de mutisme
- Remets dans l'ordreOrdre : demande du micro
- QuestionQuiz : Qui parle
- Clique dans l'ordreOrdre : le champ userLimit dans un type
- Exercice de codePratique : interface du salon vocal
- QuestionQuiz : Statut d'activité
- QuestionQuiz : Types d'activité
- Remets dans l'ordreOrdre : chercher les champs tombés du ciel
- QuestionQuiz : Champ party dans Activity
- Clique dans l'ordreOrdre : appel de formatElapsed
- Exercice de codePratique : affichage de l'activité
- QuestionQuiz : Statut personnalisé
- Remets dans l'ordreOrdre : temps écoulé à l'écran
- QuestionQuiz : Lien de la diffusion
- Remets dans l'ordreOrdre : arrêt du micro