PLGamesBot /Гайды/Голосовой агент
Войти
ИнструкцияВ эфире

Голосовой агент: управлять стримом голосом, не отрываясь от игры

Программа для Windows слушает микрофон по горячей клавише — прямо поверх полноэкранной игры. Говорите «сделай клип», «смени название на …» или «переключи сцену на игру» — агент выполняет команду и показывает в своём окне, что расслышал и что сделал. Руки остаются на управлении, момент не проходит мимо.

6 минут Обновлено Все тарифы
Содержание

Коротко

  • Включите Агент включён на странице Голосовой агент и скачайте там программу для Windows.
  • Подключите программу к каналу: Подключить через браузер, в кабинете — Разрешить этому компьютеру.
  • Нажмите Ctrl+Shift+V, даже посреди игры, и скажите команду: «сделай клип», «сколько зрителей».

Что понадобится

  • Компьютер с Windows 10 или новее и микрофон — тот же, в который вы говорите на стриме.
  • Вход в кабинет PLGamesBot через Twitch.
  • OBS 28 или новее — только чтобы переключать сцены и ставить виджеты из программы. Остальные команды работают и без OBS.
  • Для «напиши в чат» — включённый бот: сообщение уходит в чат от него.

Настройка за 5 шагов

  1. Включите агента

    Откройте в кабинете Голосовой агент и включите Агент включён. По умолчанию он выключен: агент умеет менять название канала и писать в чат, и пока тумблер выключен, программа не выполнит ни одной команды.

  2. Установите программу

    На той же странице нажмите Скачать для Windows и запустите скачанный файл. Программа установится сама, откроется и встанет значком в трей рядом с часами. Цифровой подписи у неё пока нет, поэтому:

    1. браузер может переспросить, сохранять ли файл, — подтвердите;
    2. Windows может показать «Windows защитил ваш компьютер» — нажмите «Подробнее», потом «Выполнить в любом случае».
  3. Подключите к каналу

    В окне программы нажмите Подключить через браузер. Откроется кабинет: проверьте, что код на странице совпадает с кодом в программе, и нажмите Разрешить этому компьютеру. Браузер не открылся — нажмите на странице Голосовой агент кнопку Код для приложения и введите код в программе: он действует 10 минут и работает один раз.

  4. Скажите первую команду

    Нажмите Ctrl+Shift+V — значок в трее покраснеет, идёт запись — и скажите «сколько зрителей». Замолчали — команда ушла; второе нажатие отправляет сразу. В окне программы видно, что агент расслышал и что сделал. Держать клавишу не нужно: «зажать и говорить» умеет кнопка Говорить в окне программы.

  5. Подключите OBS — для сцен и виджетов

    В OBS откройте меню «Инструменты» → настройки WebSocket-сервера, включите сервер и скопируйте пароль. В программе: Настройки → блок OBS → вставьте пароль. Теперь работает «переключи сцену на …», а на вкладке Виджеты в OBS программа сама добавит в текущую сцену отмеченные виджеты канала — ссылки из кабинета копировать не нужно.

«Слушать постоянно» — только с обращением по имениЕсли включить Слушать постоянно в окне программы, нажимать ничего не нужно, но фраза должна начинаться с имени: «Николай, сделай клип» или «ПЛГ, сделай клип». Сказанное без имени агент считает разговором со зрителями и молча пропускает. В этом режиме на распознавание уходит вся ваша речь в эфире, поэтому по умолчанию он выключен.
Панель PLGamesBot прямо в окне OBSВкладка Виджеты в OBS добавит PLGamesBot в OBS как док-панель. В ней команды можно набирать текстом, а голос остаётся за программой: OBS не даёт панелям доступ к микрофону.

Как это работает

Программа записывает фразу и отправляет её на сервер PLGamesBot. Там речь превращается в текст, агент находит в нём команду и выполняет её на вашем канале — тем же путём, что и кабинет. Сцену OBS переключает сама программа: сервер только называет её. Название сцены говорите так, как оно записано в OBS; не нашлось — агент перечислит, какие сцены есть.

Клип голосом режется так же, как по !клип в чате, и всегда записывается в Моменты. Агент ждёт несколько секунд: Twitch успел — ссылка сразу в окне программы; не успел — ссылка появится в Моментах, когда клип будет готов. Если Twitch клип принял, но так и не нарезал, бот вырежет тот же момент из записи эфира — при тех же условиях, что и для !клип.

Отключить компьютер можно на странице Голосовой агент — в списке подключённых кнопкой Отвязать: программа на нём перестанет работать, остальные компьютеры это не заденет. Обновления программа проверяет при запуске и раз в 6 часов, скачивает только с plgamesbot.ru и ставит по вашей кнопке Установить.

Что можно сказать

Агент понимает только эти команды — поговорить с ним, как с собеседником, нельзя. Остальное он не выполнит и ответит «Не понял. Скажите «что ты умеешь» — перечислю».

КомандаКак сказатьЧто сделает
Клип«сделай клип», «запиши момент»Клип последних секунд эфира — как !клип; ссылка ляжет в Моменты
Название стрима«смени название на прохождение первый раз»Меняет название трансляции на Twitch
Категория«смени игру на Elden Ring», «категория Just Chatting»Меняет игру или категорию трансляции
Сообщение в чат«напиши в чат сейчас будет перерыв»Бот отправит фразу в чат от своего имени
Что в чате«что там в чате»Покажет последние сообщения чата в окне агента
Сколько зрителей«сколько зрителей», «сколько онлайн»Ответ — в окне агента, в чат ничего не пишет
Сколько фолловеров«сколько фолловеров»Тоже только вам, не в чат
Сцена в OBS«переключи сцену на игру», «сцена перерыв»Переключает сцену — нужна связь с OBS
Музыка«пропусти трек», «выключи музыку», «включи музыку»Пропуск, пауза и продолжение плеера заказов
Справка и отмена«что ты умеешь», «отмена»Список команд; отмена начатой команды

Если не работает

Программа пишет «Агент выключен в настройках канала»

Включите Агент включён на странице Голосовой агент в кабинете.

Windows не даёт запустить установщик

Это предупреждение о программе без цифровой подписи. Нажмите «Подробнее» → «Выполнить в любом случае».

Нажимаю Ctrl+Shift+V — запись не начинается

Проверьте, что программа запущена: её значок в трее. Сочетание могла занять другая программа — назначьте своё в Настройки → Горячая клавиша.

«Ничего не расслышал»

Нажмите в окне программы Проверить микрофон и посмотрите, слышит ли она вас. Если нет — проверьте в Windows, какой микрофон выбран по умолчанию.

Сцена не переключается

Нужна связь с OBS: включите WebSocket-сервер в OBS и вставьте пароль в Настройки → OBS. Если связи нет, на вкладке Виджеты в OBS программа пишет, почему.

Частые вопросы

Голосовой агент платный?

Нет, он работает на всех тарифах и AI-лимиты не тратит.

Есть версия для Mac или телефона?

Пока только Windows. Панель PLGamesBot в OBS работает и на других системах, но команды в ней набираются текстом.

Агент отвечает голосом?

Нет, ответ появляется в окне программы. Значок в трее показывает, идёт ли запись.

Что изменилось

  • Новая инструкция: программа для Windows выложена — скачать её можно на странице «Голосовой агент».

Всё готово к настройке?Страница откроется в кабинете после входа через Twitch.

Открыть «Голосовой агент» →