Интеграции: TTS

Говорилка VseStream 2.0 озвучивает сообщения чата через Edge TTS на сервере. OBS получает готовые MP3 и воспроизводит их в браузерном источнике. Если движок недоступен — автоматически включается fallback на Web Speech API внутри OBS.

Быстрый старт для OBS

1. Откройте «OBS / Интеграции» в кабинете и включите тумблер Говорилка (TTS).
2. Нажмите кнопку «Настройки TTS» и дождитесь загрузки статуса движка (индикатор «Активен: Edge TTS»).
3. Скопируйте OBS Overlay URL кнопкой «Копировать».
4. В OBS добавьте Browser Source и вставьте ссылку. Рекомендуемые параметры: ширина 600, высота 400, Refresh browser when scene becomes active — включено.
5. В микшере OBS включите «Control audio via OBS» и при необходимости добавьте фильтр Compressor для выравнивания громкости.
6. Для звука без текста используйте кнопку «Копия (no text)» или добавьте к URL параметр ?no_text=1.

При утечке URL регенерируйте OBS токен — старая ссылка перестанет работать.

Настройки TTS

• Включено — мастер-переключатель. Даже при выключенном тумблере OBS может открываться, но очередь пустая.
• Голос — выпадающий список с русскими голосами Edge TTS (например, ru-RU-SvetlanaNeural). Если сохранённый голос не найден, он автоматически появится в списке как «custom».
• Скорость и Высота — проценты (50–200 и −50…+50). Преобразуются в SSML, поэтому относительно влияют на темп и тон.
• Мин / Макс длина — фильтр по количеству символов после очистки текста.
• Читать выделенные — всегда пропускает Highlighted Messages даже без allowlist.
• Только allowlist — жёстко ограничивает озвучку пользователями из списка ниже.
• Allowlist — один ник на строку. Регистр не важен.
• Тест озвучки — отправляет принудительное сообщение в очередь; удобно для проверки уровня звука в OBS.

Allowlist / Фильтры

• Режим «Только allowlist» ограничивает озвучку указанными пользователями.
• Отдельный флаг — озвучивать ли Highlighted (Channel Points).
• Команды (!cmd) и слишком короткие/длинные сообщения отфильтровываются по min/max длине.

Команды чата

Как работает движок

• Edge TTS — сервер генерирует MP3, кэширует 24 часа по хешу текста/голоса/параметров.
• OBS качает файл из API и проигрывает его. При сетевых сбоях происходит автоматический повтор.
• Web Speech fallback — включается, если Edge временно недоступен или сообщение принудительное.
• Индикатор в настройках показывает текущий статус и помогает диагностировать проблемы (зелёный — всё ок, жёлтый — fallback).

Поведение overlay

• Пуллинг очереди каждые ~3 секунды.
• Текст сообщений отображается списком (до 20 последних). С параметром ?no_text=1 визуал скрывается.
• После успешного воспроизведения сообщения помечаются как «прочитанные», чтобы не повторялись.
• Принудительные сообщения (кнопка «Тест») всегда играются через браузерный движок, чтобы быстро проверить звук.

Безопасность

Не делитесь overlay URL. При утечке воспользуйтесь кнопкой регенерации OBS токена — все старые ссылки потеряют доступ.

Версия: Integrations TTS v2