Kurs vibe coding z Claude Code · Moduł 9: Klon Discorda

Kanał głosowy i status załogi: ekran ze szkicu

7 min czytania
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

  1. 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.isSpeaking albo voice.username. Otwórz w Cursorze wyszukiwanie w całym projekcie (Cmd+Shift+F na Macu, Ctrl+Shift+F na Windowsie i Linuksie), wpisz voice. i porównaj każde trafienie z polami w types/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ł.

  1. Pełny kanał. Zmień w danych userLimit na 3 i sprawdź, że Dołącz jest wyłączony.
  2. 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.".
  3. Dowód. Poproś o test z udawanym mikrofonem: getUserMedia nie jest wołane przed kliknięciem, a po Rozłącz każda ścieżka dostaje stop(). 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. 1. Które pola ma typ VoiceState w Pirate's Cove?

  2. 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())

  1. PytanieQuiz: Pola VoiceState
  2. PytanieQuiz: Dwa rodzaje wyciszenia
  3. Ułóż w kolejnościSortowanie: Prośba o mikrofon
  4. PytanieQuiz: Kto mówi
  5. Kliknij w kolejnościSortowanie: Pole userLimit w typie
  6. Zadanie z kodemPraktyka: Voice channel UI
  7. PytanieQuiz: Status aktywności
  8. PytanieQuiz: Typy aktywności
  9. Ułóż w kolejnościSortowanie: Szukanie pól z powietrza
  10. PytanieQuiz: Pole party w Activity
  11. Kliknij w kolejnościSortowanie: Wywołanie formatElapsed
  12. Zadanie z kodemPraktyka: Activity display
  13. PytanieQuiz: Własny status
  14. Ułóż w kolejnościSortowanie: Czas od startu na ekranie
  15. PytanieQuiz: Link do transmisji
  16. Ułóż w kolejnościSortowanie: Zatrzymanie mikrofonu

Przydatne artykuły