Produkty na żywo i łącza widzów

1. Dodaj łącze produktu lub wsparcia

Otwórz Monetization > Products & support links > Set up products and links. Wklej publiczne łącze HTTPS i wybierz Wczytaj szczegóły z łącza. Szybki import obsługuje publiczne strony Gumroad, itch.io, Ko-fi, Buy Me a Coffee i Fourthwall. Własne domeny, przekierowania, strony prywatne i strony bez publicznych metadanych mogą wymagać ręcznego wprowadzania. Istniejące opcje importu API Shopify i Fourthwall pozostają dostępne.

Sprawdź tytuł, obraz, cenę, walutę i cel. Szybki import celowo pozostawia cenę pustą. Wybierz Dodaj produkt lub link, włącz Products & support links, a następnie Zapisz konfigurację. Ręczne karty nie wymagają konta sprzedawcy.

Shop, Gift, Support i Join opisują cel łącza. Nie zmieniają klasyfikacji późniejszych zdarzeń płatności. Karty są zapisanymi obrazami stanu; kasa jest źródłem prawdy dla zapasów i cen.

2. Steruj tym, co się pojawia

Dodaj istniejący URL nakładki Products & support links do OBS. Użyj Showcase lub Support card dla promocji albo Both, aby uwzględnić alerty aktywności.

• Pokaż teraz w zapisanym wierszu przypina produkt i nadpisuje okresowy harmonogram kart.
• Następny produkt przypina następny zapisany produkt.
• Ukryj produkty ukrywa karty promocyjne. Alerty zakupów i prezentów działają dalej.
• Wznów harmonogram przywraca zapisane ustawienia pierwszego produktu lub rotacji.

Ustaw Show/hide seconds przed użyciem sterowania. Zero trwa do zmiany; 1–3600 przywraca zapisany harmonogram po tylu sekundach. Nadpisania na żywo resetują się przy ponownym uruchomieniu SSN. Niezapisane wiersze są oznaczone, a przyciski Show now pozostają wyłączone do Save setup. Status podaje wybrany produkt i pozostałe sekundy; nie twierdzi, że OBS nadaje ani że źródło jest widoczne. Sterowanie identyfikuje produkt po dokładnym zapisanym URL, więc przesunięcie na liście nie psuje automatyzacji.

3. Opublikuj jedno łącze widza

Otwórz Display options > Public viewer page i wybierz Opublikuj zapisane łącza. Jawnie publikuje to wszystkie zapisane łącza produktów/wsparcia, w tym tytuły, obrazy, ceny i cele. Udostępnij Kopiuj łącze widza widzom. Kody QR produktów używają teraz tej stałej strony, więc widz nadal może znaleźć produkt po zmianie w rotacji nakładki.

Zapisane zmiany i sterowanie na żywo aktualizują ten sam URL. Strona widza sprawdza aktualizacje co 15 sekund i oznacza wyróżniony produkt. Zachowuje dostęp do innych łączy, gdy karty promocyjne są ukryte. Ostatni opublikowany katalog pozostaje dostępny, gdy SSN jest offline; pokazuje znacznik zapisu, a wyróżnienie oznacza ostatni zapisany wybór lub rotację, nie dowód transmisji twórcy na żywo.

Cofnij publikację usuwa stronę; kody QR produktów wracają do indywidualnych łączy produktów. Otwarte strony widzów wyczyszczą się przy następnym udanym sprawdzeniu. Wcześniej udostępnione adresy URL przestają się ładować do ponownej publikacji. Publikacja z tego samego urządzenia przywraca ten sam URL. Zachowaj profil urządzenia SSN: jego prywatny klucz publikowania jest potrzebny do aktualizacji lub usunięcia strony.

Jeśli API jest niedostępne, lokalne sterowanie nadal działa. Nieudane aktualizacje pozostawiają widoczną ostatnią opublikowaną stronę i są ponawiane, gdy SSN jest otwarte. Okno zgłasza niepowodzenie. Publikowanie wymaga wdrożonej opcjonalnej usługi publicznego sklepu; nie wiąże się z kontem sklepu ani płatności.

Event Flow i zdalne sterowanie

W Event Flow dodaj Produkty i wsparcie akcję z grupy akcji nakładek. Wybierz Show, Next, Hide lub Resume; opcjonalnie ustaw dokładny zapisany URL produktu i sekundy. Użyj odpowiedniego istniejącego wyzwalacza, np. własnego polecenia moderatora, zamiast pozwalać każdej wiadomości czatu zmieniać produkty.

We wtyczce Stream Deck dodaj przyciski Preset Command z Produkty i wsparcie: Show product, Next product, Hide products i Resume products. Show zawiera wybór zapisanego produktu; wybierz Refresh products and state, aby wczytać listę. Niedostępny zapisany wybór pozostaje widoczny zamiast po cichu się zmieniać. Nadal możesz wkleić publiczny URL produktu lub pozostawić pusty dla bieżącego/pierwszego produktu. Next i Hide przyjmują opcjonalne sekundy. Przyciski czekają, aż SSN potwierdzi lokalną zmianę, niezależnie od aktualizacji strony publicznej. Dodaj opcjonalny przycisk Product State, aby otrzymywać informację o wyborze/ukryciu/harmonogramie odświeżaną co pięć sekund, gdy przycisk jest widoczny. Inspektor i SSN pokazują pełną nazwę produktu; mały przycisk stanu skraca długie nazwy. Użyj istniejącego połączenia P2P lub WebSocket.

Istniejące uwierzytelnione zdalne API sesji przyjmuje to samo sterowanie:

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

Polecenia to show, next, hide i resume. Pomiń URL, aby pokazać bieżący/pierwszy produkt. Sterowanie hosta musi być włączone. Nigdy nie udostępniaj widzom prywatnego URL sesji/sterowania; używaj opublikowanego łącza widza.

Te akcje rozsyłają wyłącznie istniejący monetization_update stan wyświetlania. Nie tworzą wpłat, zakupów, wpisów czatu ani wyzwalaczy płatności Event Flow. Istniejące hasDonation działanie pozostaje bez zmian.

Sprawdź, kiedy sterowanie się zakończyło

Akcja Products & Support czeka na odpowiedź SSN przed kontynuowaniem przepływu. W zwykłych danych zdarzeń meta.commerceControlResult zawiera success oraz wynikowy commerce stan sterowania lub error. Niepowodzenie zatrzymuje dalsze akcje w tym łańcuchu; oryginalny zakup lub napiwek pozostaje dostępny dla innych przepływów i nakładek. Stan potwierdza wybór SSN, ukrycie lub harmonogram; widoczność w OBS jest osobną kwestią.

Jeśli w ciągu ośmiu sekund nie nadejdzie odpowiedź, akcja zgłasza przekroczenie limitu czasu. Sterowanie nadal mogło zostać zastosowane: sprawdź stan okna lub doku przed ponowieniem Next. Zewnętrzni klienci zdalni powinni używać istniejącego protokołu żądanie/odpowiedź i sprawdzać zwrócony wynik zamiast uznawać samo wysłanie polecenia za sukces.

Inne efekty mają własną informację zwrotną. Print Thermal Label zgłasza meta.thermalPrintResult; udane zgłoszenie zadania nie potwierdza wydruku na papierze. Synchroniczna akcja Webhook może zwrócić status HTTP i odpowiedź oraz zatrzymać przepływ przy niepowodzeniu. To wyniki akcji, a nie nowe zdarzenia płatności. Zobacz dokumentację zdarzeń aby poznać kontrakt wyniku sterowania.