A !játék parancs a stream jelenlegi kategóriájával a chat botban

Honnan szerzi be a bot a jelenlegi játék nevét

A !játék parancs általában nem a számítógépen futó alkalmazást mutatja, hanem a Twitch-csatorna jelenlegi kategóriáját. A streamer a közvetítés vezérlőpultjában vált játékot vagy kategóriát, a bot pedig ezt az értéket egy beépített változón vagy API-kérésen keresztül kapja meg.

Ha a Twitch vezérlőpultjában az előző játék maradt beállítva, a „Beszélgetés” kategória van kiválasztva, vagy a mező üres, a bot ugyanazt az értéket fogja kiírni. A chat bot önmagában nem ismeri fel a képernyőn látható játékot: azzal az adattal dolgozik, amelyet a platform vagy egy külső automatizálás továbbít.

Először frissítse a csatorna kategóriáját a Twitchen

A parancs beállítása előtt ellenőrizze, hol módosítja a kategóriát: a Creator Dashboard panelen, egy streamkezelő programon keresztül vagy a bottal való integráción keresztül. A csatorna végső állapota számít, amelyet a nézők a közvetítés oldalán látnak.

A játékváltás után ne számítson arra, hogy minden szolgáltatásban azonnal frissül. A bot a legutóbbi értéket a gyorsítótárban tárolhatja, a platform pedig késleltetve továbbíthatja a frissített adatokat. A !játék parancs esetében jobb az adás kezdete előtt módosítani a kategóriát, és külön ellenőrizni a chatben adott választ.

A !játék parancs a Nightbotban

A Nightbotban nyissa meg a Custom Commands menüpontot, hozza létre a !játék parancsot, és adjon meg egy üzenetet a Twitch-változóval. Az aktuális csatornához általában ezt a választ használják: „Сейчас играем в: $(twitch game $(channel))”.

A $(channel) változó azt a csatornát helyettesíti, amelyben a parancsot meghívták, a $(twitch game ...) pedig annak kategóriáját kéri le. Ha a bot több csatornát szolgál ki, ez a megoldás kényelmesebb, mint ha minden parancsba kézzel írnánk be a streamer bejelentkezési nevét.

• Command: !játék
• Message: Сейчас играем в: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: állítson be késleltetést, hogy ne árassza el a chatet azonos válaszokkal

A Nightbot hátránya a korlátozott válaszlogika. Az üres kategória kezelése, több szövegváltozat vagy a saját ütemtervből származó adatok feldolgozása további kerülőmegoldások nélkül nehéz lesz.

Parancs a kategóriával a StreamElementsben

A StreamElementsben a jelenlegi játék változóját általában ${game} formában adják hozzá a parancs válaszához. A Chat bot részben hozza létre a !játék parancsot, és állítsa be a szöveget: „Текущая игра: ${game}”.

Mentés előtt ellenőrizze a parancsot a chatben egy nézői fiókkal. Ha a bot nincs csatlakoztatva a megfelelő csatornához, vagy a csatorna kategóriája nem frissült, a változó a régi értéket vagy üres szöveget adhat vissza. A jogosultsági és késleltetési beállítások szintén ott, a parancs paramétereinél találhatók.

• Command: !játék
• Response: Текущая игра: ${game}
• Permission: Everyone
• Cooldown: a chat aktivitásához igazítsa

A StreamElements hátránya, hogy a parancs magának a szolgáltatásnak a Twitch-integrációjától függ. Engedélyezési hiba vagy szinkronizációs késleltetés esetén a parancs módosítása nélkül nem tudja kézzel javítani a választ.

Hogyan jelenítsük meg a kategóriát a Streamer.bot segítségével

A Streamer.botban a parancsot kényelmesebb Action segítségével felépíteni. Hozzon létre egy műveletet, amely lekéri a Twitch-csatorna adatait, majd üzenetet küld a chatbe. A csatornaadatok lekérésére szolgáló alparancs után a művelet argumentumaiban általában elérhető a gameName játéknév.

A Send Message alparancsban adjon meg például ilyesmit: „Сейчас играем в: %gameName%”. Ezután a Commands részben rendelje az Actiont a !játék parancshoz. Ha az Ön Streamer.bot-verziójában az argumentum neve eltér, először futtassa a műveletet tesztmódban, és nézze meg a Twitch-alparancs által visszaadott argumentumok listáját.

A Streamer.bot hátránya a több kézi beállítás. Saját magának kell összekapcsolnia a parancsot, a műveletet, a bot chat-hozzáférését és a Twitch-engedélyezést, ezért bármelyik lépés hibája válasz nélkül hagyhatja a parancsot.

Kategórialekérés a Twitch API-n keresztül

Egy egyedi bot, szkript vagy a Streamer.bot Action közvetlenül a Twitch API-n keresztül is lekérheti a kategóriát. Ehhez először derítse ki a csatorna numerikus azonosítóját: a GET https://api.twitch.tv/helix/users?login=csatorna_bejelentkezési_név kérés felhasználói adatokat ad vissza, köztük az id-t.

Ezután használja a GET https://api.twitch.tv/helix/channels?broadcaster_id=CSATORNA_ID kérést. Az API válaszában szerepel a game_name mező — ez a jelenlegi kategória neve, amelyet a !játék parancsra válaszul a chatbe küldhet.

A kéréshez Client-ID és Authorization fejlécek szükségesek hozzáférési tokennel. A tokent és az alkalmazás azonosítóját ne illessze be a parancs nyílt szövegébe, egy nyilvános tárolóba vagy egy böngésző-widgetbe: ezeket az adatokat a bot beállításaiban vagy környezeti változókban kell tárolni.

Az API-parancs beállításának menete

1. Hozzon létre egy alkalmazást a Twitch fejlesztői panelén, és szerezze meg a Client ID-t.
2. Szerezzen be egy tokent a csatornaadatokhoz való hozzáféréssel, és mentse el a botja vagy szkriptje beállításaiba.
3. Határozza meg a csatorna broadcaster_id-jét a users endpointon keresztül a bejelentkezési név alapján.
4. Küldjön kérést a channels endpointra a broadcaster_id-vel.
5. Vegye ki a válaszból a game_name mezőt, és állítsa össze a chat-üzenetet.
6. Ha a game_name üres, semleges szöveget írjon ki üres válasz helyett.

Ne kérdezze le az API-t minden egyes chat-üzenetnél. Praktikusabb az értéket a !játék első meghívásakor frissíteni, a parancs késleltetésének idejére eltárolni, és a gyorsítótár lejárta után újra lekérni az adatokat. A kategória kézi módosítása után egy külön moderátori paranccsal kényszerítheti az érték frissítését.

Hogyan frissítsük a kategóriát, és ne kapjunk régi választ

Ha közvetlenül az adás közben vált játékot, először frissítse a kategóriát a Twitchen, majd várja meg, amíg az új érték megjelenik a csatorna oldalán, és csak ezután ellenőrizze a !játék parancsot. Ha a bot gyorsítótárat használ, törölje azt, vagy várja meg a következő API-kérést.

Egy csatorna esetében általában elegendő a kategóriát a parancs meghívásakor frissíteni, nem kell folyamatos lekérdezést indítani. Ha automatikus monitorozásra van szükség, mérsékelt időközönként végezzen ellenőrzést, és vegye figyelembe az API korlátait. A gyakori kérések nem teszik pontosabbá az adatokat, de a platform oldaláról korlátozásokhoz vezethetnek.

A közvetlen API-megközelítés hátránya, hogy figyelni kell a tokent. A hozzáférés visszavonása, a jelszó megváltoztatása, az alkalmazás jogosultságainak módosítása vagy engedélyezési hiba után a parancs elkezdheti a régi kategóriát kiírni, vagy egyáltalán nem válaszolhat.

A játék felismerése a számítógépen és annak korlátai

Külön felismerő eszközre csak akkor van szükség, ha a Twitch-kategória nem kézzel változik. Az ilyen automatizálás figyeli a futó folyamatot, a játékplatform adatait, az aktív ablakot vagy a telemetriát, összeveti a játékot a Twitch-kategóriával, és az API-n keresztül frissíti a csatornát.

Ezután a bot továbbra is a Twitch-kategóriát olvassa, nem a képernyő tartalmát. Az automatizálás csupán Ön helyett módosítja a csatorna adatait. Hibázhat, ha a játék egy launcherből indul, böngészős verziót használnak, a folyamat neve nem egyezik a játékkal, vagy a streamer más programra váltott.

A felismerés hátránya, hogy külön kell beállítani és felügyelni. Több játékkal, modokkal, emulátorokkal és technikai jelenetekkel tarkított streameknél a kézi kategóriaváltás gyakran megbízhatóbb.

Üres kategória, több játék és kézi szöveg

A platform csak egyetlen jelenlegi kategóriát továbbít. Ha az adásban több játék szerepel, a !játék parancsnak azt kell mutatnia, amelyik éppen megy, az adástervet pedig jobb külön !ütemterv parancsba vagy a csatorna leírásába tenni.

Üres kategóriához készítsen érthető választ: „Текущая категория пока не указана” vagy „Сейчас разговорный эфир”. A Nightbotban és a StreamElementsben ez a kezelés külön parancsot vagy a szöveg kézi módosítását igényelheti. Egy egyedi API-szkriptben ellenőrizheti, hogy üres-e a game_name mező, és behelyettesíthet egy tartalék változatot.

A kézi parancs működő tartalék marad: „Сейчас играем в: a játék neve”. A hátránya nyilvánvaló — könnyű elfelejteni frissíteni a játékváltás után, és a nézők hibás információt kapnak.

Jogosultságok, késleltetés és ellenőrzés adás előtt

A fő !játék parancsot általában minden néző számára elérhetően hagyják, de cooldownt adnak hozzá. Ez csökkenti az azonos üzenetek ismétlődését, amikor többen egyszerre kérdezik a játékot. A gyorsítótár törlésére, a szöveg kézi frissítésére vagy az Action újraindítására szolgáló parancsot hagyja a moderátoroknak és a csatorna tulajdonosának.

A bot, a token vagy a Twitch-integráció cseréje után ellenőrizze a parancsot. Még a helyes változó sem segít, ha a bot más csatornához van csatlakoztatva, vagy elvesztette az adatok olvasására vonatkozó engedélyt.

1. Állítsa be a kívánt játékot vagy kategóriát a Twitch paneljén.
2. Győződjön meg arról, hogy az új név látható a csatorna oldalán.
3. Ellenőrizze, hogy a chat bot valóban az Ön csatornájához van csatlakoztatva.
4. Hívja meg a !játék parancsot egy közönséges nézői fiókkal.
5. Változtassa meg a kategóriát, és ismételje meg a hívást a gyorsítótár frissülése vagy a parancs késleltetése után.
6. Ellenőrizze a választ üres kategória esetén és beszélgetős adás közben.
7. Ha API-t használ, ellenőrizze a token érvényességét és a kérés hibanaplóját.