Руководство по док-панели управления OBS

Держите основные команды Social Stream внутри OBS, включая запуск, предпросмотр, проверку и сброс титров.

Быстрая настройка

  1. В Social Stream Ninja откройте Global settings and tools («Общие настройки и инструменты») → Механика.
  2. Открыть OBS Control Dock and copy its link. Keep Social Stream Ninja active during the stream.
  3. The copied link includes your session, password, and connection settings.
  4. В OBS откройте Док-панели → Пользовательские док-панели браузера.
  5. Назовите док-панель Управление Social Stream and paste the copied link. For a session without a password or server settings, the URL is:
https://socialstream.ninja/obs-control-dock.html?session=YOUR_SESSION_ID
  1. Выберите Применить, закройте окно настроек и расположите новую док-панель в OBS по своему усмотрению.
  2. Убедитесь, что док-панель показывает Подключено (Connected). Если сеанс не указан в URL, введите его в док-панели и выберите Сохранить и подключить.

Открыть док-панель управления

Какие серверные настройки нужны?

The generated control link follows Social Stream's connection settings. Normal links use P2P. When Док-панель отправляет команды расширению через сервер is enabled, controls use that server connection.

For a manually configured API connection, add &server (или &server=wss://YOUR_SERVER) and enable удалённое управление расширением через API.

OBS's Настройки сервера WebSocket не связаны с этим и могут оставаться выключенными.

Использование с финальными титрами

  1. Перед эфиром задайте для титров Режим запуска на Фоновый сбор. Это позволяет приложению собирать участников чата, платных подписчиков и дарителей, пока источник титров закрыт.
  2. Добавьте созданный URL титров в финальную сцену OBS с тем же идентификатором сеанса.
  3. В конце эфира сначала переключитесь на финальную сцену, чтобы источник титров загрузился и подключился.
  4. Выберите Запустить титры в док-панели управления OBS.
Загрузите перед запуском: фоновый сбор может работать при закрытой странице титров, но для запуска, предпросмотра и теста нужен подключённый источник «Браузер» с титрами.

См. Руководство по финальным титрам о режимах сбора, фильтрах и поиске причин отсутствующих имён.

Что делает каждая кнопка титров

КнопкаРезультат
Запустить титрыЗапускает настоящий собранный список.
ПредпросмотрЗапускает настоящий список, не расходуя записи, собранные страницей.
Проверить титрыПоказывает встроенные примеры участников, подписчиков и дарителей. Это не подтверждает сбор настоящих имён.
Сбросить сохранённые титрыОчищает сохранённый фоновый сбор для активного сеанса Social Stream.

Товары и ссылки поддержки

В Social Stream откройте монетизацию, сохраните и включите товары, затем выберите Открыть док-панель управления OBS. Скопируйте этот приватный URL управления в пользовательские док-панели браузера OBS. Для док-панели только с товарами используйте obs-control-dock.html?session=YOUR_SESSION_ID&commerce.

Keep Social Stream on and use the generated Product Controls link. Add the separate monetization overlay URL as an OBS Browser Source for viewers. The control dock is for you; never share its session URL with viewers.

Управление товарами в OBS: выбор сохранённого товара, длительность, показ, следующий товар, скрытие, возобновление расписания и состояние выбранного товара
  • Показать: выбрать сохранённый товар и закрепить его. Следующий: перейти к следующему товару.
  • Скрыть товары: скрыть рекламные карточки; оповещения об активности продолжаются. Продолжить расписание: вернуться к сохранённому первому товару или настройке чередования.
  • Длительность: Команды «Показать», «Следующий» и «Скрыть» возвращаются к сохранённому расписанию через указанное число секунд. Значение 0 сохраняет ручной режим до следующего изменения.
  • Состояние: обновляется каждые пять секунд, пока раздел открыт. Оно сообщает о выборе Social Stream, а не о видимости сцены OBS. При потере или неподтверждённом подключении кнопки товаров отключаются до получения состояния.

Док-панель, меню, Stream Deck и Event Flow используют общее управление. Редактируйте и сохраняйте каталог в Social Stream. См. Управление товарами для настройки и автоматизации.

Другие команды и необходимые страницы

  • Выбранное сообщение: держите обычную док-панель чата и оверлей выбранного сообщения подключёнными к одному сеансу.
  • Таймер: держите страницу таймера подключённой к тому же сеансу, если она должна показывать таймер.
  • Список ожидания и розыгрыш: сначала настройте список ожидания в Social Stream; сброс очищает текущие записи.

При обрыве API док-панель подключается автоматически. Зелёный Подключено (Connected) статус подтверждает только подключение управления; для команды показа целевая страница всё равно должна быть открыта.

Примеры прямого API

Те же кнопки можно вызывать скриптом через HTTP GET:

https://io.socialstream.ninja/SESSION_ID/creditsStart
https://io.socialstream.ninja/SESSION_ID/creditsPreview
https://io.socialstream.ninja/SESSION_ID/creditsTest
https://io.socialstream.ninja/SESSION_ID/creditsReset

Замените SESSION_ID на активный сеанс Social Stream. См. Команды и API или полную тестовую среду API для других действий.

Устранение неполадок

  • Нужен сеанс: используйте точный идентификатор сеанса Social Stream без слова session=.
  • Отключено: confirm Social Stream is active and reopen the generated control link after changing connection settings.
  • Титры сообщают, что ни один источник не принял команду: покажите финальную сцену, дождитесь загрузки её источника браузера и повторите попытку.
  • Тест работает, но запуск пуст: Тест использует встроенные имена. До эфира выберите фоновый сбор и убедитесь, что обычные источники чата захватывают сообщения.
  • Кнопка выбранного сообщения не даёт видимого эффекта: убедитесь, что док-панель чата и оверлей выбранного сообщения загружены и используют один сеанс.