Kurs vibe coding z Claude Code · Moduł 9: Klon Discorda
Kanał głosowy i status załogi: ekran ze szkicu
W tej lekcji8
Przed abordażem nikt nie ma czasu pisać na czacie. Załoga rozmawia na żywo, a kapitan chce jednym spojrzeniem widzieć, kto siedzi w kanale, kto właśnie mówi, a kto wyciszył mikrofon. Discord rozwiązuje to kanałami głosowymi, do których wchodzi się jak do kajuty, i statusem aktywności przy nazwie, który mówi, czym pirat zajmuje się poza czatem.
Czego się nauczysz
- zlecić ekran szkicem zamiast długiego opisu, tak jak w lokacji 4;
- znaleźć wyszukiwaniem w Cursorze pola, których agent użył, a których nie ma w typie;
- poprosić o mikrofon dopiero po kliknięciu i zwolnić go przy wyjściu z kanału;
- dodać status aktywności z czasem trwania liczonym w czystej funkcji.
Najpierw typ stanu głosowego
Zanim powstanie ekran, potrzebny jest typ, z którego ekran ma korzystać. Poproś Claude o types/voice.ts ze stanem jednej osoby w kanale. Otwórz plik w Cursorze:
export interface VoiceState {
memberId: string;
channelId: string;
selfMute: boolean; // wyciszył się sam
selfDeaf: boolean; // sam wyłączył dźwięk
serverMute: boolean; // wyciszony przez moderatora
serverDeaf: boolean; // dźwięk wyłączony przez moderatora
speaking: boolean; // w klonie z danych testowych
}Wyciszenie ma dwa źródła i dlatego dwa pola: Discord w stanie głosowym rozróżnia self_mute, czyli wyciszenie przez samą osobę, i mute, czyli wyciszenie przez serwer. Pirat, którego wyciszył moderator, nie może sam się odciszyć, więc ekran musi to pokazać inaczej. Stan nie ma imienia: osobę znajdziesz po memberId na liście członków serwera.
Szkic jako polecenie
Kanał głosowy łatwiej narysować niż opisać: kafelki osób, pierścień wokół tej, która mówi, przyciski na dole. W lokacji 4 podawałeś Claude obraz ścieżką do pliku, i tak samo zrobisz tu. Dokumentacja Claude Code radzi sięgać po obraz, gdy opis słowami byłby niejasny albo długi. Zrób zrzut kanału głosowego w Discordzie albo szkic na kartce i zapisz go jako szkice/kanal-glosowy.png.
Polecenie dla Claude Code:
Najpierw opisz w kilku zdaniach, co widzisz na szkicu
szkice/kanal-glosowy.png. Potem zrób Client Component
components/VoiceChannelView.tsx w stylu @components/ServerSidebar.tsx:
nagłówek z nazwą kanału i liczbą osób (3/5 przy limicie), kafelki
połączonych osób z zielonym pierścieniem wokół mówiącej, przyciski
Dołącz, Wycisz, Wyłącz dźwięk i Rozłącz. Stan jest w @types/voice.ts,
osoby w members. Nie wymyślaj pól, których tam nie ma, i nie używaj any.
Mikrofon tylko po kliknięciu Dołącz, zatrzymany po rozłączeniu.
Na koniec lint, typy i build.Pierwsze zdanie sprawdza, czy Claude przeczytał szkic tak jak Ty. Zdanie o polach i o any jest celowe: w tym miejscu agent myli się najczęściej.
Co napisał Claude: nagłówek
Otwórz components/VoiceChannelView.tsx. Liczba osób i stan przycisku Dołącz nie mają własnego stanu, tylko liczą się z danych przy każdym rysowaniu:
const joined = stream !== null;
const connected = joined ? [...others, mine] : others;
const isFull = channel.userLimit !== undefined && connected.length >= channel.userLimit;others to stany innych osób w kanale, a mine to Twój stan zbudowany z selfMute i selfDeaf. Gdy kanał ma limit i jest pełny, przycisk dostaje disabled i napis "Kanał pełny". Bez limitu isFull zawsze daje false, a nagłówek pokazuje samą liczbę osób.
Co napisał Claude: kafelki
Każdy kafelek szuka osoby po identyfikatorze, a pierścień zależy od pola, które naprawdę jest w typie:
const member = members.find((m) => m.id === voice.memberId);
if (!member) return null;
const ring = voice.speaking ? "ring-4 ring-green-500" : "";Pod imieniem stoi opis: "wyciszony przez moderatora", gdy serverMute, "wyciszony", gdy selfMute, albo "mówi". Kolor pierścienia to tylko podpowiedź dla oka, więc napis "mówi" przeczyta też czytnik ekranu. U nas kanał narada-wojenna pokazał w nagłówku 3/5 i trzy kafelki z trzema różnymi opisami.
Co napisał Claude: mikrofon
Według MDN getUserMedia zawsze pyta użytkownika o zgodę, działa tylko w bezpiecznym kontekście (HTTPS albo localhost), a poza nim navigator.mediaDevices jest undefined. Odmowa kończy się błędem NotAllowedError. Dlatego prośba o mikrofon stoi w funkcji obsługi kliknięcia, nigdy w samym rysowaniu:
async function join() {
if (!navigator.mediaDevices) {
setError("Mikrofon działa tylko na stronie z HTTPS albo na localhost.");
return;
}
try {
setStream(await navigator.mediaDevices.getUserMedia({ audio: true }));
} catch {
setError("Brak dostępu do mikrofonu. Sprawdź uprawnienia przeglądarki.");
}
}Strumień trafia do stanu, a zwolnieniem mikrofonu zajmuje się efekt:
useEffect(() => {
if (!stream) return;
return () => stream.getTracks().forEach((track) => track.stop());
}, [stream]);Funkcja zwrócona z efektu działa, gdy strumień się zmienia albo komponent znika ze strony. "Rozłącz" ustawia strumień na null, więc każda ścieżka dostaje stop(). Według MDN zatrzymana ścieżka ma od razu stan ended, a mikrofon może się wyłączyć, gdy nie używa go już żadna ścieżka. Wycisz zmienia track.enabled, czyli ścieżka zostaje, ale przestaje nadawać.
Jedno trzeba powiedzieć wprost: ten klon nie przesyła głosu. Prawdziwa rozmowa to WebRTC, a MDN opisuje, że do zestawienia połączenia między dwoma urządzeniami potrzebny jest serwer sygnalizacyjny. To osobny, duży temat. Pirate's Cove pokazuje stan kanału: kto jest, kto mówi, kto wyciszony.
Przegląd kapitana
- Pola z powietrza. Typowy błąd agenta: komponent używa pola, którego nie ma w typie, bo pamięta je z innych projektów, na przykład
voice.isSpeakingalbovoice.username. Otwórz w Cursorze wyszukiwanie w całym projekcie (Cmd+Shift+F na Macu, Ctrl+Shift+F na Windowsie i Linuksie), wpiszvoice.i porównaj każde trafienie z polami wtypes/voice.ts. Kompilator też to widzi, jeśli mu nie przeszkodzić. U nas wersja z takimi polami dała:
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'.Pierwsze pole poprawiasz w komponencie, bo typ ma speaking. Drugiego w stanie nie ma i być nie powinno: imię bierzesz z listy członków. Gdyby pola naprawdę brakowało w danych, dopisujesz je świadomie do typu i do danych. Nigdy przez any: wyszukaj w projekcie any i eslint-disable. U nas npm run lint odrzucił props z any[] linią Unexpected any. Specify a different type, ale npx tsc --noEmit po takiej "naprawie" zamilkł.
- Pełny kanał. Zmień w danych
userLimitna 3 i sprawdź, że Dołącz jest wyłączony. - Mikrofon po kliknięciu. Otwórz kanał głosowy i chwilę poczekaj: przeglądarka nie może zapytać o mikrofon, dopóki nie klikniesz Dołącz. Potem kliknij i odmów dostępu. U nas po odmowie pod nagłówkiem pojawił się komunikat "Brak dostępu do mikrofonu. Sprawdź uprawnienia przeglądarki.".
- Dowód. Poproś o test z udawanym mikrofonem:
getUserMedianie jest wołane przed kliknięciem, a po Rozłącz każda ścieżka dostajestop(). Potem lint, typy i build.
Następny krok: status aktywności
Discord pokazuje przy nazwie, czym pirat się zajmuje: gra, transmisja, muzyka albo własny status. Poproś o to osobnym poleceniem: typ Activity w types/voice.ts, czysta funkcja formatElapsed z testami i komponent ActivityDisplay w liście członków. Typ powstał z pól z dokumentacji Discorda:
export type ActivityType = "playing" | "streaming" | "listening" | "watching" | "custom" | "competing";
export interface Activity {
type: ActivityType;
name: string; // "Sea of Thieves"
details?: string; // co gracz właśnie robi
state?: string; // stan drużyny albo tekst własnego statusu
url?: string; // tylko transmisje
timestamps?: { start?: number }; // milisekundy od 1970 roku
party?: { size: [current: number, max: number] };
}party.size to para liczb: ilu graczy jest w drużynie i ilu się zmieści. Własny status to aktywność typu custom, której tekst stoi w state, więc osobne pole na status nie jest potrzebne. Link "Oglądaj transmisję" pojawia się tylko wtedy, gdy type to streaming i jest url; Discord sprawdza ten adres i przy transmisjach obsługuje tylko Twitch i YouTube.
Czas od startu liczy formatElapsed(start, now): dla 65 sekund zwraca "1:05", a powyżej godziny dokłada godziny. Funkcja dostaje now z zewnątrz, bo Date.now() w samym rysowaniu odrzuca reguła react-hooks/purity. Aktualny czas daje mały hook useNow, który co sekundę ustawia stan w setInterval. Na pierwszym ekranie czasu jeszcze nie ma, więc serwer i przeglądarka rysują to samo. Poproś o commit, na przykład "Kanał głosowy i status aktywności".
W edytorze poniżej czeka kanał głosowy: dołącz, wycisz się, kliknij kafelek, żeby ktoś zaczął mówić, i zobacz, jak rośnie czas gry Anne.
Zapamiętaj: kanał głosowy to stan, który widać na ekranie, a oko kapitana to wyszukiwanie w projekcie, które pokazuje, czy agent nie dopisał załogi, której nie ma na liście.
Kod do tej lekcji: App.jsx
// Kanał głosowy i status aktywności w miniaturze.
// W projekcie Dołącz woła getUserMedia, a Rozłącz zatrzymuje ścieżki mikrofonu.
// Edytor nie daje dostępu do mikrofonu, więc tutaj Dołącz zmienia tylko stan.
import { useEffect, useState } from 'react';
const members = [
{ id: 'redbeard', displayName: 'Kapitan Redbeard' },
{ id: 'anne', displayName: 'Anne Bonny' },
{ id: 'jack', displayName: 'Jack Rackham' },
{ id: 'blackbeard', displayName: 'Blackbeard' },
];
const channel = { id: 'narada-wojenna', name: 'narada-wojenna', 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: 'Szuka skarbu', timestamps: { start: startedAt }, party: { size: [3, 4] } },
jack: { type: 'streaming', name: 'Twitch', details: 'Abordaż na żywo', url: 'https://www.twitch.tv/' },
redbeard: { type: 'custom', name: 'Custom Status', state: 'Na mostku do świtu' },
};
const verbs = { playing: 'Gra w', streaming: 'Transmituje', listening: 'Słucha', watching: 'Ogląda', competing: 'Rywalizuje w' };
// Ta sama czysta funkcja co w 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>Drużyna {activity.party.size[0]} z {activity.party.size[1]}</p>}
{start !== undefined && now !== null && <p>{formatElapsed(start, now)} od startu</p>}
{activity.type === 'streaming' && activity.url && (
<a href={activity.url} target="_blank" rel="noreferrer" className="text-indigo-300 underline">Oglądaj transmisję</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 ? 'Kanał pełny' : 'Dołącz'}
</button>
)}
</header>
<p className="text-xs text-gray-400">Kliknij kafelek, żeby ta osoba zaczęła albo przestała mówić.</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 ? 'wyciszony przez moderatora' : voice.selfMute ? 'wyciszony' : voice.speaking ? 'mówi' : '';
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 ? ', nie słyszy' : ''}</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 ? 'Włącz mikrofon' : 'Wycisz'}
</button>
<button onClick={() => setSelfDeaf(!selfDeaf)} aria-pressed={selfDeaf} className="rounded bg-gray-800 px-3 py-1">
{selfDeaf ? 'Włącz dźwięk' : 'Wyłącz dźwięk'}
</button>
<button onClick={leave} className="rounded bg-red-600 px-3 py-1">Rozłącz</button>
</div>
)}
</section>
<section className="rounded-lg bg-gray-800 p-4">
<h3 className="mb-2 text-xs font-semibold uppercase text-gray-400">Status aktywności</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>
);
}Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Które pola ma typ VoiceState w Pirate's Cove?
2. Dlaczego VoiceState ma osobno selfMute i serverMute?
To 2 z 8 pytań do tej lekcji. Pozostałe rozwiążesz w grze.
Zadania praktyczne w grze
- Układanie w poziomie
Ułóż linię z funkcji join, która prosi o mikrofon: setStream(await navigator.mediaDevices.getUserMedia({ audio: true }));
- Klikanie w kolejności
Klikaj, aby zbudować definicję opcjonalnego pola userLimit:
- Edytor kodu
Voice channel component
- Układanie w pionie
Ułóż kroki przeglądu komponentu, w którym agent mógł użyć pól spoza typu:
- Klikanie w kolejności
Klikaj, aby zbudować wywołanie, które liczy czas od startu aktywności: formatElapsed(start, now)
- Edytor kodu
Rich presence component
- Układanie w pionie
Ułóż, co dzieje się w ActivityDisplay, zanim pojawi się czas od startu:
- Układanie w poziomie
Ułóż linię z efektu, która zwalnia mikrofon po rozłączeniu: stream.getTracks().forEach((track) => track.stop())
Zadania po tej lekcji
- PytanieQuiz: Pola VoiceState
- PytanieQuiz: Dwa rodzaje wyciszenia
- Ułóż w kolejnościSortowanie: Prośba o mikrofon
- PytanieQuiz: Kto mówi
- Kliknij w kolejnościSortowanie: Pole userLimit w typie
- Zadanie z kodemPraktyka: Voice channel UI
- PytanieQuiz: Status aktywności
- PytanieQuiz: Typy aktywności
- Ułóż w kolejnościSortowanie: Szukanie pól z powietrza
- PytanieQuiz: Pole party w Activity
- Kliknij w kolejnościSortowanie: Wywołanie formatElapsed
- Zadanie z kodemPraktyka: Activity display
- PytanieQuiz: Własny status
- Ułóż w kolejnościSortowanie: Czas od startu na ekranie
- PytanieQuiz: Link do transmisji
- Ułóż w kolejnościSortowanie: Zatrzymanie mikrofonu