Товари наживо та глядацькі посилання

1. Додайте товар або посилання для підтримки

Відкрийте Monetization > Products & support links > Set up products and links. Вставте публічне HTTPS-посилання й виберіть Завантажити відомості з посилання. Швидкий імпорт підтримує публічні сторінки Gumroad, itch.io, Ko-fi, Buy Me a Coffee та Fourthwall. Власні домени, перенаправлення, приватні сторінки й сторінки без публічних метаданих можуть потребувати ручного введення. Наявні варіанти імпорту через API Shopify та Fourthwall залишаються доступними.

Перевірте назву, зображення, ціну, валюту й призначення. Швидкий імпорт навмисно залишає ціну порожньою. Виберіть Додати товар або посилання, увімкніть Products & support links, потім Зберегти налаштування. Для ручних карток обліковий запис продавця не потрібен.

Shop, Gift, Support і Join описують призначення посилання. Вони не змінюють класифікацію подальших платіжних подій. Картки — збережені знімки; оформлення покупки є джерелом істини щодо наявності й цін.

2. Керуйте тим, що з’являється

Додайте наявний URL оверлею Products & support links в OBS. Використовуйте Showcase або Support card для просування або Both, щоб включити сповіщення про активність.

• Показати зараз у збереженому рядку закріплює цей товар і перевизначає періодичний розклад карток.
• Наступний товар закріплює наступний збережений товар.
• Приховати товари приховує рекламні картки. Сповіщення про покупки й подарунки продовжуються.
• Відновити розклад відновлює збережені налаштування першого товару або ротації.

Установіть Show/hide seconds перед використанням керування. Нуль діє до наступної зміни; 1–3600 відновлює збережений розклад через відповідну кількість секунд. Тимчасові перевизначення скидаються після перезапуску SSN. Незбережені рядки позначені, а їхні кнопки Show now залишаються вимкненими до Save setup. Стан називає вибраний товар і показує залишок секунд; він не стверджує, що OBS в ефірі чи це джерело видиме. Керування визначає товар за точним збереженим URL, тому переміщення у списку не ламає автоматизацію.

3. Опублікуйте одне глядацьке посилання

Відкрийте Display options > Public viewer page і виберіть Опублікувати збережені посилання. Це явно публікує всі збережені посилання на товари/підтримку, включно з назвами, зображеннями, цінами та призначенням. Поділіться Скопіювати глядацьке посилання з глядачами. QR-коди товарів тепер використовують цю стабільну сторінку, тому глядач може знайти товар навіть після ротації оверлею.

Збережені зміни й керування наживо оновлюють той самий URL. Глядацька сторінка перевіряє оновлення кожні 15 секунд і позначає вибраний товар. Інші посилання залишаються доступними, коли рекламні картки приховані. Останній опублікований каталог доступний, поки SSN офлайн; показується час збереження, а позначка вибраного означає останній збережений вибір або ротацію, а не доказ, що автор зараз в ефірі.

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

Якщо API недоступний, локальне керування все одно працює. Невдалі оновлення залишають останню опубліковану сторінку видимою й повторюються, поки SSN відкритий. Спливне вікно повідомляє про збій. Для публікації потрібен розгорнутий необов’язковий сервіс публічного магазину; обліковий запис магазину чи платежів не залучається.

Event Flow і дистанційне керування

В Event Flow додайте Товари та підтримка дію з групи дій оверлею. Виберіть Show, Next, Hide або Resume; за бажанням задайте точний збережений URL товару й секунди. Використовуйте доречний наявний тригер, наприклад власну команду модератора, замість дозволу кожному повідомленню чату змінювати товари.

У плагіні Stream Deck додайте клавіші Preset Command з Товари та підтримка: Show product, Next product, Hide products і Resume products. Show містить вибір збереженого товару; виберіть Refresh products and state, щоб завантажити список. Недоступний збережений вибір залишається видимим, а не змінюється непомітно. Також можна вставити публічний URL товару або залишити порожнім для поточного/першого товару. Next і Hide приймають необов’язкову кількість секунд. Клавіші чекають підтвердження локальної зміни від SSN незалежно від оновлень публічної сторінки. Додайте необов’язкову клавішу Product State для зворотного зв’язку про вибір/приховування/розклад, що оновлюється кожні п’ять секунд, поки клавішу видно. Інспектор і 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 поведінка не змінюється.

Дізнавайтеся, коли керування завершилося

Дія Products & Support чекає відповіді SSN перед продовженням потоку. Для звичайних даних подій meta.commerceControlResult містить success та отриманий commerce стан керування або error. Збій зупиняє наступні дії цього ланцюжка; початкова покупка або чайові залишаються доступними іншим потокам і оверлеям. Стан підтверджує вибір SSN, приховування або розклад; видимість в OBS є окремою.

Якщо протягом восьми секунд відповідь не надходить, дія повідомляє про тайм-аут. Керування все одно могло застосуватися: перевірте стан у спливному вікні або доку перед повторенням Next. Зовнішні віддалені клієнти мають використовувати наявний протокол запит/відповідь і перевіряти повернений результат, а не вважати надсилання команди успіхом.

Інші ефекти мають власний зворотний зв’язок. Print Thermal Label повідомляє meta.thermalPrintResult; успішне надсилання завдання не підтверджує друк на папері. Синхронна дія Webhook може повертати стан HTTP і відповідь та блокувати виконання в разі збою. Це результати дій, а не нові платіжні події. Див. довідник подій щодо контракту результату керування.