Q2PRO-X 1.2: Voice Chat

Просмотр документа на сайте Q2PRO-X. Оригинальный файл можно скачать из окна сайта.

Q2PRO-X 1.2

Q2PRO-X 1.2: Voice Chat

Встроенный голосовой чат

Русское издание

28 апреля 2026

q2pro-x.com

Оглавление

  • 1. Что делает voice chat
  • 2. Где находится меню
  • 3. Требования
  • 4. Основные cvar
  • 5. Команды
  • 6. Room mode
  • Server mode
  • Manual mode
  • 7. Push-to-talk и VAD
  • 8. Gain и volume
  • 9. Микрофон
  • 10. Hosted control server
  • 11. Автовход
  • 12. Troubleshooting
  • В меню всё включено, но voice не работает
  • Никто меня не слышит
  • Я никого не слышу
  • Voice мешает игре
  • 13. Хороший baseline

Q2PRO-X 1.2: Voice Chat

Q2PRO-X 1.2 включает встроенный voice chat. Это отдельный голосовой

side-channel поверх игрового клиента: он не меняет игровые протоколы Quake II

и не заменяет say / say_team.

1. Что делает voice chat

Voice chat позволяет игрокам подключаться к голосовой комнате и говорить

через микрофон прямо из клиента.

Главная пользовательская модель:

  • если vc_enable 1, функция включена;
  • если vc_autojoin 1, клиент сам заходит в голосовую комнату при входе на

игровой сервер;

  • если vc_room_mode server, имя комнаты строится от текущего игрового

сервера;

  • если vc_room_mode manual, используется vc_room_name;
  • vc_server указывает на control-plane service, который готовит

подключение к голосовой комнате.

Default hosted control server:

https://voice-api.q2pro-x.com

2. Где находится меню

Guided menu:

  • Options -> Sound & Acoustics -> Voice Chat;

Classic Q2PRO-X menu:

  • Q2PRO-X -> voice chat.

На этой странице находятся:

  • master switch;
  • autojoin;
  • room mode;
  • manual room name;
  • control server;
  • microphone enabled;
  • mic device picker;
  • transmit mode;
  • VAD threshold;
  • mic gain;
  • receive volume;
  • deafen;
  • display name;
  • join / leave room;
  • PTT key;
  • mic toggle key;
  • restore voice defaults.

3. Требования

Текущая фаза voice chat требует OpenAL для передачи и приёма.

Проверьте:

  • s_enable 2 или пункт меню Sound engine = OpenAL;
  • soft_oal.dll присутствует в релизном каталоге;
  • livekit_ffi.dll присутствует в релизном каталоге;
  • Windows разрешает приложению доступ к микрофону.

Если звук в игре работает через software DMA, voice chat может быть

недоступен даже при включённом vc_enable.

4. Основные cvar

  • vc_enable - master switch voice chat;
  • vc_autojoin - автоматически входить в комнату при подключении к серверу;
  • vc_server - URL control-plane service;
  • vc_room_mode - server или manual;
  • vc_room_name - имя комнаты в manual mode;
  • vc_mic_enable - разрешить захват микрофона;
  • vc_mic_device - выбранный микрофон, "(default)" следует системному

default;

  • vc_ptt_mode - 1 push-to-talk, 0 voice activation;
  • vc_vad_threshold - порог VAD;
  • vc_input_gain - усиление микрофона;
  • vc_receive_volume - громкость входящего голоса;
  • vc_deafen - заглушить входящий голос, не выключая свой микрофон;
  • vc_display_name - имя в voice room, пусто = использовать player name.

Большинство vc_* сохраняется в global Q2PRO-X cfg.

5. Команды

  • voice_join - войти в текущую voice room;
  • voice_leave - выйти из комнаты;
  • +voiceptt / -voiceptt - push-to-talk;
  • voice_mic_toggle - включить/выключить микрофон;
  • voice_mic_list - вывести список микрофонов;
  • voice_mic_pick <index> - выбрать микрофон по индексу;
  • voice_defaults - вернуть voice settings к рекомендуемому baseline.

Если voice_mic_pick вызвать без аргумента, он ведёт себя как

voice_mic_list.

6. Room mode

Server mode

vc_room_mode server - рекомендуемый режим. Комната строится от текущего

game server, поэтому игроки на одном сервере попадают в один voice room без

ручного ввода.

Это хорошо для обычной игры:

  • включить vc_enable;
  • включить vc_autojoin;
  • оставить vc_room_mode server;
  • подключиться к серверу.

Manual mode

vc_room_mode manual использует vc_room_name.

Это удобно, если:

  • вы тестируете voice без игрового сервера;
  • хотите отдельную комнату для группы;
  • нужно не привязываться к текущему адресу сервера.

7. Push-to-talk и VAD

vc_ptt_mode 1 - push-to-talk. Это рекомендуемый режим для игры:

  • назначьте PTT key;
  • удерживайте клавишу для передачи.

vc_ptt_mode 0 - VAD, voice activity detection:

  • микрофон открывается по уровню сигнала;
  • vc_vad_threshold ниже = чувствительнее;
  • слишком низкое значение может ловить клавиатуру и шум комнаты;
  • слишком высокое значение может отрезать начало фраз.

Практический старт:

  • PTT: vc_ptt_mode 1;
  • VAD: vc_vad_threshold 0.02, затем двигать вниз к 0.005, если микрофон

тихий.

8. Gain и volume

vc_input_gain усиливает микрофон до передачи. 1.0 - unity. Значения выше

3-4 могут клиппировать громкую речь, но полезны для тихих микрофонов.

vc_receive_volume управляет входящим голосом независимо от общей громкости

игры. 1.0 - unity, до 10.0 - сильное усиление.

Если собеседники слышат перегруз:

  1. уменьшите vc_input_gain;
  2. проверьте Windows input level;
  3. используйте PTT, чтобы не передавать постоянный шум.

9. Микрофон

Меню Mic device... показывает устройства, которые OpenAL видит как capture

devices.

Команды:

voice_mic_list

покажет:

  • текущий выбор;
  • Windows default device;
  • список устройств с индексами.

vc_mic_device "(default)" означает "следовать системному default".

Если устройство переименовано или исчезло, выберите его заново через меню.

10. Hosted control server

vc_server по умолчанию:

https://voice-api.q2pro-x.com

Клиент обращается к control-plane для подготовки подключения. Сам voice

traffic после входа идёт через голосовую инфраструктуру, а не через игровой

Quake II сервер.

Если вы используете локальный dev setup, vc_server может указывать на

локальный service. Но для обычного пользователя менять default не нужно.

11. Автовход

Чтобы voice включался сам:

  1. vc_enable 1;
  2. vc_autojoin 1;
  3. vc_room_mode server;
  4. подключиться к игровому серверу.

Если вы вручную вышли через voice_leave, повторный вход можно сделать

через voice_join.

12. Troubleshooting

В меню всё включено, но voice не работает

Проверьте:

  • sound engine = OpenAL;
  • vc_enable 1;
  • vc_mic_enable 1;
  • Windows microphone permission;
  • выбранный vc_mic_device;
  • доступность vc_server;
  • firewall/antivirus.

Никто меня не слышит

Проверьте:

  • PTT key назначен и удерживается;
  • в VAD режиме vc_vad_threshold не слишком высок;
  • vc_input_gain не равен 0;
  • выбран правильный микрофон.

Я никого не слышу

Проверьте:

  • vc_deafen 0;
  • vc_receive_volume не равен 0;
  • OpenAL backend активен;
  • вы действительно в одной комнате.

Voice мешает игре

Используйте:

  • PTT вместо VAD;
  • vc_deafen 1 для временного mute incoming;
  • отдельную PTT key;
  • уменьшение vc_receive_volume.

13. Хороший baseline

Для большинства игроков:

  • vc_enable 1;
  • vc_autojoin 1;
  • vc_room_mode server;
  • vc_server https://voice-api.q2pro-x.com;
  • vc_mic_device "(default)";
  • vc_mic_enable 1;
  • vc_ptt_mode 1;
  • vc_input_gain 1.0;
  • vc_receive_volume 1.0;
  • vc_deafen 0.

Дальше настройте только микрофон, PTT key и громкость приёма.