Social Stream Ninja
Русский
EnglishEspañolPortuguês (Brasil)РусскийFrançaisDeutsch日本語简体中文繁體中文ItalianoPolski한국어УкраїнськаالعربيةTürkçeČeštinaไทย

Сеансы, пароли, ретрансляция и серверные режимы

Одинаковый сеанс соединяет источники, док-панели, оверлеи, оповещения и страницы API. Флаги маршрутизации тоже должны совпадать.

Модель подключения

  1. Источник захватывает чат или событие и публикует его в сеанс Social Stream.
  2. Док-панель, оверлей выбранных сообщений, Multi Alerts, Event Flow и другие страницы подключаются к этому же сеансу.
  3. Если пароль задан, все подключаемые страницы должны использовать тот же пароль.
  4. Если включена серверная маршрутизация, активным страницам нужны новые URL с соответствующими параметрами.
Source → same session ID + password + routing mode → Dock / overlay / API consumer

Идентификатор сеанса и пароль

Открыть Общие настройки и инструменты → Параметры сеанса для просмотра текущего идентификатора сеанса и задания необязательного пароля.

Параметры сеанса Social Stream Ninja: идентификатор, необязательный пароль и скрытие ссылок
В документации и снимках используйте заполнитель. Никогда не публикуйте настоящий пароль сеанса или приватную созданную ссылку.
ЗначениеПравило
Идентификатор сеансаНе меняйте его, если не собираетесь заменить все URL источников, док-панелей, оверлеев и интеграций, которые его используют.
ПарольНеобязателен, но после задания должен совпадать везде. После добавления или изменения скопируйте новые ссылки.
Созданная ссылкаСчитайте всю ссылку приватной, если она содержит пароль или другие чувствительные параметры.

Предпочитайте копирование созданных URL. Они уже содержат текущий сеанс, пароль, версию страницы и поддерживаемые параметры маршрутизации. Ручное редактирование ссылок часто приводит к пустым страницам.

Включение резервного сервера для чтения и ответов

Используйте, если док-панель или объединённый чат подключены, но сообщения не поступают, либо ответы не работают из-за блокировки или ненадёжности обычного однорангового маршрута.

Два резервных переключателя работают парой: Отправлять сообщения чата на API-сервер для внешних слушателей передаёт входящий чат по серверному маршруту, а Док-панель отправляет команды расширению через сервер возвращает ответы и команды док-панели.

Быстрый способ

  1. Откройте или перезагрузите созданную ссылку док-панели.
  2. Отправьте тестовое сообщение из Social Stream Ninja.
  3. Если Включение резервного подключения через сервер появится уведомление, выберите его и подтвердите. Social Stream Ninja одновременно включает серверные маршруты входящего чата и ответных команд.
  4. Скопируйте новые ссылки док-панели и оверлея. Переоткройте обычные окна браузера и замените все сохранённые URL источников «Браузер» OBS.

Ручной способ в настольном приложении

  1. Откройте настольное приложение Social Stream. На правой «Источники и настройки» панели разверните Global settings and tools («Общие настройки и инструменты»).
  2. Разверните Механика — подключения и интеграции.
  3. Включите Отправлять сообщения чата на API-сервер для внешних слушателей. Это маршрут входящего чата и чтения.
  4. Включите Док-панель отправляет команды расширению через сервер. Это маршрут ответов и управления.
  5. Скопируйте и заново откройте созданные ссылки. Уже открытые страницы и сохранённые URL OBS сами не обновляются.
Настройки механики Social Stream Ninja с отправкой чата на API-сервер и командами док-панели через сервер
Для обычного резервного чтения и ответов включите входящий чат и команды док-панели. Остальные серверные элементы — отдельные функции.

Не включайте все серверные параметры сразу. Включить удалённое управление API, Разрешить док-панели использовать API-сервер и публиковать через негои временный параметр дополнительной доставки не нужны для обычного резервного чтения и ответов. Дополнительная доставка может дублировать сообщения.

Обычный режим, ретрансляция и API-сервер

УправлениеЧто меняетКогда использовать
Ссылки по умолчанию Обычный одноранговый транспорт сеанса Social Stream без серверного флага. Большинство конфигураций на одном компьютере и обычных настроек OBS.
Включить удалённое управление расширением через API Включает управление расширением по HTTP/WebSocket и обработку входящих вебхуков. Внешние приложения, управление Stream Deck/API или поддерживаемые входящие вебхуки пожертвований.
Разрешить док-панели использовать API-сервер и публиковать через него Добавляет параметр страницы server маршрутизацию, где поддерживается. Для док-панели и выбранных сообщений нужно удалённое управление через API-сервер вместо обычного маршрута.
Отправлять сообщения чата на API-сервер Направляет захваченный чат слушателям API-сервера и добавляет server2 к поддерживаемым создаваемым ссылкам. Док-панели нужен резервный сервер для входящего чата либо чат должен получать внешний слушатель WebSocket на Python, Node или другой платформе.
Также отправлять чат API обычным способом Временная дополнительная доставка по обоим маршрутам. Только при намеренном переходе между режимами; может дублировать сообщения.
Команды док-панели через сервер Добавляет server3 там, где поддерживается, чтобы команды док-панели возвращались через сервер. Одноранговые подключения заблокированы или ненадёжны, а командам док-панели к расширению нужен сервер.
Общие настройки механики Social Stream Ninja: удалённое управление API, публикация док-панели через API-сервер, внешние слушатели, дополнительная доставка и команды док-панели через сервер
Текущие настройки маршрутизации. Изменение параметра создаваемой ссылки не переписывает уже открытую страницу или сохранённый источник «Браузер» OBS.

О проекте localserver

Некоторые страницы принимают localserver и используют локальную конечную точку WebSocket по адресу ws://127.0.0.1:3000. Добавьте localserverport=PORT для выбора другого порта от 1024 до 65535. При неверном или отсутствующем значении безопасно используется порт 3000. Новые установки настольного Social Stream вместо этого запускают локальный сервер на порту 3003 и добавляют localserverport=3003 в создаваемые ссылки; если составляете URL для новой установки вручную, добавьте этот параметр сами. Добавляйте их только при работающем локальном сервере и поддержке конкретной страницей.

Снимки экрана и пошаговую настройку размещённого WebSocket или расширенного локального сервера смотрите в Режимы размещённого WebSocket и локального сервера.

Параметры маршрутизации зависят от страницы. server, server2, server3, localserver, и localserverport не имеют единого поведения во всех оверлеях. Используйте созданную ссылку конкретной страницы вместо переноса флагов из другого инструмента.

После смены сеанса или переключателя маршрутизации

  1. Скопируйте заново созданный URL док-панели или оверлея.
  2. Закройте и снова откройте активные страницы со старым URL.
  3. Замените URL в сохранённых источниках «Браузер» OBS и обновите их кэш.
  4. Перезагрузите или повторно активируйте страницы источников, если изменили идентификатор сеанса или пароль.
  5. Отправьте одно тестовое сообщение и убедитесь, что оно дошло до док-панели, перед проверкой итогового оверлея.

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

  1. Сравните полное session= значение в источнике, док-панели и оверлее.
  2. Проверьте, не отсутствует ли в одном из URL текущий password=.
  3. Проверьте, не отсутствуют ли текущие серверные флаги в старом URL OBS.
  4. Если режимы непонятны, удалите вручную добавленные флаги маршрутизации и скопируйте новую созданную ссылку.
  5. Сначала проверьте док-панель. Если сообщения приходят, дальше проверяйте фильтры событий и параметры URL оверлея.
  6. См. Устранение неполадок OBS и Справочник команд и API для подробных проверок.