ermnvldmr.com/services/docs/content/ru/quetza/guides/voice-features.md

title, weight

title	weight
Голосовые функции	3

Цель: реализовать голосовое взаимодействие с изоляцией ресурсов по серверам (гильдиям) и корректным управлением аудиосессиями.

1. Изоляция ресурсов

Голосовые функции бота обязательно изолируются на уровне отдельного сервера (гильдии):

• Архитектурный шаблон: контроллер хранит соответствие Map<GuildID, Player>.
• Поведение:
  • Подключение (Join): создать Player для сервера A, если он ещё не существует.
  • Отключение (Leave): удалить Player и освободить соединение.
  • Изоляция: команды на сервере B никак не влияют на сервер A.

2. Маршрутизация команд

Голосовые функции опираются на набор команд, работу которых координирует контроллер:

Команда	Действие	Логика контроллера
/join	Подключиться к голосовому каналу	createPlayer(guildId, channelId)
/play	Добавить трек в очередь	getPlayer(guildId).enqueue(track)
/stop	Отключиться от канала	destroyPlayer(guildId)

3. Управление состоянием

Аудиосессии по своей природе эфемерны:

• Временное состояние: активный аудиопоток (сбрасывается при отключении).
• Долговременное состояние: очередь воспроизведения или плейлист (хранится в контроллере до перезапуска бота).

Tip

Надёжность: разделяйте логику очереди воспроизведения и логику голосового соединения. Тогда бот сможет переподключиться без потери пользовательского плейлиста.

4. Пример реализации

// lib/MusicController.ts
class MusicController {
  private players = new Map<string, AudioPlayer>();

  getPlayer(guildId: string): AudioPlayer {
    if (!this.players.has(guildId)) {
      this.players.set(guildId, new AudioPlayer());
    }
    return this.players.get(guildId);
  }

  destroyPlayer(guildId: string) {
    this.players.get(guildId)?.disconnect();
    this.players.delete(guildId);
  }
}

---

См. также:

• Руководство Discord.js по голосовым функциям