Soutěže, lístky a bodové ceny

Začínáte s nástrojem soutěží? Začněte zde: Vaše první soutěž: průvodce se snímky obrazovky.

Losování provozujte na jednom hostiteli. Vyskakovací okno, Stream Deck a Event Flow ovládají tohoto hostitele; zobrazení pro diváky ukazují jeho potvrzený výsledek.

Uspořádejte první bezplatnou soutěž

1. Ve vyskakovacím okně otevřete Možnosti soutěže. Ponechte ID jako default, klíčové slovo jako !entera cenu lístku i bodovou cenu na nule.
2. Vyberte kartu vítěze, pás jmen nebo komunitní kolo. Zobrazte náhled a potom zkopírujte jeho odkaz do zdroje Prohlížeč v OBS.
3. Vyberte Otevřít přihlašování. Diváci se přihlašují odesláním klíčového slova do zachytávaného chatu.
4. Vyberte Uzavřít přihlašování, potom Vylosovat vítěze. Losování také uzavře přihlašování, pokud jste jej zapomněli uzavřít předem.
5. Vyberte Nové kolo pro zahájení dalšího losování. Dřívější vítězové zůstávají v historii hostitele.

Nechte hostitele SSN spuštěného. Není potřeba interakce se zdrojem Prohlížeč v OBS. Samostatné komunitní kolo zůstává dostupné bez &managed; body a dálkové ovládání používají spravovaný režim.

Lístky placené body SSN

1. Zapněte stávající Systém věrnostních bodů ve vyskakovacím okně. Jde o body SSN oddělené od bodů kanálu Twitch a skóre jednotlivých her.
2. V části Lístky a bodové ceny, nastavte body za lístek a maximální počet lístků na diváka. Cena 1 znamená jeden lístek za bod.
3. Otevřete přihlašování. Pro soutěž s názvem friday, divák koupí pět lístků pomocí !ticket friday 5.
4. Zkontrolujte účastníky v Spravovat soutěže a historii. Úspěšný nákup současně odečte body a přihlásí diváka. Při nedostatku prostředků nevzniknou žádné lístky.

Nákupy lístků okamžitě rezervují body, takže stejné body nemohou současně koupit nálepky ani vstoupit do jiného placeného losování. Losování tyto body spotřebuje. Zrušit a vrátit body vrací rezervované body. Odstranění jednoho účastníka před losováním vrátí rezervaci tohoto účastníka. Placená kola nelze tiše zahodit pomocí Nového kola.

Pravidla se uzamknou po první přihlášce. Zavření/otevření může pozastavit kolo s jeho stávajícími pravidly. Pro změnu ceny nebo způsobilosti je zrušte a vytvořte další kolo. Divák po přihlášení nemůže přepnout peněženku ani změnit stranu sázky.

Rozdávejte body

Nastavte Bodová cena pro každého vítěze a Počet cen před otevřením. Každá cena přidá tento počet bodů SSN na existující účet vybraného diváka. Body se tím vytvářejí; nečerpají se z výnosu lístků ani peněženky obsluhy. Celkové vydání je omezeno nastavenou výší ceny a počtem vítězů.

Více cen losujte postupně. Každý potvrzený vítěz se zaznamená před animací zobrazení. Dokončené losování nelze zrušit a odvolat tak známý výsledek. Chyby opravujte záměrnou úpravou bodů hostitelem; změna zobrazení nebo opětovné připojení nikdy neudělí cenu znovu.

Hry s bodovými odměnami

Spravovaný Number Hunt

Vyberte Number Hunt (řízený hostitelem), cenu lístku 0, jednu cenu a volitelnou bodovou cenu. Hostitel vybere číslo od 1 do 100. Hráči používají !guess friday 50, přičemž dosaďte ID soutěže. Správný tip jednou odmění prvního způsobilého řešitele; nesprávné tipy zúží rozsah pro všechny. Každý divák může tipovat jednou za pět sekund.

Použijte spravované zobrazení soutěže nebo games/numberhunt.html?session=YOUR_SESSION&managed&giveaway=friday. Běžný Number Hunt a ostatní stávající hry zachovávají své původní místní chování. Jejich místní skóre a označení vítězů automaticky neudělují body SSN.

Coin Flip Pot

Jde o hru náhody. Vyberte Coin Flip Pot, cenu 1, jeden výsledek a dodatečnou cenu 0. Diváci sázejí pomocí !ticket friday 3 heads nebo !ticket friday 3 tails. Obě strany potřebují účastníka. Uzavřete přihlašování a losujte: hostitel vybere hlavu nebo orel se stejnou pravděpodobností bez ohledu na celkové sázky.

Vítězní diváci získají zpět svou sázku a rozdělí si prohrané sázky v poměru ke svým sázkám. Zbytky celých bodů připadnou největším zlomkovým podílům a při shodě rozhodne pořadí přihlášení. Neúčtuje se poplatek a nevznikají další body. Při vítězných sázkách 2 a 1 proti 5 prohraným bodům vyplatí bank 8 bodů částky 5 a 3. Zrušením před losováním vrátíte body všem. Pokud je jedna strana prázdná, losování se odmítne a můžete zrušit a vrátit body.

Více soutěží

Každému losování přidělte krátké ID tvořené písmeny, čísly, spojovníky nebo podtržítky. Nákupy diváka napříč všemi ID sdílejí stejný dostupný zůstatek peněženky. Každá URL OBS obsahuje &giveaway=ID. Příkazy lístků a tipů výslovně uvádějí losování. Souběžným bezplatným losováním nastavte různá klíčová slova: nejednoznačné bezplatné klíčové slovo omylem nepřihlásí diváka do více losování.

Pole vyskakovacího okna jsou hodnoty nastavení. Pro kontrolu pravidel potvrzených na hostiteli obnovte stav nebo otevřete správce. Změna odkazu pro diváky mění pouze jeho nastavení zobrazení; nepřepisuje pravidla lístků probíhajícího kola.

OBS a vzhled

Výchozí spravované pozadí je průhledné. Podle potřeby vyberte tematický panel. Karta, pás jmen a komunitní kolo sdílejí stejný výsledek a šest barevných stylů. Předvolba omezeného pohybu přeskakuje animace odhalení. Kolo zobrazuje nejvýše 120 jmen; je to animace odhalení, nikoli úplné znázornění šancí každého lístku. Výběr používá celou skupinu způsobilých lístků.

Po opětovném připojení zobrazení ukáže uložený výsledek. Připojené zobrazení neříká SSN, zda je daná scéna OBS právě viditelná. URL ovladačů, ID relací a soubory záloh udržujte v soukromí.

Event Flow

Přidejte Soutěž / Lístky z akcí bodů. Vyberte Přihlásit do bezplatné soutěže (Enter free giveaway), Koupit lístky (Buy tickets), Přidělit bezplatné lístky (Grant free tickets), Uzavřít přihlašování (Close entries), Vylosovat vítěze (Draw winner), Zrušit a vrátit body (Cancel and refund) nebo Dotázat stav (Query state). Vyberte ID a počet lístků; pro sázku do banku vyberte heads/tails. Akce používá zachycenou identitu diváka. Před přidělováním nebo ovládáním obsluhy použijte důvěryhodný spouštěč/filtr.

Akce Koupit lístky již body utrácí. Nepřidávejte před ni Utratit body (Spend Points). Selhání zastaví závislé akce, aniž by skrylo původní chat. Výsledek je dostupný v meta.giveawayControlResult. Testovací panel Event Flow simuluje tuto akci bez nákupu skutečných lístků. Pro testy celého postupu se skutečnými změnami kol použijte odděleného hostitele/profil.

Způsobilost nákupu používá potvrzený zůstatek v okamžiku spuštění akce. Nespoléhejte, že samotná přihlašovací zpráva vydělá poslední potřebný bod. Nativní ID zpráv zdrojů poskytují trvalou ochranu proti opakování; zdroje bez nich mají slabší záruky identity mezi restarty. Obecné plánované události bez zachyceného ID diváka/zprávy nemohou nakupovat za někoho jiného.

Stream Deck a API

Nativní plugin obsahuje Open Giveaway, Close Giveaway, Draw Giveaway, Cancel & Refund, New Giveaway Round a Giveaway State. Jejich výchozí ID je default. Vložte {"giveawayId":"friday"} do pole hodnoty pro výběr jiného kola. Open může také přijmout config objekt; jinak si stávající kolo ponechá svá potvrzená pravidla a nové ID použije výchozí hodnoty vyskakovacího okna.

Použijte stávající připojení P2P nebo nakonfigurovaný přenos WebSocket. Klávesa hlásí odpověď z SSN; netvrdí, že OBS vysílá. Pokud vyprší časový limit odpovědi, před novým losováním si vyžádejte stav.

{"protocol":2,"action":"buygiveawaytickets","get":"callback-1","value":{"giveawayId":"friday","roundId":"ROUND_ID","operationId":"purchase-123","count":5,"actor":{"chatname":"Avery","type":"youtube","userid":"SOURCE_USER_ID"}}}

ID operace identifikuje obchodní operaci; ID callbacku identifikuje odpověď. Při opakování zachovejte ID operace. Opětovné použití s jinými parametry selže. Pro záměrný nový nákup použijte nové ID operace. Operátorský přístup API může utrácet za dodaného aktéra: nezpřístupňujte jej jako veřejný neověřený nákupní formulář.

Historie, zálohy a obnova

Správce uvádí kola, účastníky a historii vítězů. Exportujte historii vítězů jako JSON nebo uložte úplnou zálohu bodů/soutěží verze 2. Úplné zálohy obsahují zůstatky, rezervace, kola a potvrzení operací společně. Na server se nic nenahrává.

Po restartu hostitele se uložená otevřená kola uzavřou ke kontrole. Jejich lístky zůstávají rezervované. Znovu je otevřete se stejnými pravidly, losujte nebo zrušte a vraťte body. Přerušené databázové transakce se buď potvrdí celé, nebo nezanechají částečný nákup/výplatu. Rezervace nálepek bez potvrzeného doručení se obnoví po vypršení časového limitu.

Úplná obnova je dostupná na novém hostiteli bez existujících zůstatků nebo záznamů soutěží. Obnoví celý snímek a ponechá obnovená kola uzavřená. Odmítne přepsat hostitele, který již obsahuje data. Před pokračováním jeho kol obnovte ve vyskakovacím okně původní ID vysílání/relace; výsledek obnovy uvádí relace zálohy. Tato záloha nenahrazuje obecná nastavení vyskakovacího okna. Nikdy nespouštějte starého a obnoveného hostitele jako nezávislé autority stejné ekonomiky. Záloha je snímek: nemůže obsahovat transakce, které proběhly po jejím uložení.

Importy pouze zůstatků nemohou obnovit nevyřízené rezervace. Reset bodů a ruční přepsání se odmítne, pokud jsou dotčené prostředky rezervovány. Reset bodů nemaže potvrzení/historii soutěží. Zůstatky patří tomuto profilu prohlížeče/aplikace, zatímco kola jsou omezena na relaci. Samostatné profily/zařízení se nesynchronizují automaticky. Vymazání dat prohlížeče může odstranit místní záznamy, proto uchovávejte zálohy mimo tento profil.

Volitelná serverová záloha/synchronizace je budoucí funkce, není součástí tohoto vydání. Tato implementace nepřidává nahrávání, serverové přihlašovací údaje, kupovanou měnu ani výběr peněz.

Když něco nefunguje

• Chybí přihláška: zkontrolujte ID/klíčové slovo, omezení členství, otevřený stav a zachytávanou platformu. Přihlášky botů, soukromé, historické, opakované a označené jako test jsou vyloučeny.
• Změna účtu: změna jména/identity může znejasnit přiřazení peněženky. Zkontrolujte ji na hostiteli; účty se nikdy tiše neslučují napříč platformami.
• Žádná odpověď: ověřte, že požadovaný hostitel SSN běží a má zapnuté ovládání hostitele. Před opakováním obnovte potvrzený stav.
• Nelze resetovat/importovat: nejprve vypořádejte nebo zrušte rezervované nákupy. Pro zálohu obsahující závazky použijte úplnou obnovu.
• Neznámá odměna: !spend vyžaduje odpovídající nastavenou odměnu a cenu; již nespaluje body za libovolný název odměny.

referenční příručka API · Kontrakty událostí · Ankety a pořadníky

Obnova zálohy krok za krokem

1. Ponechte starého hostitele zastaveného. Otevřete SSN v novém profilu prohlížeče a otevřete správce soutěží.
2. V části Obnovit na novém hostiteli, vyberte úplnou zálohu. Počkejte na zprávu o obnově a poznamenejte si původní ID relace, které uvádí.
3. Ve vyskakovacím okně v části Možnosti relace, zadejte toto původní ID relace.
4. Vraťte se do správce, vyberte ID soutěže a zvolte Obnovit. Zkontrolujte pravidla, účastníky a historii vítězů. Obnovená otevřená kola jsou uzavřena ke kontrole.
5. Znovu otevřete se stejnými pravidly, losujte nebo vyberte Zrušit a vrátit body pro vrácení rezervovaných lístků. Po kontrole výsledku uložte novou zálohu.

Pro OBS začněte se zdrojem Prohlížeč 1280 × 720. Spravované kolo se přizpůsobí zbývající výšce zdroje. Výchozí pozadí je průhledné bez vlastního CSS; veškeré běžné ovládání zůstává ve vyskakovacím okně, správci nebo Stream Decku.