Het commando !game met de huidige streamcategorie in de chatbot

Waar de bot de naam van de huidige game vandaan haalt

Het commando !game toont meestal niet de applicatie die op de computer draait, maar de huidige categorie van het kanaal op Twitch. De streamer wijzigt de game of categorie in het bedieningspaneel van de uitzending, en de bot haalt deze waarde op via een ingebouwde variabele of een API-verzoek.

Als in het Twitch-paneel nog de vorige game staat, de categorie 'Praten' is geselecteerd of het veld niet is ingevuld, geeft de bot dezelfde waarde weer. De chatbot zelf herkent de game op het scherm niet: hij werkt met gegevens die het platform of een externe automatisering aanlevert.

Werk eerst de kanaalcategorie op Twitch bij

Controleer voordat je het commando instelt waar je de categorie wijzigt: in het Creator Dashboard, via een programma voor streambeheer of via een integratie met de bot. Belangrijk is de uiteindelijke status van het kanaal die kijkers op de uitzendingspagina zien.

Reken na het wisselen van game niet op een onmiddellijke update in alle diensten. De bot kan de laatste waarde in de cache bewaren, en het platform kan bijgewerkte gegevens met vertraging doorgeven. Voor het commando !game kun je de categorie beter voor aanvang van de uitzending wijzigen en het antwoord apart in de chat controleren.

Het commando !game in Nightbot

Open in Nightbot Custom Commands, maak het commando !game aan en geef een bericht met de Twitch-variabele op. Voor het huidige kanaal gebruikt men meestal dit antwoord: 'We spelen nu: $(twitch game $(channel))'.

De variabele $(channel) vult het kanaal in waarin het commando wordt aangeroepen, en $(twitch game ...) vraagt de categorie daarvan op. Als de bot meerdere kanalen bedient, is deze variant handiger dan in elk commando handmatig de login van de streamer in te vullen.

• Command: !game
• Message: We spelen nu: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: stel een vertraging in om de chat niet te vullen met dezelfde antwoorden

Het nadeel van Nightbot is de beperkte logica van het antwoord. Een lege categorie, meerdere tekstvarianten of gegevens uit je eigen schema verwerken is lastig zonder extra omwegen.

Het commando met categorie in StreamElements

In StreamElements wordt de variabele voor de huidige game meestal als ${game} aan het antwoord van het commando toegevoegd. Maak in het onderdeel Chat bot het commando !game aan en stel de tekst in: 'Huidige game: ${game}'.

Controleer het commando voordat je opslaat in de chat met een kijkersaccount. Als de bot niet aan het juiste kanaal is gekoppeld of de kanaalcategorie niet is bijgewerkt, kan de variabele een oude waarde of een lege tekst teruggeven. De instellingen voor rechten en vertraging staan op dezelfde plek, bij de parameters van het commando.

• Command: !game
• Response: Huidige game: ${game}
• Permission: Everyone
• Cooldown: stem af op de activiteit in de chat

Het nadeel van StreamElements is dat het commando afhankelijk is van de integratie van de dienst zelf met Twitch. Bij een storing in de autorisatie of een vertraging in de synchronisatie kun je het antwoord niet handmatig corrigeren zonder het commando te wijzigen.

Hoe je de categorie via Streamer.bot weergeeft

In Streamer.bot kun je het commando handiger via een Action opbouwen. Maak een actie die informatie over het Twitch-kanaal ophaalt en vervolgens een bericht naar de chat stuurt. Na de subactie voor het ophalen van kanaalgegevens is in de argumenten van de actie meestal de naam van de game gameName beschikbaar.

Geef in de subactie Send Message bijvoorbeeld op: 'We spelen nu: %gameName%'. Koppel daarna de Action aan het commando !game in het onderdeel Commands. Als in jouw versie van Streamer.bot de naam van het argument anders is, voer de actie dan eerst in testmodus uit en bekijk de lijst met argumenten die de Twitch-subactie heeft teruggegeven.

Het nadeel van Streamer.bot is de extra handmatige configuratie. Je moet zelf het commando, de actie, de toegang van de bot tot de chat en de Twitch-autorisatie aan elkaar koppelen, dus een fout in welke stap dan ook laat het commando zonder antwoord.

De categorie opvragen via de Twitch API

Een aangepaste bot, script of Action in Streamer.bot kan de categorie rechtstreeks via de Twitch API ophalen. Zoek daarvoor eerst het numerieke kanaal-id op: het verzoek GET https://api.twitch.tv/helix/users?login=kanaal_login geeft gebruikersgegevens terug, inclusief id.

Gebruik vervolgens het verzoek GET https://api.twitch.tv/helix/channels?broadcaster_id=KANAAL_ID. In het antwoord van de API staat het veld game_name — dat is de naam van de huidige categorie, die je als antwoord op !game naar de chat kunt sturen.

Voor het verzoek zijn de headers Client-ID en Authorization met een toegangstoken nodig. Plaats het token en het applicatie-id niet in de openbare tekst van het commando, een publieke repository of een browservidget: deze gegevens moeten worden opgeslagen in de instellingen van de bot of in omgevingsvariabelen.

Volgorde voor het instellen van een API-commando

1. Maak een applicatie aan in het developerpaneel van Twitch en verkrijg het Client ID.
2. Verkrijg een token met toegang tot de kanaalgegevens en sla het op in de instellingen van je bot of script.
3. Bepaal de broadcaster_id van het kanaal via het endpoint users op basis van de login.
4. Stuur een verzoek naar het endpoint channels met de broadcaster_id.
5. Neem het veld game_name uit het antwoord en stel het chatbericht samen.
6. Als game_name leeg is, geef dan een neutrale tekst weer in plaats van een leeg antwoord.

Vraag de API niet op bij elk chatbericht. Het is praktischer om de waarde bij de eerste aanroep van !game bij te werken, deze te bewaren voor de duur van de commandocooldown en de gegevens opnieuw op te halen nadat de cache is verlopen. Na een handmatige wijziging van de categorie kun je de waarde geforceerd bijwerken met een apart moderatiecommando.

Hoe je de categorie bijwerkt zonder een oud antwoord te krijgen

Als je de game midden in de uitzending wijzigt, werk dan eerst de categorie op Twitch bij, wacht tot de nieuwe waarde op de kanaalpagina verschijnt en controleer pas daarna !game. Als de bot een cache gebruikt, leeg deze dan of wacht op het volgende API-verzoek.

Voor één kanaal is het meestal voldoende om de categorie bij te werken bij een aanroep van het commando in plaats van een permanente polling te starten. Als automatische monitoring nodig is, controleer dan met een gematigd interval en houd rekening met de beperkingen van de API. Frequente verzoeken maken de gegevens niet nauwkeuriger, maar kunnen leiden tot beperkingen van de kant van het platform.

Het nadeel van de directe API-aanpak is dat je het token in de gaten moet houden. Na het intrekken van toegang, een wachtwoordwijziging, een wijziging van de app-rechten of een autorisatiefout kan het commando een oude categorie gaan weergeven of helemaal niet meer reageren.

Gameherkenning op de computer en de beperkingen ervan

Een apart hulpmiddel voor herkenning is alleen nodig wanneer de Twitch-categorie niet handmatig wordt gewijzigd. Zo'n automatisering volgt een actief proces, gegevens van het gameplatform, het actieve venster of telemetrie, koppelt de game aan een Twitch-categorie en werkt het kanaal bij via de API.

Daarna leest de bot nog steeds de Twitch-categorie, niet de inhoud van het scherm. De automatisering wijzigt alleen de kanaalgegevens voor je. Ze kan fouten maken als de game via een launcher draait, een browserversie wordt gebruikt, de procesnaam niet overeenkomt met de game of de streamer naar een ander programma is overgestapt.

Het nadeel van herkenning is dat je het apart moet instellen en controleren. Voor streams met meerdere games, mods, emulators en technische scènes is handmatig wisselen van categorie vaak betrouwbaarder.

Lege categorie, meerdere games en handmatige tekst

Het platform geeft slechts één huidige categorie door. Als er meerdere games in de uitzending zijn, moet het commando !game de game tonen die nu bezig is, en kun je het uitzendschema beter in een apart commando !schema of in de kanaalbeschrijving zetten.

Bereid voor een lege categorie een duidelijk antwoord voor: 'De huidige categorie is nog niet opgegeven' of 'Nu is het een praatuitzending'. In Nightbot en StreamElements kan zo'n verwerking een apart commando of handmatige tekstwijziging vereisen. In een aangepast API-script kun je controleren of het veld game_name leeg is en een reservevariant invoegen.

Een handmatig commando blijft een werkende reserveoptie: 'We spelen nu: naam van de game'. Het nadeel is duidelijk — je vergeet het makkelijk bij te werken na een gamewissel, en kijkers krijgen onjuiste informatie.

Rechten, vertraging en controle voor de uitzending

Het basiscommando !game laat men meestal voor alle kijkers beschikbaar, maar met een cooldown. Dat vermindert herhaalde identieke berichten wanneer meerdere mensen tegelijk naar de game vragen. Laat het commando voor het legen van de cache, het handmatig bijwerken van de tekst of het herstarten van de Action aan moderators en de kanaaleigenaar.

Controleer het commando na een wissel van bot, token of Twitch-integratie. Zelfs een correcte variabele helpt niet als de bot aan een ander kanaal is gekoppeld of de toestemming om gegevens te lezen heeft verloren.

1. Geef de gewenste game of categorie op in het Twitch-paneel.
2. Controleer of de nieuwe naam zichtbaar is op de kanaalpagina.
3. Controleer of de chatbot aan jouw kanaal is gekoppeld.
4. Roep !game aan met een gewoon kijkersaccount.
5. Wijzig de categorie en herhaal de aanroep na het bijwerken van de cache of de commandocooldown.
6. Controleer het antwoord bij een lege categorie en tijdens een praatuitzending.
7. Als de API wordt gebruikt, controleer dan de geldigheid van het token en het foutenlogboek van het verzoek.