Broadcast и OBS

MafiaSpace Broadcast показывает в OBS состав игры, фотографии, фолы и выделение говорящего. Судья ведёт игру в обычном приложении MafiaSpace на iPhone или Android. Роли и их цвета появляются только после разрешения судьи.

Основная загрузка для Windows — OBSpaceWin 0.2.16, программа для вашего уже установленного OBS. Для Apple Silicon доступна Mac beta 0.2.9 с отдельным статусом проверки. Все загрузки.

Перед началом

Нужны доступ к разделу «Трансляция» в кабинете клуба, интернет на компьютере и телефоне, настроенные камеры и звук в OBS. Подготовьте фотографии игроков и ночную заставку клуба в кабинете. Первый запуск проведите до прихода игроков: проверьте картинку и прослушайте короткую локальную запись.

Windows: OBSpaceWin для вашего OBS

Требования: Windows x64, установленный OBS 28+ с WebSocket 5 и Browser Source. Версия 0.2.16 поставляется как ZIP; OBS в него не входит. Программа подключается к открытому OBS, оставляя выбранную сцену, запись и эфир под управлением оператора. Пакет пока без Windows-подписи, приёмка клубного ноутбука ещё не завершена.

Установка и подключение

1. Скачайте OBSpaceWin и распакуйте весь ZIP в отдельную папку на локальном диске. Запустите Запустить плашки.cmd из распакованной папки.
2. Оставьте ваш OBS открытым. В OBS откройте «Инструменты» → «Настройки obs-websocket», включите сервер и авторизацию. Если он уже настроен, используйте текущие порт и пароль.
3. Укажите порт и пароль в окне OBSpaceWin, нажмите «Подключить OBS» и выберите существующую сцену с камерами. Пароль OBS никому не присылайте.
4. Нажмите «Добавить / проверить плашки». Новый источник сначала скрыт.
5. В кабинете клуба откройте «Трансляция», выберите текущую игру и введите код из окна OBSpaceWin. При сохранённой привязке клуба новый код перед каждым вечером не нужен.
6. Сверьте состав, фото и порядок мест. В паузе нажмите «Показать в эфире» или включите видимость нашего источника в OBS.

Камера, микрофон и Авто

На вкладке «Камера и микрофон» сначала нажмите «1. Обновить список источников выбранной сцены». Выберите существующие камеру и микрофон, затем нажмите «Подготовить управление». Программа подготовит скрытую ночную заставку и выключенный чёрно-белый фильтр. Каждый запуск начинается в режиме «Ручной».

После проверки записи включите «Авто» при свежих данных игры. В открытой ночи весь кадр выбранной сцены становится чёрно-белым, микрофон выключается. В закрытой ночи заставка скрывает кадр и плашки, микрофон также выключен. Если картинка не загрузилась, используется непрозрачный тёмный фон. Дневные речи и голосование возвращают стол и включают выбранный микрофон. После результата показывается заставка ожидания следующей игры.

Авто управляет одним выбранным микрофоном и ночными эффектами. Музыку, остальные аудиоисточники и переключение сцен настраивает оператор в OBS. Команда микрофона повторяется во время Авто: для ручного управления сначала нажмите «Ручной». Кнопка останавливает автоматику, сохраняя текущий кадр и звук. «День / вернуть» снимает ночные эффекты и восстанавливает сохранённое состояние с учётом ручных изменений.

Обновление программы и оформления

Программу обновляйте в паузе: сохраните прежнюю папку для отката, распакуйте новый ZIP в новую папку, завершите старую копию кнопкой «Завершить программу» и запустите новую. Крестик только сворачивает окно; две копии одновременно не запускайте. OBS, запись и эфир могут оставаться открытыми.

Сохраните %LOCALAPPDATA%\MafiaSpace\GraphicsOnly и данные Windows Credential Manager: там находятся настройки и привязка. Подключите OBS прежними портом и паролем, выберите ту же сцену, проверьте плашки и подготовьте управление. После перезапуска режим снова «Ручной»; текущая ночь и mute могут сохраниться до вашей команды.

Оформление обновляется отдельно на вкладке «Оформление». Если плашки уже открыты, нажмите «Применить в паузе» после проверки. До первого открытия плашек проверенная версия может примениться автоматически. «Вернуть предыдущее оформление» позволяет откатить внешний вид; без интернета используется сохранённая версия. Для новых действий судьи интернет всё равно нужен.

Если пропала связь

Проверьте, какая связь отсутствует: с игрой на сервере или с OBS. При временном обрыве программа повторяет подключение и сохраняет намерение Авто; текущий кадр и звук остаются. После восстановления и проверки свежих данных управление может продолжиться само. Устаревшие роли и выделение говорящего скрываются.

1. Если требуется ручное управление, нажмите «Ручной» и настройте OBS вручную. Судья продолжает игру в приложении.
2. Проверьте интернет на обоих устройствах и актуальную игру в кабинете. Для ошибки OBS проверьте включённый WebSocket, порт, пароль и доступность OBS.
3. Убедитесь, что выбранная сцена является текущей сценой эфира, а выбранные камера и микрофон существуют. Другая сцена или исчезнувший источник блокируют команды.
4. После восстановления сверяйте фазу, игрока и звук. Если вы включали «Ручной», заново включите «Авто» только после проверки. При отзыве привязки подключите клуб заново.

Локальный кэш оформления помогает сохранить картинку; новые события без сервера не поступают. Для закрытой ночи при ручном управлении проверьте заставку и mute сами.

Mac: графика для вашего OBS — beta

Версия 0.2.9, Apple Silicon, macOS 14+. Intel Mac этим пакетом не поддерживается. ZIP содержит MafiaSpace Graphics.app; требуется свой OBS с WebSocket 5 и Browser Source. Это отдельная beta, а не Windows 0.2.16: её статус и поведение проверяйте отдельно.

1. Скачайте Mac beta, распакуйте ZIP, перенесите MafiaSpace Graphics.app в «Программы» и откройте.
2. В открытом OBS включите WebSocket, подключитесь из программы текущими портом и паролем, выберите сцену и подготовьте плашки. Новый источник сначала скрыт.
3. Подтвердите код из программы в разделе «Трансляция» кабинета клуба. На локальной записи нажмите «Показать в эфире» и проверьте плашки.
4. На вкладке «Камера и микрофон» сначала нажмите «1. Обновить список источников выбранной сцены», выберите камеру и микрофон, затем нажмите «Подготовить управление». Запуск начинается в ручном режиме; Авто включайте отдельно после проверки.

Отображение графики в macOS OBS ещё не принято. Окно программы, Keychain и кэш проверены; управление OBS проверено в изолированной тестовой среде. В тестовом OBS 32.2.2 Browser Source оставался пустым, в том числе с обычной локальной HTML-страницей. До использования в эфире проверьте плашки, ночную заставку и звук в своём OBS. Физическая приёмка остаётся pending.

Приложение без Developer ID и нотариального заверения Apple. Если macOS блокирует первый запуск, используйте штатное разрешение в «Системные настройки» → «Конфиденциальность и безопасность» → «Всё равно открыть». Защиту macOS не отключайте.

При обновлении завершите прежнюю программу её кнопкой и сохраните старую копию для отката. Не удаляйте ~/Library/Application Support/MafiaSpace/GraphicsOnly и привязку в Keychain. Оформление применяйте в паузе на вкладке «Оформление».

Проверка перед эфиром

На короткой локальной записи проверьте правильный состав, фото, фолы и выделение говорящего. Роли должны быть скрыты до разрешения судьи. При подготовленном управлении проверьте открытый и закрытый ночной режим, возврат дня и выбранный микрофон. Прослушайте запись: движение шкалы микшера не доказывает наличие звука в файле.

Проверяйте события по ходу настоящей игры или в отдельной тестовой игре. Не добавляйте несуществующие действия в протокол действующей партии. После перезапуска программы сверьте источники и ручной режим до включения Авто. Автоматические тесты и доступность загрузки не заменяют проверку камеры, микрофона и записи на компьютере клуба.

Экспериментальные нативные пакеты

Эти пакеты используют панель внутри OBS и другой порядок установки. Для обычного подключения к своему OBS начните с инструкций OBSpaceWin или Mac beta выше.

Windows: полный нативный пилот 0.1.1

Пакет Windows x64 содержит отдельный OBS 32.1.2. Известно зависание при закрытии OBS в компоненте CEF; штатное завершение ещё требует исправления и проверки. Приёмка оборудования клуба не завершена. Этот пакет предназначен для отдельного экспериментального тестирования.

Распакуйте весь ZIP, закройте обычный OBS клуба и запустите Start-Theatrum.cmd. Выберите коллекцию сцен: пакет создаёт её копию. В панели MafiaSpace Broadcast нажмите «Настроить сцену и звук», выберите сцену, музыку и источники для отключения ночью, затем перезапустите пилот. Набор источников после первого применения пока не меняется. Код показывается в панели OBS; подтвердите его в кабинете клуба, сверьте игру и включите AUTO. HOLD останавливает автоматику; после потери связи вернитесь в AUTO только после проверки.

Ключи эфира обычного OBS не переносятся. Начните с локальной записи в папке Recordings пакета. Windows-подписи нет; при блокировке запуска обратитесь к организатору пилота, сохраняя защиту Windows включённой.

Mac: полный нативный пилот 0.1.0

Требования этого отдельного пакета: Apple Silicon, macOS 26+ и OBS 32.1.2 arm64. Установщик PKG без Developer ID и заверения Apple; установка после скачивания браузером и физическая приёмка остаются pending.

Закройте OBS, установите PKG и откройте OBS. В панели MafiaSpace Broadcast выберите «Настроить сцену и звук», укажите сцену, музыку и хотя бы один другой аудиоисточник. Перезапустите OBS. Подтвердите код из панели в кабинете клуба, сверьте игру и включите AUTO. Для ручного управления используйте HOLD. Проверьте локальную запись в папке, заданной в OBS. При блокировке установщика обратитесь к организатору пилота.

Плагин устанавливается для текущего пользователя в ~/Library/Application Support/obs-studio/plugins/mafiaspace-broadcast.plugin. Для удаления закройте OBS и удалите только этот плагин. Сцены и ключи эфира сохраняются; Python отдельно устанавливать не нужно.