Živé produkty a odkazy pro diváky

1. Přidejte produkt nebo odkaz podpory

Otevřete Zpeněžení > Produkty a odkazy podpory > Nastavit produkty a odkazy. Vložte veřejný odkaz HTTPS a vyberte Načíst podrobnosti z odkazu. Rychlý import podporuje veřejné stránky Gumroad, itch.io, Ko-fi, Buy Me a Coffee a Fourthwall. Vlastní domény, přesměrování, soukromé stránky a stránky bez veřejných metadat mohou vyžadovat ruční zadání. Stávající možnosti importu přes API Shopify a Fourthwall zůstávají dostupné.

Zkontrolujte název, obrázek, cenu, měnu a účel. Rychlý import záměrně nechává cenu prázdnou. Vyberte Přidat produkt nebo odkaz, zapněte Produkty a odkazy na podporu (Products & support links) a poté Uložit nastavení. Pro ruční karty není potřeba účet obchodníka.

Nakoupit, Darovat, Podpořit a Připojit se popisují účel odkazu. Nemění klasifikaci pozdějších platebních událostí. Karty jsou uložené snímky; rozhodující údaje o zásobách a cenách jsou u pokladny.

2. Určete, co se zobrazuje

Přidejte stávající URL překryvu Produkty a odkazy podpory do OBS. Pro propagaci použijte Přehlídku nebo Kartu podpory, případně Obojí pro zahrnutí upozornění na aktivitu.

• Zobrazit nyní u uloženého řádku připne daný produkt a přepíše pravidelný plán karet.
• Další produkt připne další uložený produkt.
• Skrýt produkty skryje propagační karty. Upozornění na nákupy a dary pokračují.
• Obnovit plán obnoví uložené nastavení prvního produktu nebo střídání.

Před použitím ovládání nastavte počet sekund zobrazení/skrytí. Nula platí až do změny; 1–3600 obnoví uložený plán po zadaném počtu sekund. Živá přepsání se při restartu SSN resetují. Neuložené řádky jsou označené a jejich tlačítka Zobrazit nyní zůstávají vypnutá až do Uložit nastavení. Stav uvádí vybraný produkt a zbývající sekundy; netvrdí, že OBS vysílá nebo že je zdroj viditelný. Ovládání identifikuje produkt přesnou uloženou URL, takže přesun v seznamu neporuší automatizaci.

3. Zveřejněte jeden odkaz pro diváky

Otevřete Možnosti zobrazení > Veřejná stránka pro diváky a vyberte Zveřejnit uložené odkazy. Tím výslovně zveřejníte všechny uložené odkazy na produkty/podporu včetně názvů, obrázků, cen a účelů. Sdílejte Kopírovat odkaz pro diváky s diváky. QR kódy produktů nyní používají tuto stálou stránku, takže divák produkt najde i poté, co se překryv vystřídá.

Uložené změny a živé ovládání aktualizují stejnou URL. Stránka pro diváky kontroluje změny každých 15 sekund a označuje vybraný produkt. Ostatní odkazy zůstávají dostupné i při skrytých propagačních kartách. Poslední zveřejněný katalog zůstává dostupný, i když je SSN offline; ukazuje čas uložení a označení vybraného produktu znamená poslední uložený výběr nebo střídání, nikoli důkaz živého vysílání tvůrce.

Zrušit zveřejnění odstraní stránku; QR kódy produktů se vrátí k jednotlivým produktovým odkazům. Otevřené stránky diváků se vymažou při příští úspěšné kontrole. Dříve sdílené URL se přestanou načítat, dokud znovu nezveřejníte. Opětovné zveřejnění ze stejného zařízení obnoví stejnou URL. Uchovejte profil zařízení SSN: jeho soukromý publikační klíč je nutný k aktualizaci nebo odstranění stránky.

Pokud API není dostupné, místní ovládání funguje dál. Neúspěšné aktualizace ponechají viditelnou poslední zveřejněnou stránku a při otevřeném SSN se opakují. Vyskakovací okno hlásí chybu. Zveřejnění vyžaduje nasazenou volitelnou službu veřejného obchodu; účet obchodu ani plateb není potřeba.

Event Flow a vzdálené ovládání

V Event Flow přidejte Produkty a podpora akci ze skupiny akcí překryvů. Vyberte Zobrazit, Další, Skrýt nebo Obnovit; volitelně nastavte přesnou uloženou URL produktu a sekundy. Použijte vhodný stávající spouštěč, například vlastní moderátorský příkaz, místo aby produkty měnila každá zpráva chatu.

V pluginu Stream Deck přidejte klávesy Přednastavený příkaz z Produkty a podpora: Zobrazit produkt, Další produkt, Skrýt produkty a Obnovit produkty. Zobrazit obsahuje výběr uloženého produktu; seznam načtete volbou Obnovit produkty a stav. Nedostupný uložený výběr zůstane viditelný místo tiché změny. Stále můžete vložit veřejnou URL produktu nebo ji nechat prázdnou pro aktuální/první produkt. Další a Skrýt přijímají volitelný počet sekund. Klávesy čekají na potvrzení místní změny od SSN nezávisle na aktualizacích veřejné stránky. Přidejte volitelnou klávesu Stav produktu pro informaci o výběru/skrytí/plánu obnovovanou každých pět sekund, dokud je klávesa viditelná. Inspektor a SSN zobrazují úplný název produktu; malá stavová klávesa dlouhé názvy zkracuje. Použijte stávající připojení P2P nebo WebSocket.

Stávající ověřené vzdálené API relace přijímá stejné ovládání:

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

Příkazy jsou show, next, hide a resume. Vynecháním URL zobrazíte aktuální/první produkt. Ovládání hostitele musí být povolené. Soukromou URL relace/ovládání nikdy nesdílejte s diváky; použijte zveřejněný odkaz pro diváky.

Tyto akce vysílají pouze stávající monetization_update stav zobrazení. Nevytvářejí příspěvky, nákupy, zprávy v chatu ani platební spouštěče Event Flow. Stávající hasDonation chování se nemění.

Zjistěte, kdy se ovládací akce dokončila

Akce Produkty a podpora čeká před pokračováním toku na odpověď SSN. U běžných dat události meta.commerceControlResult obsahuje success a buď výsledný commerce stav ovládání nebo error. Selhání zastaví další akce v tomto řetězci; původní nákup nebo spropitné zůstane dostupné ostatním tokům a překryvům. Stav potvrzuje výběr, skrytí nebo plán SSN; viditelnost OBS je samostatná.

Pokud odpověď nepřijde do osmi sekund, akce ohlásí vypršení času. Příkaz se přesto mohl provést: před opakováním Další zkontrolujte stav ve vyskakovacím okně nebo doku. Externí vzdálení klienti mají používat stávající protokol požadavek/odpověď a kontrolovat vrácený výsledek, nikoli považovat odeslání příkazu za úspěch.

Další efekty mají vlastní odezvu. Tisknout termální štítek hlásí meta.thermalPrintResult; úspěšné odeslání úlohy nepotvrzuje výstup na papír. Synchronní akce Webhook může vrátit stav HTTP a odpověď a při selhání zablokovat pokračování. Jde o výsledky akcí, nikoli nové platební události. Viz přehled událostí pro kontrakt výsledku ovládání.