Горячие клавиши OBS: пять рабочих сценариев

Страница поможет выбрать подходящий способ управлять счётчиками через API v2 прямо во время трансляции. Читайте сверху вниз и выбирайте вариант, который подходит под ваше оборудование.

Что подготовить

• OBS 28 или новее.
• Активный токен и slug счётчика из раздела «OBS → Integrations».
• Опционально: Stream Deck, Touch Portal или клавиатура с F13–F24.

curl -X POST "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" \
  -H "Content-Type: application/json" \
  -d '{"action":"increment","value":1}'  # +1

curl -X POST "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" \
  -H "Content-Type: application/json" \
  -d '{"action":"decrement","value":1}'  # -1

curl -X POST "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" \
  -H "Content-Type: application/json" \
  -d '{"action":"reset"}'  # сброс

Способ 2. Stream Deck или Touch Portal

Подходит, если удобнее нажимать физические кнопки или использовать планшет. По сути мы вызываем тот же URL, что и в макросах.

1. Откройте приложение Stream Deck.
2. Перетащите действие System → Website (или аналог в Touch Portal).
3. Для каждой кнопки вставьте нужную ссылку. Название и иконку задайте по желанию.

• +1: https://vsestream.live/api/v2/counter/TOKEN/SLUG/?action=increment&value=1
• -1: https://vsestream.live/api/v2/counter/TOKEN/SLUG/?action=decrement&value=1
• Сброс: https://vsestream.live/api/v2/counter/TOKEN/SLUG/?action=reset

Stream Deck выполняет запрос даже без открытого OBS, так что можно обновлять счётчик заранее.

Способ 3. AutoHotkey (Windows)

Если хотите глобальные горячие клавиши, которые работают поверх игры. Скрипт включает всплывающие уведомления, чтобы сразу видеть результат.

1. Установите AutoHotkey.
2. Создайте файл obs_counter_hotkeys.ahk и вставьте пример ниже, заменив TOKEN и SLUG.
3. Дважды кликните по файлу — иконка появится в системном трее. Добавьте ярлык в shell:startup, если нужен автозапуск.

; OBS Counter Hotkeys
API_BASE := "https://vsestream.live/api/v2/counter"
TOKEN := "TOKEN"
SLUG := "SLUG"

F13::Post("increment"), TrayTip("OBS Counter", "+1", 1)
F14::Post("decrement"), TrayTip("OBS Counter", "-1", 1)
F15::Post("reset"), TrayTip("OBS Counter", "reset", 1)

Post(action) {
    url := API_BASE "/" TOKEN "/" SLUG "/"
    body := Format("{\"action\":\"%s\"}", action)
    req := ComObjCreate("WinHttp.WinHttpRequest.5.1")
    req.Open("POST", url, false)
    req.SetRequestHeader("Content-Type", "application/json")
    req.Send(body)
}

Способ 4. Python-скрипт внутри OBS

Для тех, кто предпочитает полноценную интеграцию. Скрипт регистрирует хоткеи в настройках OBS, сохраняет токен и может реагировать на события.

• Скачайте готовый пример из markdown-версии руководства (/docs/obs_hotkeys_setup.md).
• Откройте Tools → Scripts, добавьте файл .py и заполните поля токена и slug.
• После добавления команды появятся в разделе Settings → Hotkeys. Назначьте удобные комбинации и протестируйте.

Этот вариант полезен, если уже используете OBS-скрипты или хотите обработку ошибок прямо в интерфейсе OBS.

Способ 5. Панель управления в Browser Source

Самый быстрый путь — добавить готовую панель и нажимать кнопки прямо в OBS. Хоткеи I / O / R работают в пределах окна браузера.

1. В OBS добавьте источник Browser и укажите ссылку вида https://vsestream.live/api/v2/control/TOKEN/SLUG/.
2. Размер 500×640, включите «Shutdown source when not visible» и «Refresh browser when scene becomes active».
3. Разместите панель на отдельной сцене «Controls» и переключайтесь на неё горячей клавишей OBS.

Как комбинировать

• Stream Deck + Advanced Scene Switcher: Stream Deck запускает базовые команды, а макросы следят за автоматикой (сцена активна, камера выключена и т. п.).
• AutoHotkey + панель: глобальные хоткеи из AHK обновляют счётчик, а Browser Source показывает текущее значение и кнопки для страховки.

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

OBS пишет, что команды не выполняются

Убедитесь, что curl установлен. В Windows 10+ он идёт из коробки. При первом запуске дайте OBS разрешение на выполнение.

Горячие клавиши не срабатывают

Используйте F13–F24 или комбинации с Ctrl/Shift. Проверьте, что эти клавиши не заняты в играх и не пересекаются с другими плагинами.

API возвращает 403/404

Проверьте токен и slug в карточке счётчика. Если создавали новый токен, обновите его во всех командах.

Нужна PowerShell-альтернатива curl

Команда выглядит так: Invoke-WebRequest -Uri "https://vsestream.live/api/v2/counter/TOKEN/SLUG/" -Method POST -Body '{"action":"increment"}' -ContentType "application/json".

Версия руководства: OBS Hotkeys v2. Обновлено для новой структуры документации.