Товары в эфире и зрительские ссылки

1. Добавьте товар или ссылку поддержки

Откройте «Монетизация > Товары и ссылки поддержки > Настроить товары и ссылки». Вставьте общедоступную HTTPS-ссылку и выберите Загрузить сведения по ссылке. Быстрый импорт поддерживает общедоступные страницы Gumroad, itch.io, Ko-fi, Buy Me a Coffee и Fourthwall. Для собственных доменов, перенаправлений, приватных страниц и страниц без открытых метаданных может потребоваться ручной ввод. Существующие варианты импорта через API Shopify и Fourthwall остаются доступны.

Проверьте название, изображение, цену, валюту и назначение. Быстрый импорт намеренно оставляет цену пустой. Выберите Добавить товар или ссылку, включите Products & support links («Товары и ссылки поддержки»), затем Сохранить настройку. Для ручных карточек аккаунт продавца не нужен.

Магазин, подарок, поддержка и вступление описывают назначение ссылки. Они не меняют классификацию последующих платежей. Карточки — сохранённые снимки; актуальные остатки и цены определяются на странице оплаты.

2. Управляйте показом

Добавьте существующий URL оверлея товаров и ссылок поддержки в OBS. Для рекламы используйте витрину или карточку поддержки, а вариант «Оба» включает также оповещения об активности.

• Показать сейчас в сохранённой строке закрепляет товар и переопределяет периодическое расписание карточек.
• Следующий товар закрепляет следующий сохранённый товар.
• Скрыть товары скрывает рекламные карточки. Оповещения о покупках и подарках продолжаются.
• Продолжить расписание возвращает сохранённую настройку первого товара или чередования.

Перед командой задайте секунды показа или скрытия. Ноль действует до изменения; 1–3600 возвращает сохранённое расписание через указанное число секунд. Ручные изменения сбрасываются при перезапуске SSN. Несохранённые строки помечаются, а их кнопки немедленного показа отключены до сохранения настроек. Статус указывает выбранный товар и оставшиеся секунды, но не утверждает, что OBS в эфире или источник виден. Товар определяется по точному сохранённому URL, поэтому перестановка списка не ломает автоматизацию.

3. Опубликуйте одну зрительскую ссылку

Откройте «Параметры отображения > Публичная зрительская страница» и выберите Опубликовать сохранённые ссылки. Это явно публикует все сохранённые ссылки на товары и поддержку вместе с названиями, изображениями, ценами и назначением. Поделитесь Скопировать зрительскую ссылку со зрителями. QR-коды товаров теперь используют эту постоянную страницу, поэтому зритель сможет найти товар и после смены карточки.

Сохранённые изменения и команды обновляют один URL. Зрительская страница проверяет обновления каждые 15 секунд и помечает выбранный товар. Когда рекламные карточки скрыты, остальные ссылки остаются доступны. Последний опубликованный каталог доступен и при отключённом SSN; показано время сохранения, а отметка выбранного товара отражает последний выбор или чередование, не доказывая, что автор сейчас в эфире.

Снять с публикации удаляет страницу; QR-коды товаров снова ведут на отдельные ссылки товаров. Открытые зрительские страницы очищаются при следующей успешной проверке. Старые ссылки перестают открываться до новой публикации. Повторная публикация с того же устройства возвращает тот же URL. Сохраните профиль устройства SSN: его приватный ключ публикации нужен для обновления или удаления страницы.

Если API недоступен, локальное управление продолжает работать. При неудачном обновлении остаётся последняя опубликованная страница, а попытки повторяются, пока SSN открыт. Меню сообщает об ошибке. Для публикации нужно развёртывание необязательного сервиса публичного магазина; аккаунт магазина или платежей не требуется.

Event Flow и дистанционное управление

В Event Flow добавьте Товары и поддержка действие из группы оверлеев. Выберите показ, следующий товар, скрытие или продолжение; при желании задайте точный сохранённый URL и секунды. Используйте подходящий существующий триггер, например свою команду модератора, вместо разрешения менять товары любым сообщением чата.

В плагине Stream Deck добавьте клавиши готовых команд из Товары и поддержка: «Показать товар», «Следующий товар», «Скрыть товары» и «Продолжить показ». В показе есть выбор сохранённого товара; нажмите «Обновить товары и состояние», чтобы загрузить список. Недоступный сохранённый выбор остаётся видимым и не меняется незаметно. Можно вставить общедоступный URL товара или оставить пустым для текущего либо первого товара. Для следующего и скрытия можно указать секунды. Клавиши ждут подтверждения локального изменения от SSN независимо от обновлений публичной страницы. Добавьте необязательную клавишу состояния товара для отображения выбора, скрытия и расписания; она обновляется каждые пять секунд, пока видна. Инспектор и SSN показывают полное название, а маленькая клавиша состояния обрезает длинные имена. Используйте существующее подключение P2P или WebSocket.

Существующий удалённый API сеанса с аутентификацией принимает ту же команду:

{"action":"commerceControl","command":"show","url":"https://example.com/product","seconds":30}

Команды: show, next, hide и resume. Не указывайте URL, чтобы показать текущий или первый товар. Управление хостом должно быть включено. Никогда не передавайте зрителям приватный URL сеанса или управления; используйте опубликованную зрительскую ссылку.

Эти действия передают только существующее monetization_update состояние отображения. Они не создают пожертвований, покупок, сообщений чата или платёжных триггеров Event Flow. Существующее hasDonation поведение не меняется.

Узнавайте, когда команда завершена

Действие «Товары и поддержка» ждёт ответа SSN перед продолжением потока. Для обычных данных событий meta.commerceControlResult содержит success и либо полученное commerce состояние управления, либо error. Ошибка останавливает последующие действия цепочки; исходная покупка или чаевые остаются доступны другим потокам и оверлеям. Состояние подтверждает выбор SSN, скрытие или расписание; видимость OBS учитывается отдельно.

Если ответ не пришёл за восемь секунд, действие сообщает об истечении времени ожидания. Команда всё же могла выполниться: перед повтором «Следующий» проверьте состояние в меню или док-панели. Внешние клиенты должны использовать существующий протокол запросов и ответов и проверять результат, а не считать отправку команды успехом.

У других эффектов своя обратная связь. Действие печати термоэтикетки сообщает meta.thermalPrintResult; успешная отправка задания не подтверждает выход бумаги. Синхронное действие вебхука может вернуть HTTP-статус и ответ и остановить выполнение при ошибке. Это результаты действий, а не новые платёжные события. См. справочник событий для контракта результата управления.