Comanda !joc cu categoria curentă a streamului în chatbot

De unde obține botul numele jocului curent

Comanda !joc afișează de obicei nu aplicația rulată pe calculator, ci categoria curentă a canalului pe Twitch. Streamerul schimbă jocul sau categoria în panoul de control al transmisiunii, iar botul preia această valoare printr-o variabilă integrată sau printr-o cerere către API.

Dacă în panoul Twitch a rămas jocul anterior, este selectată categoria „Social” sau câmpul nu este completat, botul va afișa aceeași valoare. Chatbotul în sine nu recunoaște jocul de pe ecran: el lucrează cu datele transmise de platformă sau de o automatizare externă.

Mai întâi actualizează categoria canalului pe Twitch

Înainte de a configura comanda, verifică unde schimbi categoria: în panoul Creator Dashboard, printr-un program de gestionare a streamului sau printr-o integrare cu botul. Contează starea finală a canalului pe care o văd spectatorii pe pagina transmisiunii.

După schimbarea jocului nu te baza pe o actualizare instantanee în toate serviciile. Botul poate păstra ultima valoare în cache, iar platforma poate transmite datele actualizate cu întârziere. Pentru comanda !joc este mai bine să schimbi categoria înainte de începerea emisiei și să verifici separat răspunsul în chat.

Comanda !joc în Nightbot

În Nightbot deschide Custom Commands, creează comanda !joc și indică mesajul cu variabila Twitch. Pentru canalul curent se folosește de obicei acest răspuns: „Acum jucăm: $(twitch game $(channel))”.

Variabila $(channel) înlocuiește canalul în care este apelată comanda, iar $(twitch game ...) solicită categoria acestuia. Dacă botul deservește mai multe canale, această variantă este mai comodă decât să scrii manual loginul streamerului în fiecare comandă.

• Command: !joc
• Message: Acum jucăm: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: setează o întârziere pentru a nu aglomera chatul cu răspunsuri identice

Dezavantajul Nightbot este logica limitată a răspunsului. Gestionarea unei categorii goale, a mai multor variante de text sau a datelor din propriul program fără soluții ocolitoare suplimentare va fi dificilă.

Comanda cu categoria în StreamElements

În StreamElements variabila jocului curent se adaugă de obicei în răspunsul comenzii ca ${game}. În secțiunea Chat bot creează comanda !joc și setează textul: „Jocul curent: ${game}”.

Înainte de salvare verifică comanda în chat cu un cont de spectator. Dacă botul nu este conectat la canalul potrivit sau categoria canalului nu s-a actualizat, variabila poate returna valoarea veche sau un text gol. Setările de permisiuni și întârziere se află tot acolo, în parametrii comenzii.

• Command: !joc
• Response: Jocul curent: ${game}
• Permission: Everyone
• Cooldown: alege-l în funcție de activitatea chatului

Dezavantajul StreamElements este că comanda depinde de integrarea serviciului însuși cu Twitch. În cazul unei erori de autorizare sau al unei întârzieri de sincronizare, nu vei putea corecta manual răspunsul fără a modifica comanda.

Cum să afișezi categoria prin Streamer.bot

În Streamer.bot comanda se construiește mai comod printr-un Action. Creează o acțiune care obține informații despre canalul Twitch și apoi trimite un mesaj în chat. După subcomanda de obținere a datelor despre canal, în argumentele acțiunii este de obicei disponibil numele jocului gameName.

În subcomanda Send Message indică, de exemplu: „Acum jucăm: %gameName%”. Apoi leagă Action de comanda !joc în secțiunea Commands. Dacă în versiunea ta de Streamer.bot numele argumentului diferă, rulează mai întâi acțiunea în modul de test și verifică lista de argumente returnată de subcomanda Twitch.

Dezavantajul Streamer.bot este configurarea manuală mai amplă. Trebuie să legi singur comanda, acțiunea, accesul botului la chat și autorizarea Twitch, așa că o eroare la oricare etapă va lăsa comanda fără răspuns.

Cererea categoriei prin Twitch API

Un bot personalizat, un script sau un Action din Streamer.bot poate obține categoria direct prin Twitch API. Pentru aceasta află mai întâi identificatorul numeric al canalului: cererea GET https://api.twitch.tv/helix/users?login=login_canal returnează datele utilizatorului, inclusiv id.

Apoi folosește cererea GET https://api.twitch.tv/helix/channels?broadcaster_id=ID_CANAL. În răspunsul API există câmpul game_name — acesta este numele categoriei curente, care poate fi trimis în chat ca răspuns la !joc.

Pentru cerere sunt necesare antetele Client-ID și Authorization cu un token de acces. Nu insera tokenul și identificatorul aplicației în textul deschis al comenzii, într-un repository public sau într-un widget de browser: aceste date trebuie păstrate în setările botului sau în variabilele de mediu.

Ordinea configurării comenzii API

1. Creează o aplicație în panoul pentru dezvoltatori Twitch și obține Client ID.
2. Obține un token cu acces la datele canalului și salvează-l în setările botului sau ale scriptului tău.
3. Determină broadcaster_id al canalului prin endpointul users după login.
4. Trimite cererea către endpointul channels cu broadcaster_id.
5. Ia din răspuns câmpul game_name și formează mesajul pentru chat.
6. Dacă game_name este gol, afișează un text neutru în loc de un răspuns gol.

Nu interoga API-ul la fiecare mesaj din chat. Este mai practic să actualizezi valoarea la primul apel al !joc, să o păstrezi pe durata întârzierii comenzii și să obții din nou datele după expirarea cache-ului. După schimbarea manuală a categoriei poți forța actualizarea valorii printr-o comandă separată pentru moderatori.

Cum să actualizezi categoria și să nu primești un răspuns vechi

Dacă schimbi jocul chiar în timpul emisiei, actualizează mai întâi categoria pe Twitch, apoi așteaptă ca noua valoare să apară pe pagina canalului și abia după aceea verifică !joc. Dacă botul folosește cache, golește-l sau așteaptă următoarea cerere către API.

Pentru un singur canal este de obicei suficient să actualizezi categoria la apelul comenzii, nu să pornești o interogare constantă. Dacă ai nevoie de monitorizare automată, fă verificarea la un interval moderat și ține cont de limitele API. Cererile frecvente nu fac datele mai precise, dar pot duce la restricții din partea platformei.

Dezavantajul abordării directe prin API este că trebuie să urmărești tokenul. După revocarea accesului, schimbarea parolei, modificarea permisiunilor aplicației sau o eroare de autorizare, comanda poate începe să afișeze categoria veche sau poate înceta să răspundă.

Recunoașterea jocului pe calculator și limitările ei

Un instrument separat de recunoaștere este necesar doar atunci când categoria Twitch nu este schimbată manual. O astfel de automatizare urmărește procesul rulat, datele platformei de jocuri, fereastra activă sau telemetria, asociază jocul cu categoria Twitch și actualizează canalul prin API.

După aceea botul citește în continuare categoria Twitch, nu conținutul ecranului. Automatizarea doar schimbă datele canalului în locul tău. Ea poate greși dacă jocul este lansat printr-un launcher, se folosește versiunea de browser, numele procesului nu corespunde jocului sau streamerul a trecut la alt program.

Dezavantajul recunoașterii este că trebuie configurată și controlată separat. Pentru streamurile cu mai multe jocuri, moduri, emulatoare și scene tehnice, schimbarea manuală a categoriei este adesea mai sigură.

Categorie goală, mai multe jocuri și text manual

Platforma transmite doar o singură categorie curentă. Dacă în emisie sunt mai multe jocuri, comanda !joc trebuie să arate jocul care rulează acum, iar planul transmisiunii este mai bine să fie pus într-o comandă separată !program sau în descrierea canalului.

Pentru o categorie goală pregătește un răspuns clar: „Categoria curentă nu este încă indicată” sau „Acum este o emisie de discuții”. În Nightbot și StreamElements o astfel de gestionare poate necesita o comandă separată sau schimbarea manuală a textului. Într-un script API personalizat poți verifica dacă câmpul game_name este gol și poți introduce o variantă de rezervă.

Comanda manuală rămâne o rezervă funcțională: „Acum jucăm: numele jocului”. Dezavantajul este evident — este ușor să uiți să o actualizezi după schimbarea jocului, iar spectatorii vor primi informații greșite.

Permisiuni, întârziere și verificare înainte de emisie

Comanda principală !joc este de obicei lăsată accesibilă tuturor spectatorilor, dar cu un cooldown adăugat. Astfel se reduc mesajele identice repetate atunci când mai multe persoane întreabă simultan despre joc. Comanda de golire a cache-ului, de actualizare manuală a textului sau de repornire a Action lasă-o moderatorilor și proprietarului canalului.

Verifică comanda după schimbarea botului, a tokenului sau a integrării Twitch. Chiar și o variabilă corectă nu va ajuta dacă botul este conectat la alt canal sau a pierdut permisiunea de citire a datelor.

1. Indică jocul sau categoria dorită în panoul Twitch.
2. Asigură-te că noul nume este vizibil pe pagina canalului.
3. Verifică dacă chatbotul este conectat exact la canalul tău.
4. Apelează !joc de pe un cont obișnuit de spectator.
5. Schimbă categoria și repetă apelul după actualizarea cache-ului sau a întârzierii comenzii.
6. Verifică răspunsul la o categorie goală și în timpul unei emisii de discuții.
7. Dacă se folosește API-ul, verifică valabilitatea tokenului și jurnalul de erori al cererii.