آشنایی با استفاده از setGameScore در API ربات تلگرام
با سلام به دوستان عزیز! امروز می‌خواهیم درباره یکی از قابلیت‌های جالب ربات‌های تلگرامی صحبت کنیم که مربوط به بازی‌ها می‌شود. به خصوص تابع setGameScore که می‌تواند به شما کمک کند تا امتیازات بازی‌ها را مدیریت کنید. این موضوع می‌تواند برای کسانی که می‌خواهند با ربات‌های بازی در تلگرام کار کنند بسیار مهم باشد.
بازی‌ها در تلگرام روز به روز محبوب‌تر می‌شوند و این به معنی ایجاد رقابت بین کاربران است. بنابراین نیازی به گفتن نیست که چقدر مهم است تا بتوانید امتیازات بازی‌ها را به راحتی مدیریت کنید. با استفاده از setGameScore، شما میتوانید امتیازات کاربر را در بازی تغییر دهید - چه بخواهید یک امتیاز جدید بدهید یا امتیاز یک کاربر را کاهش دهید.
شاید بپرسید: "چگونه این تابع کار می‌کند؟" اساساً با این تابع، شما میتوانید امتیاز یک کاربر مشخص را در یک بازی خاص بروزرسانی کنید. فقط کافی است شناسه بازی، شناسه کاربر و امتیاز جدید را به این تابع بدهید. خیلی راحت است، درست است؟
ما در ادامه یک کد نمونه ساده برای شما خواهیم نوشت که نشان می‌دهد چطور میتوانید از setGameScore استفاده کنید. بیایید با هم نگاهی به کد بیندازیم و ببینیم چگونه می‌توان این تابع را به ظاهر زیبای کد خود اضافه کنید!
const telegramBot = require('node-telegram-bot-api');
// توکن ربات خود را قرار دهید
const bot = new telegramBot('YOUR_BOT_TOKEN', { polling: true });
bot.onText(//setscore (\d+) (\d+)/, (msg, match) => {
const chatId = msg.chat.id;
const userId = match[1]; // شناسه کاربر
const score = match[2]; // امتیاز جدید
bot.setGameScore(userId, score)
.then((result) => {
bot.sendMessage(chatId, `امتیاز کاربر ${userId} به ${score} تغییر یافت.`);
}).catch((error) => {
bot.sendMessage(chatId, 'خطا در تغییر امتیاز!');
});
});
توضیحات کد
الان به خط به خط کد بپردازیم و توضیح دهیم که هر قسمت چه کاری انجام می‌دهد:
const telegramBot = require('node-telegram-bot-api');: این خط کتابخانه‌ای که برای کار با API ربات تلگرام استفاده می‌شود را وارد می‌کند.const bot = new telegramBot('YOUR_BOT_TOKEN', { polling: true });: در اینجا باید توکن ربات خود را قرار دهید تا بتوانید با API کار کنید.bot.onText(/\/setscore (\d+) (\d+)/, (msg, match) => {: این خط منتظر پیام‌هایی است که با دستور/setscoreشروع می‌شوند و دو ضربدر عددی را دریافت می‌کند.const chatId = msg.chat.id;: شناسه چت کنونی را دریافت می‌کنیم تا بتوانیم پاسخ‌ها را ارسال کنیم.const userId = match[1];: شناسه کاربر را از پیام دریافت شده استخراج می‌کنیم.const score = match[2];: امتیاز جدیدی که قرار است به کاربر داده شود را استخراج می‌کنیم.bot.setGameScore(userId, score): این تابع برای تغییر امتیاز کاربر خاص در بازی استفاده می‌شود.bot.sendMessage(chatId, `امتیاز کاربر ${userId} به ${score} تغییر یافت.`);: در صورت موفقیت‌آمیز بودن عملیات، پیامی به چت ارسال می‌کنیم که تغییر امتیاز را اعلام کند.bot.sendMessage(chatId, 'خطا در تغییر امتیاز!');: در صورت بروز خطا در تغییر امتیاز، این پیام ارسال می‌شود.