Stream Deck для графики OBS: одна кнопка на каждую графику

Плагин OBS для Stream Deck переключает сцены и скрывает источники, но не может изменить то, что написано на графике. В этом руководстве мы настроим кнопки, которые это умеют: титр гостя, гол хозяев, часы матча, следующий пункт раскадровки — каждое одним нажатием, и каждая кнопка показывает, в эфире ли её графика.

Переключение сцен и управление графикой — в чём разница

Большинство начинает с того, что включает и выключает видимость источника-картинки со Stream Deck. Это работает, пока графике не понадобится другой текст: новый гость, новый счёт, другой заголовок. В итоге — отдельный источник на каждый вариант и панель, забитая одинаковыми на вид кнопками.

Графический движок переворачивает эту схему. В OBS остаётся один прозрачный браузерный источник, а кнопки обращаются не к OBS, а к графическому движку. Кнопка говорит выведи титр или хозяева +1; анимацию и текст берёт на себя движок. OBS об этом даже не узнаёт.

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

CueFinch, запущенный на стриминговом ПК, и страница вывода, добавленная в OBS как браузерный источник (как её добавить).
Stream Deck (любая модель, включая Stream Deck Mobile) и бесплатное приложение Stream Deck от Elgato версии 7.1 или новее (Windows 10+ или macOS 12+).
Плагин CueFinch для Stream Deck — его можно скачать в самом приложении: Подготовка → Подключения.

Настройка по шагам

В CueFinch откройте Подготовка → Подключения и нажмите Создать ключ и включить. Так включается локальный HTTP API, через который работают кнопки; без ключа он остаётся выключенным.
На карточке Плагин Stream Deck нажмите Скачать плагин и дважды щёлкните файл CueFinch.streamDeckPlugin. Приложение Stream Deck установит его, и в списке действий появится категория CueFinch.
Перетащите любое действие CueFinch на кнопку. В поле Подключение вверху её настроек введите адрес сервера — http://localhost:5275, если Stream Deck и CueFinch на одном ПК; для другого ПК достаточно его сетевого адреса, порт добавится сам — и вставьте API-ключ. Нажмите Проверить связь. Это вводится один раз: все остальные кнопки используют те же данные.
Выберите, что делает кнопка: выводит или убирает графику, меняет счёт, управляет часами, даёт событие матча, двигается по раскадровке или убирает всё.
Откройте в CueFinch страницу Эфир и держите её открытой всю трансляцию. Нажатия кнопок выполняет именно она — так же, как если бы вы нажали её собственные кнопки.

Раскладка кнопок для матча

Для полноценной футбольной трансляции с комментарием хватает пятнадцати кнопок. Раскладка, которая хорошо себя показывает:

Верхний ряд: табло вкл/выкл · часы матча старт/стоп · состав · убрать всё.
Средний ряд: гол хозяев · гол гостей · хозяева −1 · гости −1 (для отменённого гола).
Нижний ряд: жёлтая карточка · красная карточка · замена · титр · следующий пункт раскадровки.

Поставьте убрать всё в угол, подальше от кнопок, которые вы жмёте в спешке. Она одним нажатием снимает всю графику — именно то, что нужно в экстренной ситуации, и именно то, чего не хочется сделать случайно.

Кнопки, которые показывают эфир

Плагин постоянно спрашивает у CueFinch, что сейчас на экране. На Stream Deck + энкодеры меняют счёт: поворот — по одному голу, нажатие — на заданный шаг. Кнопка графики горит красным, пока её графика в эфире, кнопка счёта показывает текущий счёт, а кнопка часов — идущее время. Когда вы посреди фразы опускаете взгляд, панель показывает состояние эфира, а не просто набор кнопок.

Если CueFinch закрыт, страница «Эфир» не открыта или ключ неверный, кнопка показывает предупреждение, а не молча ничего не делает.

Bitfocus Companion и другие контроллеры

Каждое действие — это ещё и обычный веб-адрес, поэтому графикой может управлять всё, что умеет отправлять HTTP-запросы. В Bitfocus Companion добавьте подключение Generic HTTP и назначьте кнопке GET-действие, например http://localhost:5275/api/v1/object/score/toggle, с ключом в заголовке X-Api-Key (или ?key= в адресе). Это обычный путь в студиях, где Companion уже управляет микшером ATEM.

Stream Deck нет совсем? Встроенный пульт для телефона и планшета даёт те же кнопки на сенсорном экране.

Проблемы и решения

Кнопки показывают «НЕТ СВЯЗИ». Откройте адрес сервера в браузере на том же ПК. Если ничего не загружается, CueFinch не запущен или использует другой порт.
«ПАНЕЛЬ ЗАКРЫТА». Страница «Эфир» не открыта. Откройте её в браузере и не закрывайте вкладку.
«НЕВЕРНЫЙ КЛЮЧ». Ключ API был создан заново. Вставьте новый ключ в настройки любой кнопки CueFinch.
Stream Deck на другом ПК. Вместо localhost укажите сетевой адрес стримингового ПК (он есть в разделе Подготовка → Подключения) и разрешите порт 5275 в брандмауэре Windows для частных сетей.

Пусть графика будет под пальцами. Скачайте бесплатную бету, создайте API-ключ и назначьте первую кнопку за пару минут.

Скачать бесплатную бету

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

Может ли Stream Deck изменить текст графики в OBS?

Одним плагином OBS — нет: он умеет только показывать, скрывать и переключать. Если за браузерным источником стоит графический движок, кнопка может изменить счёт, вывести другой титр или запустить часы, потому что она обращается к движку, а не к OBS.

Нужен ли интернет для плагина Stream Deck?

Нет. Плагин общается с CueFinch на вашем ПК или в локальной сети. Никакие облачные сервисы не участвуют.

Работает ли это со Stream Deck Mobile?

Да. Stream Deck Mobile запускает те же плагины, что и железо. Кроме того, можно пользоваться собственным пультом CueFinch для телефона — ему не нужно никаких дополнительных приложений.

Можно вместо этого использовать Bitfocus Companion?

Да. Каждое действие — это HTTP-адрес, поэтому его может вызвать модуль Generic HTTP в Companion. Многие студии через Companion управляют графикой и микшером ATEM с одной кнопки.