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 - сильное усиление.
Если собеседники слышат перегруз:
- уменьшите vc_input_gain;
- проверьте Windows input level;
- используйте 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 включался сам:
- vc_enable 1;
- vc_autojoin 1;
- vc_room_mode server;
- подключиться к игровому серверу.
Если вы вручную вышли через 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 и громкость приёма.