OBS Studio
Входит в Macro DeckПереключайте сцены, управляйте трансляцией, записью и звуком и реагируйте на то, что происходит в OBS Studio.
Диалог «Подключение OBS Studio» с названием настройки, хостом, портом и паролем
- Переключение сцен, профилей и коллекций сцен
- Запуск и остановка трансляции, записи, буфера повтора и виртуальной камеры
- Выключение звука входов, настройка громкости, переключение источников и фильтров
- Живые переменные для сцен, таймкодов, FPS и потерянных кадров
- Подключение нескольких экземпляров OBS одновременно
Интеграция OBS Studio подключает Macro Deck к OBS через встроенный в OBS сервер WebSocket (obs-websocket 5). После подключения ваши кнопки могут управлять почти всем, что вы делаете в OBS во время трансляции, а OBS сообщает обо всех изменениях, поэтому на панели всегда видно текущее состояние.
Что можно делать
- Переключать программную сцену, сцену предпросмотра в режиме студии, профиль или коллекцию сцен.
- Запускать, останавливать или переключать трансляцию, запись, буфер повтора и виртуальную камеру, сохранять повтор, ставить запись на паузу, разделять файл записи или добавлять маркер главы.
- Показывать или скрывать источник в сцене, включать или выключать фильтр, выключать звук входа или менять его громкость в процентах или дБ.
- Менять параметр источника, например текст текстового источника, файл источника изображения или медиа либо URL источника браузера.
- Запускать и останавливать любой вывод OBS по имени, включая выводы, добавленные плагинами.
Несколько примеров:
- Кнопка BRB, которая переключает на сцену BRB и выключает микрофон.
- Кнопка Запись, которая включает и выключает запись и показывает, идёт ли запись, стоит ли она на паузе или остановлена.
- Ползунок, привязанный к переменной
obs_<input>_volumeмузыкального входа: двигайте ползунок, и громкость в OBS меняется. - Цепочка действий, которая запускается, когда OBS сообщает Трансляция начата, и присылает вам уведомление.
Как это работает
Macro Deck слушает события, которые отправляет OBS, поэтому такие переменные, как текущая сцена, состояние звука и фильтров, обновляются за доли секунды после изменения в OBS. Кнопки-переключатели подсвечиваются, пока их состояние активно, даже если вы меняете его в самом OBS. Статистика, например FPS, загрузка ЦП, битрейт и потерянные кадры, считывается каждые одну-две секунды.
Помимо постоянных переменных, в окне выбора переменной перечислены все входы, сцены, элементы сцен и фильтры подключённого OBS с их громкостью, состоянием звука, видимостью или состоянием включения. Триггеры реагируют на смену сцены, изменения записи и трансляции, сохранённые повторы и снимки экрана, активацию входов и пользовательские события, которые рассылают ваши собственные скрипты OBS.
Можно добавить несколько настроек, например одну для ПК для трансляций и одну для игрового ПК. Каждая настройка получает собственный набор переменных, а у каждого действия есть поле Настройка, в котором выбирается, каким OBS оно управляет. Когда OBS закрывается или пропадает сеть, Macro Deck продолжает попытки переподключиться и срабатывают триггеры Отключено и Подключено.
Что понадобится
- Macro Deck 3 в Windows, macOS или Linux
- OBS Studio 28 или новее (включает obs-websocket 5)
- Сервер WebSocket, включённый в OBS в разделе Tools > WebSocket Server Settings
- Для запуска и остановки выводов по имени нужен obs-websocket 5.7 или новее
Настройка
Шаг 1: Включите сервер WebSocket в OBS
В OBS откройте Tools > WebSocket Server Settings и отметьте Enable WebSocket server. Запомните Server Port (по умолчанию
4455). Если отмечено Enable Authentication, нажмите Show Connect Info, чтобы увидеть пароль.Шаг 2: Откройте OBS Studio в Macro Deck
В Macro Deck нажмите Интеграции на боковой панели и выберите OBS Studio. На вкладке Обзор нажмите Добавить настройку в разделе Настройка. Если включить переключатель в правом верхнем углу, откроется тот же диалог, а интеграция включится после завершения настройки.
Шаг 3: Введите данные подключения
Заполните диалог Подключение OBS Studio:
- Название настройки: любое название, например
Streaming PC. - Хост:
127.0.0.1, если OBS работает на этом же компьютере, иначе IP-адрес компьютера, на котором запущен OBS. - Порт: порт сервера из OBS, по умолчанию
4455. - Пароль: пароль из OBS. Оставьте поле пустым, если аутентификация выключена.
Нажмите Продолжить. Macro Deck проверяет подключение, прежде чем сохранить настройку.
- Название настройки: любое название, например
Шаг 4: Добавьте действие OBS на кнопку
На странице Панель нажмите на кнопку, которую хотите использовать. Панель должна быть разблокирована: если кнопка в правом верхнем углу называется Заблокировать, панель разблокирована. Откроется редактор, в котором выбран триггер Короткое нажатие. Нажмите + Добавить действие, слева в диалоге Добавить действие выберите OBS Studio и затем действие, например Установить сцену. Выберите значения в полях Настройка и Сцена и нажмите Сохранить.
Шаг 5: Нажмите кнопку
Нажмите кнопку на телефоне, планшете или в веб-клиенте. OBS переключится на выбранную сцену. Если ничего не происходит, проверьте, что OBS запущен и что настройка показывает статус Подключено на странице OBS Studio в разделе Интеграции.
Действия35
Назначьте их на кнопку или запускайте из цепочки действий.
- Установить сцену
- Переключает активную программную сцену.
- Сцена предпросмотра
- Переключает сцену предпросмотра в режиме студии.
- Установить профиль
- Переключает OBS на другой профиль.
- Установить коллекцию сцен
- Переключает OBS на другую коллекцию сцен.
- Начать запись
- Начинает запись.
- Остановить запись
- Останавливает запись.
- Переключить запись
- Начинает или останавливает запись и показывает, идёт ли запись, стоит ли она на паузе или остановлена.
- Пауза и продолжение записи
- Ставит текущую запись на паузу или продолжает её.
- Начать трансляцию
- Запускает трансляцию.
- Остановить трансляцию
- Останавливает трансляцию.
- Переключить трансляцию
- Запускает или останавливает трансляцию.
- Запустить виртуальную камеру
- Запускает виртуальную камеру.
- Остановить виртуальную камеру
- Останавливает виртуальную камеру.
- Переключить виртуальную камеру
- Запускает или останавливает виртуальную камеру.
- Запустить буфер повтора
- Запускает буфер повтора.
- Остановить буфер повтора
- Останавливает буфер повтора.
- Переключить буфер повтора
- Запускает или останавливает буфер повтора.
- Сохранить буфер повтора
- Сохраняет текущий буфер повтора на диск.
- Разделить файл записи
- Начинает новый файл записи, не прерывая запись.
- Создать главу записи
- Добавляет маркер главы в записываемый файл (только в формате Hybrid MP4).
- Задать папку записи
- Задаёт папку, в которую OBS сохраняет новые записи.
- Запустить вывод
- Запускает вывод OBS по имени, включая выводы, добавленные плагинами.
- Остановить вывод
- Останавливает вывод OBS по имени, включая выводы, добавленные плагинами.
- Переключить вывод
- Запускает или останавливает вывод OBS по имени, включая выводы, добавленные плагинами.
- Получить состояние вывода
- Записывает в переменную, активен ли вывод OBS.
- Видимость источника
- Показывает, скрывает или переключает источник в сцене.
- Звук входа
- Выключает, включает или переключает звук аудиовхода.
- Громкость входа
- Задаёт, увеличивает или уменьшает громкость аудиовхода в процентах или дБ.
- Фильтр источника
- Включает, выключает или переключает фильтр источника.
- Задать параметр источника
- Меняет один параметр источника, например текст текстового источника или URL источника браузера.
- Получить громкость входа
- Записывает в переменную громкость аудиовхода в процентах.
- Получить состояние фильтра
- Записывает в переменную, включён ли фильтр источника.
- Получить состояние звука входа
- Записывает в переменную, выключен ли звук аудиовхода.
- Получить видимость источника
- Записывает в переменную, виден ли источник в сцене.
- Переключить режим студии
- Включает или выключает режим студии.
Триггеры24
Кнопка или цепочка действий может реагировать на эти события.
- Сцена изменилась
- Изменилась программная (живая) сцена. При желании только для одной сцены.
- Сцена предпросмотра изменилась
- Изменилась сцена предпросмотра в режиме студии.
- Запись начата
- OBS начал запись.
- Запись остановлена
- OBS остановил запись.
- Запись приостановлена
- Запись поставлена на паузу.
- Запись возобновлена
- Запись возобновлена.
- Файл записи изменён
- Запись началась, перешла в новый файл или остановилась, с путём к файлу.
- Трансляция начата
- OBS начал трансляцию.
- Трансляция остановлена
- OBS остановил трансляцию.
- Буфер повтора запущен
- Буфер повтора запущен.
- Буфер повтора остановлен
- Буфер повтора остановлен.
- Буфер повтора сохранён
- Клип повтора записан на диск, с путём к файлу.
- Снимок экрана сохранён
- OBS сохранил снимок экрана на диск, с путём к файлу.
- Виртуальная камера запущена
- Виртуальная камера запущена.
- Виртуальная камера остановлена
- Виртуальная камера остановлена.
- Режим студии изменился
- Режим студии включён или выключен.
- Звук входа изменился
- Звук аудиовхода выключен или включён. При желании только для одного входа.
- Вход стал активным
- Вход начал отображаться в программном выводе, например когда включается веб-камера.
- Вход стал неактивным
- Вход перестал отображаться в программном выводе.
- Вход начал показываться
- Вход начал отображаться в программном выводе или в предпросмотре.
- Вход перестал показываться
- Вход больше не отображается в программном выводе или в предпросмотре.
- Пользовательское событие
- Скрипт или плагин OBS разослал пользовательское событие. При желании только для одного имени события.
- Подключено
- Macro Deck подключился к OBS, и OBS завершил загрузку.
- Отключено
- Подключение к OBS потеряно.
Переменные14
Показывайте эти значения на кнопках и виджетах или используйте их в условиях.
obs_<configuration>_is_connected- Подключён ли Macro Deck к этому OBS.
obs_<configuration>_current_scene- Активная программная сцена.
obs_<configuration>_preview_scene- Сцена предпросмотра в режиме студии.
obs_<configuration>_current_profile- Активный профиль.
obs_<configuration>_current_scene_collection- Активная коллекция сцен.
obs_<configuration>_is_recording,obs_<configuration>_recording_paused,obs_<configuration>_recording_timecode- Идёт ли запись или стоит ли она на паузе и как долго она длится.
obs_<configuration>_is_streaming,obs_<configuration>_streaming_timecode- Идёт ли трансляция и как долго.
obs_<configuration>_virtual_camera_active,obs_<configuration>_replay_buffer_active,obs_<configuration>_studio_mode_active- Включены ли виртуальная камера, буфер повтора и режим студии.
obs_<configuration>_fps,obs_<configuration>_max_fps,obs_<configuration>_cpu_usage- Показатели производительности, которые сообщает OBS.
obs_<configuration>_streaming_bitrate,obs_<configuration>_recording_bitrate- Текущий битрейт выводов в кбит/с.
obs_<configuration>_dropped_frames,obs_<configuration>_dropped_frames_percent,obs_<configuration>_skipped_frames,obs_<configuration>_skipped_frames_percent- Потерянные кадры трансляции и кадры, пропущенные кодировщиком, в штуках и в процентах.
obs_<configuration>_last_recording_file,obs_<configuration>_last_screenshot- Путь к последнему файлу записи и снимку экрана.
obs_<input>_volume,obs_<input>_mutedи другие- Для каждого выбранного входа: громкость в дБ (доступна для записи, поэтому её может задавать ползунок), выключен ли звук, активен ли вход, показывается ли он, аудиодорожки (от
obs_<input>_track_1до_6), тип мониторинга, сдвиг синхронизации и его параметры. Окно выбора предлагает эти имена, их можно изменить. obs_<scene>_<source>_visible,obs_<source>_<filter>_enabled- Виден ли источник в сцене и включён ли фильтр. Окно выбора предлагает эти имена, их можно изменить.
Часто задаваемые вопросы
Работает ли это, если OBS запущен на другом компьютере?
Да. Укажите IP-адрес компьютера с OBS в поле Хост и разрешите порт (по умолчанию 4455) в брандмауэре этого компьютера. Пути в таких действиях, как Задать папку записи или Задать параметр источника, относятся к компьютеру, на котором работает OBS.
Можно ли управлять несколькими OBS?
Да. Добавьте по одной настройке на каждый экземпляр OBS кнопкой Добавить настройку. У каждой свои переменные, а у каждого действия есть поле Настройка, в котором выбирается нужный OBS.
Что происходит, когда OBS закрывается или подключение обрывается?
Macro Deck продолжает попытки переподключиться в фоне и снова подключается, как только OBS становится доступен. До этого действия завершаются с ошибкой Нет подключения к OBS., а триггеры Отключено и Подключено срабатывают, чтобы цепочка действий могла на это отреагировать.
Почему действие не выполняется?
Действие показывает причину, например что сцена или источник больше не существует, что OBS ещё загружает коллекцию сцен или что OBS не ведёт запись (для действий Разделить файл записи и Создать главу записи). Если вы что-то переименовали в OBS, выберите это в действии заново.
Где хранится пароль WebSocket?
Macro Deck хранит пароль в зашифрованном виде на компьютере, на котором работает Macro Deck, и использует его только для подключения к OBS.
Ещё в группе «Трансляции»
Meld Studio
Входит в Macro DeckПереключайте и подготавливайте сцены, управляйте слоями, эффектами и аудиодорожками и выходите в эфир в Meld Studio.
Streamlabs Desktop
Входит в Macro DeckПереключайте сцены, управляйте трансляцией, записью и источниками звука в Streamlabs Desktop.
Streamer.bot
Входит в Macro DeckЗапускайте действия Streamer.bot, отправляйте сообщения в чат и реагируйте на любое событие, о котором сообщает Streamer.bot.
Twitch
Входит в Macro DeckПоказывайте чат и статистику трансляции Twitch, модерируйте, проводите опросы и запускайте рекламу, реагируйте на фолловы, подписки и рейды.
YouTube
Входит в Macro DeckПоказывайте чат и статистику прямой трансляции YouTube, меняйте название и теги и реагируйте на Super Chat и новых спонсоров.