Çat-botda yayımın cari kateqoriyası ilə !oyun əmri

Bot cari oyunun adını haradan alır

!oyun əmri adətən kompüterdə işə salınmış proqramı deyil, Twitch-də kanalın cari kateqoriyasını göstərir. Yayımçı oyunu və ya kateqoriyanı yayım idarəetmə panelində dəyişir, bot isə bu dəyəri daxili dəyişən və ya API sorğusu vasitəsilə alır.

Əgər Twitch panelində əvvəlki oyun qalıbsa, «Ünsiyyət» kateqoriyası seçilibsə və ya sahə doldurulmayıbsa, bot da həmin dəyəri göstərəcək. Çat-bot özü ekrandakı oyunu tanımır: o, platformanın və ya xarici avtomatlaşdırmanın ötürdüyü məlumatlarla işləyir.

Əvvəlcə Twitch-də kanal kateqoriyasını yeniləyin

Əmri qurmazdan əvvəl kateqoriyanı harada dəyişdiyinizi yoxlayın: Creator Dashboard panelində, yayımı idarə etmək üçün proqram vasitəsilə və ya botla inteqrasiya vasitəsilə. Yayım səhifəsində tamaşaçıların gördüyü kanalın yekun statusu vacibdir.

Oyunu dəyişdikdən sonra bütün xidmətlərdə dərhal yenilənməyə ümid etməyin. Bot son dəyəri keşdə saxlaya bilər, platforma isə yenilənmiş məlumatları gecikmə ilə ötürə bilər. !oyun əmri üçün kateqoriyanı yayıma başlamazdan əvvəl dəyişmək və çatdakı cavabı ayrıca yoxlamaq daha yaxşıdır.

Nightbot-da !oyun əmri

Nightbot-da Custom Commands bölməsini açın, !oyun əmri yaradın və Twitch dəyişəni olan mesajı göstərin. Cari kanal üçün adətən belə cavab istifadə olunur: «Сейчас играем в: $(twitch game $(channel))».

$(channel) dəyişəni əmrin çağırıldığı kanalı əvəz edir, $(twitch game ...) isə onun kateqoriyasını sorğu ilə alır. Əgər bot bir neçə kanala xidmət edirsə, bu variant hər əmrdə yayımçının loginini əl ilə yazmaqdan daha rahatdır.

• Command: !oyun
• Message: Сейчас играем в: $(twitch game $(channel))
• Userlevel: Everyone
• Cooldown: çatı eyni cavablarla doldurmamaq üçün gecikmə təyin edin

Nightbot-un çatışmazlığı cavab məntiqinin məhdud olmasıdır. Boş kateqoriyanı, bir neçə mətn variantını və ya öz cədvəlinizdən olan məlumatları əlavə dolayı həllər olmadan emal etmək çətin olacaq.

StreamElements-də kateqoriya ilə əmr

StreamElements-də cari oyunun dəyişəni adətən əmrin cavabına ${game} kimi əlavə olunur. Chat bot bölməsində !oyun əmri yaradın və mətni təyin edin: «Текущая игра: ${game}».

Yadda saxlamazdan əvvəl əmri çatda tamaşaçı hesabı ilə yoxlayın. Əgər bot lazımi kanala qoşulmayıbsa və ya kanal kateqoriyası yenilənməyibsə, dəyişən köhnə dəyəri və ya boş mətn qaytara bilər. Hüquq və gecikmə parametrləri də elə orada, əmrin parametrlərində yerləşir.

• Command: !oyun
• Response: Текущая игра: ${game}
• Permission: Everyone
• Cooldown: çatın aktivliyinə uyğun seçin

StreamElements-in çatışmazlığı əmrin xidmətin özünün Twitch ilə inteqrasiyasından asılı olmasıdır. Avtorizasiya pozulduqda və ya sinxronizasiya gecikdikdə əmri dəyişmədən cavabı əl ilə düzəldə bilməyəcəksiniz.

Streamer.bot vasitəsilə kateqoriyanı necə göstərmək olar

Streamer.bot-da əmri Action vasitəsilə qurmaq daha rahatdır. Twitch kanalı haqqında məlumat alan və sonra çata mesaj göndərən fəaliyyət yaradın. Kanal məlumatlarının alınması alt əmrindən sonra fəaliyyətin arqumentlərində adətən gameName oyun adı mövcud olur.

Send Message alt əmrində, məsələn, göstərin: «Сейчас играем в: %gameName%». Sonra Commands bölməsində Action-u !oyun əmrinə bağlayın. Əgər sizin Streamer.bot qurulumunuzda arqumentin adı fərqlidirsə, əvvəlcə fəaliyyəti test rejimində işə salın və Twitch alt əmrinin qaytardığı arqumentlər siyahısına baxın.

Streamer.bot-un çatışmazlığı daha çox əl ilə qurulmasıdır. Əmri, fəaliyyəti, botun çata girişini və Twitch avtorizasiyasını özünüz bağlamalısınız, buna görə hər hansı mərhələdəki səhv əmri cavabsız qoyacaq.

Twitch API vasitəsilə kateqoriya sorğusu

Fərdi bot, skript və ya Streamer.bot-dakı Action kateqoriyanı birbaşa Twitch API vasitəsilə ala bilər. Bunun üçün əvvəlcə kanalın rəqəmsal identifikatorunu öyrənin: GET https://api.twitch.tv/helix/users?login=kanal_logini sorğusu istifadəçi məlumatlarını, o cümlədən id-ni qaytarır.

Sonra GET https://api.twitch.tv/helix/channels?broadcaster_id=KANAL_ID sorğusundan istifadə edin. API cavabında game_name sahəsi var — bu, cari kateqoriyanın adıdır və !oyun əmrinə cavab olaraq çata göndərilə bilər.

Sorğu üçün Client-ID və giriş tokeni olan Authorization başlıqları lazımdır. Tokeni və tətbiq identifikatorunu əmrin açıq mətninə, ictimai repozitoriyaya və ya brauzer vidcetinə yerləşdirməyin: bu məlumatlar botun parametrlərində və ya mühit dəyişənlərində saxlanmalıdır.

API əmrinin qurulması qaydası

1. Twitch developer panelində tətbiq yaradın və Client ID alın.
2. Kanal məlumatlarına girişi olan token alın və onu botunuzun və ya skriptinizin parametrlərində saxlayın.
3. Login vasitəsilə users endpoint-i ilə kanalın broadcaster_id-sini təyin edin.
4. broadcaster_id ilə channels endpoint-inə sorğu göndərin.
5. Cavabdan game_name sahəsini götürün və çat üçün mesaj formalaşdırın.
6. Əgər game_name boşdursa, boş cavab yerinə neytral mətn göstərin.

API-yə çatdakı hər mesaja görə sorğu göndərməyin. Dəyəri !oyun ilk dəfə çağırıldıqda yeniləmək, əmrin gecikməsi müddətində onu saxlamaq və keş bitdikdən sonra məlumatları yenidən almaq daha praktikdir. Kateqoriyanı əl ilə dəyişdikdən sonra dəyəri ayrıca moderator əmri ilə məcburi yeniləmək olar.

Kateqoriyanı necə yeniləməli və köhnə cavab almamaq olar

Əgər oyunu birbaşa yayım zamanı dəyişirsinizsə, əvvəlcə Twitch-də kateqoriyanı yeniləyin, sonra yeni dəyərin kanal səhifəsində görünməsini gözləyin və yalnız bundan sonra !oyun əmrini yoxlayın. Əgər bot keşdən istifadə edirsə, onu təmizləyin və ya növbəti API sorğusunu gözləyin.

Bir kanal üçün adətən kateqoriyanı daimi sorğu ilə yoxlamaq əvəzinə əmr çağırıldıqda yeniləmək kifayətdir. Əgər avtomatik monitorinq lazımdırsa, mülayim intervalla yoxlama aparın və API məhdudiyyətlərini nəzərə alın. Tez-tez sorğular məlumatları daha dəqiq etməyəcək, lakin platforma tərəfindən məhdudiyyətlərə səbəb ola bilər.

Birbaşa API yanaşmasının çatışmazlığı tokeni izləmək lazım olmasıdır. Giriş ləğv edildikdən, parol dəyişdirildikdən, tətbiqin hüquqları dəyişdirildikdən və ya avtorizasiya xətasından sonra əmr köhnə kateqoriyanı göstərməyə başlaya və ya cavab verməyi dayandıra bilər.

Kompüterdə oyunun tanınması və onun məhdudiyyətləri

Ayrıca tanıma aləti yalnız Twitch kateqoriyası əl ilə dəyişmədikdə lazımdır. Belə avtomatlaşdırma işə salınmış prosesi, oyun platformasının məlumatlarını, aktiv pəncərəni və ya telemetriyanı izləyir, oyunu Twitch kateqoriyası ilə uyğunlaşdırır və API vasitəsilə kanalı yeniləyir.

Bundan sonra bot yenə də ekranın məzmununu deyil, Twitch kateqoriyasını oxuyur. Avtomatlaşdırma sadəcə kanal məlumatlarını sizin əvəzinizə dəyişir. Oyun launcher vasitəsilə işə salınıbsa, brauzer versiyası istifadə olunursa, prosesin adı oyunla üst-üstə düşmürsə və ya yayımçı başqa proqrama keçibsə, o, səhv edə bilər.

Tanımanın çatışmazlığı onun ayrıca qurulması və nəzarət edilməsi lazım olmasıdır. Bir neçə oyun, mod, emulyator və texniki səhnələr olan yayımlar üçün kateqoriyanın əl ilə dəyişdirilməsi çox vaxt daha etibarlıdır.

Boş kateqoriya, bir neçə oyun və əl ilə mətn

Platforma yalnız bir cari kateqoriya ötürür. Əgər yayımda bir neçə oyun varsa, !oyun əmri hazırda gedən oyunu göstərməlidir, yayım planını isə ayrıca !cədvəl əmrinə və ya kanal təsvirinə çıxarmaq daha yaxşıdır.

Boş kateqoriya üçün aydın cavab hazırlayın: «Текущая категория пока не указана» və ya «Сейчас разговорный эфир». Nightbot və StreamElements-də belə emal ayrıca əmr və ya mətnin əl ilə dəyişdirilməsini tələb edə bilər. Fərdi API skriptində game_name sahəsinin boş olub-olmadığını yoxlamaq və ehtiyat variant qoymaq olar.

Əl ilə əmr işlək ehtiyat olaraq qalır: «Сейчас играем в: oyunun adı». Çatışmazlıq aydındır — oyunu dəyişdikdən sonra onu yeniləməyi asanlıqla unutmaq olar və tamaşaçılar yanlış məlumat alacaqlar.

Hüquqlar, gecikmə və yayımdan əvvəl yoxlama

Əsas !oyun əmri adətən bütün tamaşaçılar üçün əlçatan saxlanılır, lakin cooldown əlavə olunur. Bu, bir neçə nəfər eyni vaxtda oyunu soruşduqda eyni mesajların təkrarlanmasını azaldır. Keşin təmizlənməsi, mətnin əl ilə yenilənməsi və ya Action-un yenidən işə salınması əmrini moderatorlara və kanal sahibinə buraxın.

Əmri bot, token və ya Twitch inteqrasiyası dəyişdirildikdən sonra yoxlayın. Hətta düzgün dəyişən belə kömək etməyəcək, əgər bot başqa kanala qoşulubsa və ya məlumatları oxumaq icazəsini itiribsə.

1. Twitch panelində lazımi oyunu və ya kateqoriyanı göstərin.
2. Yeni adın kanal səhifəsində göründüyünə əmin olun.
3. Çat-botun məhz sizin kanalınıza qoşulduğunu yoxlayın.
4. !oyun əmrini adi tamaşaçı hesabı ilə çağırın.
5. Kateqoriyanı dəyişin və keş yeniləndikdən və ya əmrin gecikməsindən sonra çağırışı təkrarlayın.
6. Boş kateqoriya və söhbət yayımı zamanı cavabı yoxlayın.
7. Əgər API istifadə olunursa, tokenin etibarlılıq müddətini və sorğu xətaları jurnalını yoxlayın.