ساخت بازی با ربات تلگرام

Copy

دستور پیش‌فرض start با اطلاعاتی درباره وب‌هوک پاسخ می‌دهد. خب، ما نمی‌خواهیم کاربران ما از این موضوع مطلع شوند. بنابراین، بیایید آن را با یک پاسخ ساده جایگزین کنیم.

برای این کار، می‌توانید کد مربوط به دستور `/start` را به صورت زیر تغییر دهید:

async def start(update: Update, context: CustomContext) -> None:
 await update.message.reply_html("Hello!")

Copy

با این تغییر، هنگامی که کاربران دستور `/start` را ارسال می‌کنند، یک پیام خوش‌آمدگویی ساده دریافت خواهند کرد که آن‌ها را برای شروع بازی راهنمایی می‌کند.

برای ارسال بازی از طریق ربات، باید یک handler پیام یا یک handler جستجوی اینلاین داشته باشیم. جستجوهای اینلاین برای این منظور مناسب هستند، زیرا می‌توانند در چت‌هایی که ربات عضو آن‌ها نیست نیز استفاده شوند.

در ادامه، نمونه کدی برای handler جستجوی اینلاین آورده شده است که بازی را ارسال می‌کند:

from telegram import InlineQueryResultGame
from telegram.ext import Updater, InlineQueryHandler, CommandHandler
# توکن ربات خود را جایگزین کنید
TOKEN = 'YOUR_BOT_TOKEN'
def start(update, context):
 update.message.reply_text('سلام! به ربات بازی تلگرام خوش آمدید. برای شروع بازی از دستور /play استفاده کنید.')
def inline_query(update, context):
 query = update.inline_query.query
 results = []
 if query == "game":
 results.append(
 InlineQueryResultGame(
 id="1",
 game_short_name="your_game_short_name"
 )
 )
 context.bot.answer_inline_query(update.inline_query.id, results)
def main():
 updater = Updater(TOKEN, use_context=True)
 dp = updater.dispatcher
 dp.add_handler(CommandHandler("start", start))
 dp.add_handler(InlineQueryHandler(inline_query))
 updater.start_polling()
 updater.idle()
if __name__ == '__main__':
 main()

Copy

در این کد:

یک تابع start داریم که پیام خوش‌آمدگویی ساده‌ای را ارسال می‌کند.

یک تابع inline_query داریم که جستجوهای اینلاین را مدیریت می‌کند و در صورت درخواست بازی، بازی را به عنوان نتیجه جستجو ارسال می‌کند.

در تابع main، ربات با استفاده از توکن مشخص شده شروع به کار می‌کند و handlerهای مربوط به دستورات و جستجوهای اینلاین اضافه می‌شوند.

مطمئن شوید که توکن ربات خود و game_short_name را با مقادیر مناسب جایگزین کنید. این کد پایه‌ای برای راه‌اندازی ربات بازی تلگرام شما است.

برای مدیریت دکمه “بازی” که در بازی‌های تلگرام وجود دارد، باید از handler های Callback Query استفاده کنیم. این handler ها به ما امکان می‌دهند تا به کلیک‌های کاربران بر روی دکمه‌های تعاملی در بازی پاسخ دهیم.

در ادامه، کد کامل برای مدیریت دکمه “بازی” و handler Callback Query آورده شده است:

from telegram import InlineQueryResultGame, CallbackQueryHandler
from telegram.ext import Updater, InlineQueryHandler, CommandHandler
# توکن ربات خود را جایگزین کنید
TOKEN = 'YOUR_BOT_TOKEN'
def start(update, context):
 update.message.reply_text('سلام! به ربات بازی تلگرام خوش آمدید. برای شروع بازی از دستور /play استفاده کنید.')
def inline_query(update, context):
 query = update.inline_query.query
 results = []
 if query == "game":
 results.append(
 InlineQueryResultGame(
 id="1",
 game_short_name="your_game_short_name"
 )
 )
 context.bot.answer_inline_query(update.inline_query.id, results)
def button(update, context):
 query = update.callback_query
 query.answer()
 query.edit_message_text(text="بازی شروع شد! موفق باشید!")
def main():
 updater = Updater(TOKEN, use_context=True)
 dp = updater.dispatcher
 dp.add_handler(CommandHandler("start", start))
 dp.add_handler(InlineQueryHandler(inline_query))
 dp.add_handler(CallbackQueryHandler(button))
 updater.start_polling()
 updater.idle()
if __name__ == '__main__':
 main()

Copy

در این کد:

تابع start پیام خوش‌آمدگویی ساده‌ای ارسال می‌کند.

تابع inline_query جستجوهای اینلاین را مدیریت می‌کند و بازی را به عنوان نتیجه جستجو ارسال می‌کند.

تابع button به کلیک‌های کاربران بر روی دکمه “بازی” پاسخ می‌دهد. این تابع با استفاده از CallbackQueryHandler مدیریت می‌شود.

اطمینان حاصل کنید که توکن ربات خود و game_short_name را با مقادیر مناسب جایگزین کنید. این کد پایه‌ای برای راه‌اندازی ربات بازی تلگرام شما است و شامل مدیریت دکمه “بازی” نیز می‌باشد.

وقتی کاربر روی دکمه کلیک می‌کند، یک آپدیت به این تابع ارسال می‌شود. اگر داده‌های پرس‌وجو (query data) برابر با نام کوتاه بازی شما باشد، یک شناسه منحصر به فرد ایجاد و در یک پایگاه داده همراه با شناسه تلگرام کاربر، نام کوتاه بازی و inline_message_id ذخیره می‌شود. در ادامه، شما خواهید دید که با این مقادیر چه کاری انجام خواهیم داد.

در زیر نمونه کدی برای مدیریت این فرآیند آورده شده است:

from telegram import InlineQueryResultGame, CallbackQueryHandler
from telegram.ext import Updater, InlineQueryHandler, CommandHandler, CallbackContext
from telegram import Update
import sqlite3
# توکن ربات خود را جایگزین کنید
TOKEN = 'YOUR_BOT_TOKEN'
DATABASE = 'game_bot.db'
def start(update: Update, context: CallbackContext):
 update.message.reply_text('سلام! به ربات بازی تلگرام خوش آمدید. برای شروع بازی از دستور /play استفاده کنید.')
def inline_query(update: Update, context: CallbackContext):
 query = update.inline_query.query
 results = []
 if query == "game":
 results.append(
 InlineQueryResultGame(
 id="1",
 game_short_name="your_game_short_name"
 )
 )
 context.bot.answer_inline_query(update.inline_query.id, results)
def button(update: Update, context: CallbackContext):
 query = update.callback_query
 game_short_name = "your_game_short_name"
 if query.data == game_short_name:
 unique_id = generate_unique_id()
 user_id = query.from_user.id
 inline_message_id = query.inline_message_id
 # ذخیره داده‌ها در پایگاه داده
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute("INSERT INTO game_sessions (unique_id, user_id, game_short_name, inline_message_id) VALUES (?, ?, ?, ?)",
 (unique_id, user_id, game_short_name, inline_message_id))
 conn.commit()
 conn.close()
 query.answer()
 query.edit_message_text(text="بازی شروع شد! موفق باشید!")
def generate_unique_id():
 import uuid
 return str(uuid.uuid4())
def main():
 # ایجاد پایگاه داده در صورت عدم وجود
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute('''CREATE TABLE IF NOT EXISTS game_sessions
 (unique_id TEXT, user_id INTEGER, game_short_name TEXT, inline_message_id TEXT)''')
 conn.commit()
 conn.close()
 updater = Updater(TOKEN

Copy

در این کد:

تابع start پیام خوش‌آمدگویی ساده‌ای ارسال می‌کند.

تابع inline_query جستجوهای اینلاین را مدیریت می‌کند و بازی را به عنوان نتیجه جستجو ارسال می‌کند.

تابع button به کلیک‌های کاربران بر روی دکمه “بازی” پاسخ می‌دهد. اگر داده‌های پرس‌وجو برابر با نام کوتاه بازی باشد، یک شناسه منحصر به فرد ایجاد و همراه با شناسه تلگرام کاربر، نام کوتاه بازی و inline_message_id در پایگاه داده ذخیره می‌شود.

مطمئن شوید که توکن ربات خود و game_short_name را با مقادیر مناسب جایگزین کنید. این کد شامل ایجاد و مدیریت پایگاه داده SQLite برای ذخیره داده‌های بازی نیز می‌باشد.

برای ثبت هندلرهای جدید در پایان تابع main، می‌توانید کد خود را به صورت زیر تغییر دهید:

from telegram import InlineQueryResultGame, CallbackQueryHandler
from telegram.ext import Updater, InlineQueryHandler, CommandHandler, CallbackContext
from telegram import Update
import sqlite3
# توکن ربات خود را جایگزین کنید
TOKEN = 'YOUR_BOT_TOKEN'
DATABASE = 'game_bot.db'
def start(update: Update, context: CallbackContext):
 update.message.reply_text('سلام! به ربات بازی تلگرام خوش آمدید. برای شروع بازی از دستور /play استفاده کنید.')
def inline_query(update: Update, context: CallbackContext):
 query = update.inline_query.query
 results = []
 if query == "game":
 results.append(
 InlineQueryResultGame(
 id="1",
 game_short_name="your_game_short_name"
 )
 )
 context.bot.answer_inline_query(update.inline_query.id, results)
def button(update: Update, context: CallbackContext):
 query = update.callback_query
 game_short_name = "your_game_short_name"
 if query.data == game_short_name:
 unique_id = generate_unique_id()
 user_id = query.from_user.id
 inline_message_id = query.inline_message_id
 # ذخیره داده‌ها در پایگاه داده
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute("INSERT INTO game_sessions (unique_id, user_id, game_short_name, inline_message_id) VALUES (?, ?, ?, ?)",
 (unique_id, user_id, game_short_name, inline_message_id))
 conn.commit()
 conn.close()
 query.answer()
 query.edit_message_text(text="بازی

Copy

در این کد:

هندلرها در پایان تابع main ثبت شده‌اند.

هندلر دستور start برای ارسال پیام خوش‌آمدگویی استفاده می‌شود.

هندلر InlineQueryHandler برای مدیریت جستجوهای اینلاین استفاده می‌شود.

هندلر CallbackQueryHandler برای مدیریت کلیک‌های دکمه بازی استفاده می‌شود.

این تغییرات به شما کمک می‌کند تا هندلرهای جدید را در جای مناسب ثبت کنید و ربات بازی تلگرام خود را به درستی پیکربندی کنید.

برای تغییر کامل تابع webhook_update، باید مطمئن شویم که به‌روزرسانی‌های وب‌هوک را به‌درستی مدیریت می‌کنیم. در اینجا یک نمونه کد تغییر یافته برای تابع webhook_update آورده شده است که با سایر بخش‌های کد شما هماهنگ باشد:

from flask import Flask, request
from telegram import Update, Bot
from telegram.ext import Dispatcher, CommandHandler, InlineQueryHandler, CallbackQueryHandler
from telegram import InlineQueryResultGame
import sqlite3
# توکن ربات خود را جایگزین کنید
TOKEN = 'YOUR_BOT_TOKEN'
DATABASE = 'game_bot.db'
bot = Bot(token=TOKEN)
app = Flask(__name__)
# ایجاد دیسپچر تلگرام
dispatcher = Dispatcher(bot, None, workers=0)
def start(update, context):
 update.message.reply_text('سلام! به ربات بازی تلگرام خوش آمدید. برای شروع بازی از دستور /play استفاده کنید.')
def inline_query(update, context):
 query = update.inline_query.query
 results = []
 if query == "game":
 results.append(
 InlineQueryResultGame(
 id="1",
 game_short_name="your_game_short_name"
 )
 )
 context.bot.answer_inline_query(update.inline_query.id, results)
def button(update, context):
 query = update.callback_query
 game_short_name = "your_game_short_name"
 if query.data == game_short_name:
 unique_id = generate_unique_id()
 user_id = query.from_user.id
 inline_message_id = query.inline_message_id
 # ذخیره داده‌ها در پایگاه داده
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute("INSERT INTO game_sessions (unique_id, user_id, game_short_name, inline_message_id) VALUES (?, ?, ?, ?)",
 (unique_id, user_id, game_short_name, inline_message_id))
 conn.commit()
 conn.close()
 query.answer()
 query.edit_message_text(text="بازی شروع شد! موفق باشید!")
def generate_unique_id():
 import uuid
 return str(uuid.uuid4())
# تغییر کامل تابع webhook_update
@app.route('/webhook', methods=['POST'])
def webhook_update():
 if request.method == "POST":
 update = Update.de_json(request.get_json(force=True), bot)
 dispatcher.process_update(update)
 return 'ok'
def main():
 # ایجاد پایگاه داده در صورت عدم وجود
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute('''CREATE TABLE IF NOT EXISTS game_sessions
 (unique_id TEXT, user_id INTEGER, game_short_name TEXT, inline_message_id TEXT)''')
 conn.commit()
 conn.close()
 # ثبت هندلرها
 dispatcher.add_handler(CommandHandler("start", start))
 dispatcher.add_handler(InlineQueryHandler(inline_query))
 dispatcher.add_handler(CallbackQueryHandler(button))
 # تنظیم وب‌هوک
 bot.set_webhook("https://your_server_domain/webhook")
if __name__ == '__main__':
 main()
 app.run(port=8443)

Copy

در این کد:

تابع webhook_update با استفاده از فریم‌ورک Flask تعریف شده است.

دیسپچر تلگرام ایجاد شده و هندلرها به آن اضافه شده‌اند.

در تابع main، جدول پایگاه داده ایجاد و وب‌هوک تنظیم می‌شود.

Flask به پورت 8443 گوش می‌دهد تا به‌روزرسانی‌های وب‌هوک را دریافت کند.

مطمئن شوید که توکن ربات خود و game_short_name را با مقادیر مناسب جایگزین کنید و آدرس your_server_domain را به آدرس سرور واقعی خود تغییر دهید. این تغییرات باید تابع webhook_update را به‌درستی مدیریت کنند و به ربات تلگرام شما اجازه دهند که به‌روزرسانی‌های وب‌هوک را پردازش کند.

برای تکمیل روند به‌روزرسانی امتیاز بازیکن و ارسال پیام سرویس در صورت شکست رکورد، باید اطلاعات ذخیره‌شده در پایگاه داده را بازیابی کرده و با استفاده از متد bot.set_game_score امتیاز بازیکن را به‌روزرسانی کنیم. همچنین، در صورت شکست رکورد، تلگرام یک پیام سرویس به چت ارسال خواهد کرد.

در ادامه، کد تکمیلی برای به‌روزرسانی امتیاز بازیکن آورده شده است:

from flask import Flask, request
from telegram import Update, Bot, InlineQueryResultGame
from telegram.ext import Dispatcher, CommandHandler, InlineQueryHandler, CallbackQueryHandler
import sqlite3
# توکن ربات خود را جایگزین کنید
TOKEN = 'YOUR_BOT_TOKEN'
DATABASE = 'game_bot.db'
bot = Bot(token=TOKEN)
app = Flask(__name__)
# ایجاد دیسپچر تلگرام
dispatcher = Dispatcher(bot, None, workers=0)
def start(update, context):
 update.message.reply_text('سلام! به ربات بازی تلگرام خوش آمدید. برای شروع بازی از دستور /play استفاده کنید.')
def inline_query(update, context):
 query = update.inline_query.query
 results = []
 if query == "game":
 results.append(
 InlineQueryResultGame(
 id="1",
 game_short_name="your_game_short_name"
 )
 )
 context.bot.answer_inline_query(update.inline_query.id, results)
def button(update, context):
 query = update.callback_query
 game_short_name = "your_game_short_name"
 if query.data == game_short_name:
 unique_id = generate_unique_id()
 user_id = query.from_user.id
 inline_message_id = query.inline_message_id
 # ذخیره داده‌ها در پایگاه داده
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute("INSERT INTO game_sessions (unique_id, user_id, game_short_name, inline_message_id) VALUES (?, ?, ?, ?)",
 (unique_id, user_id, game_short_name, inline_message_id))
 conn.commit()
 conn.close()
 query.answer()
 query.edit_message_text(text="بازی شروع شد! موفق باشید!")
def set_game_score(user_id, score, inline_message_id):
 # به‌روزرسانی امتیاز بازیکن
 bot.set_game_score(user_id=user_id, score=score, inline_message_id=inline_message_id, force=True)
 # بازیابی اطلاعات ذخیره شده
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute("SELECT user_id, game_short_name, inline_message_id FROM game_sessions WHERE user_id=?", (user_id,))
 data = c.fetchone()
 conn.close()
 if data:
 user_id, game_short_name, inline_message_id = data
 # به‌روزرسانی امتیاز و ارسال پیام سرویس در صورت شکست رکورد
 bot.set_game_score(user_id=user_id, score=score, inline_message_id=inline_message_id, force=True)
 bot.send_message(chat_id=user_id, text="شما رکورد جدیدی ثبت کردید!")
def webhook_update():
 if request.method == "POST":
 update = Update.de_json(request.get_json(force=True), bot)
 dispatcher.process_update(update)
 return 'ok'
def main():
 # ایجاد پایگاه داده در صورت عدم وجود
 conn = sqlite3.connect(DATABASE)
 c = conn.cursor()
 c.execute('''CREATE TABLE IF NOT EXISTS game_sessions
 (unique_id TEXT, user_id INTEGER, game_short_name TEXT, inline_message_id TEXT)''')
 conn.commit()
 conn.close()
 # ثبت هندلرها
 dispatcher.add_handler(CommandHandler("start", start))
 dispatcher.add_handler(InlineQueryHandler(inline_query))
 dispatcher.add_handler(CallbackQueryHandler(button))
 # تنظیم وب‌هوک
 bot.set_webhook("https://your_server_domain/webhook")
if __name__ == '__main__':
 main()
 app.run(port=8443)

Copy

در این کد:

تابع set_game_score برای به‌روزرسانی امتیاز بازیکن و ارسال پیام سرویس در صورت شکست رکورد تعریف شده است.

در تابع button، اطلاعات بازیکن و بازی در پایگاه داده ذخیره می‌شود.

در تابع webhook_update، به‌روزرسانی‌های وب‌هوک پردازش می‌شوند.

تابع main برای ایجاد پایگاه داده، ثبت هندلرها و تنظیم وب‌هوک تعریف شده است.

مطمئن شوید که توکن ربات خود و game_short_name را با مقادیر مناسب جایگزین کنید و آدرس your_server_domain را به آدرس سرور واقعی خود تغییر دهید. این تغییرات باید به‌روزرسانی امتیاز بازیکن و ارسال پیام سرویس در صورت شکست رکورد را به‌درستی مدیریت کنند.

اگر تجربه‌ای در توسعه وب‌سایت‌های Flask و ربات‌های تلگرام دارید، باقی کارها را می‌دانید!

تنظیم متغیر TOKEN و دیگر موارد ثابت را فراموش نکنید. همچنین باید وب‌هوک ربات را به آدرس API خود تنظیم کنید. نیازمندی‌ها را نصب کرده، فایل را ذخیره کرده و کد را بر روی یک سرور اجرا کنید!

پروژه‌های HTML5 از Godot 4 در حال حاضر نمی‌توانند بر روی macOS و iOS اجرا شوند به دلیل باگ‌های بالادستی مرتبط با SharedArrayBuffer و WebGL 2.0. توصیه می‌شود به جای آن از قابلیت خروجی نیتیو macOS و iOS استفاده کنید، که همچنین باعث بهبود عملکرد می‌شود.

خروجی HTML5 از Godot 3 به طور کلی با مرورگرهای مختلف سازگار‌تر هستند، به خصوص زمانی که از موتور رندرینگ GLES2 (که تنها نیازمند WebGL 1.0 است) استفاده می‌شود.

برای به‌روزرسانی امتیاز بازیکن، از API‌ای که به تازگی ایجاد کردیم استفاده می‌کنیم. می‌توانید در هر جایی از فایل Main.gd از متد eval در JavaScript برای اجرای کد JavaScript استفاده کنید.

JavaScript.eval("fetch('https://YOUR-BOT-HOST/submitpayload?hash' + window.location.search.substring(3) + '&score=%s');" % score)

Copy

این خط، تابع fetch را در جاوااسکریپت فراخوانی می‌کند که یک HTTPRequest به API ما ارسال می‌کند.

می‌توانید یک دکمه اضافه کنید و این کد را به سیگنال فشرده شدن آن ارتباط دهید. وقتی بازیکنان روی دکمه کلیک می‌کنند، یک صفحه باز می‌شود تا بازی و امتیاز به اشتراک گذاشته شود.

func _on_Button_pressed():
 JavaScript.eval("TelegramGameProxy.shareScore();")

Copy

برای گرفتن خروجی از بازی، وارد تنظیمات ویرایشگر شوید و General>Input Devices>Pointing>Emulate Touch From Mouse را فعال کنید. این باعث می‌شود لمس‌های شما به عنوان کلیک‌های موس شناخته شوند.

برای گرفتن خروجی از بازی، به Project>Export بروید تا منوی Export باز شود. یک پیش‌تنظیم HTML5 اضافه کرده و VRAM Texture Compression/For Mobile را فعال کنید. تغییرات دیگری که نیاز دارید را انجام دهید، سپس بر روی Export Project… کلیک کنید تا از پروژه خود به عنوان WebAssembly و HTML خروجی بگیرید.

در فایل‌های استخراج شده، باید یک فایل HTML داشته باشید. آن را به نام index.html تغییر نام دهید و این اسکریپت را به انتهای تگ <body> اضافه کنید:

<script>
 const hash = window.location.search.substring(3);
 fetch('https://your-api-url/submitpayload', {
 method: 'POST',
 headers: {
 'Content-Type': 'application/json',
 },
 body: JSON.stringify({
 user_id: hash,
 payload: 'score=' + SCORE_VARIABLE, // Replace SCORE_VARIABLE with your actual score variable
 }),
 });
</script>

Copy

این کد، هنگام بارگذاری صفحه، هش کاربر را از URL دریافت کرده و با استفاده از fetch یک درخواست POST به آدرس API شما ارسال می‌کند. در این درخواست، شناسه کاربر و امتیاز بازی (SCORE_VARIABLE) به صورت JSON ارسال می‌شوند.

اضافه می‌کند TelegramGameProxy برای به اشتراک گذاری بازی و امتیاز. آخرین مرحله اجرای سرور است. می‌توانید از این اسکریپت پایتون استفاده کنید تا یک وب‌سرور محلی را برای تست فایل صادر شده خود راه‌اندازی کنید. این اسکریپت را در پوشه صادر شده به نام serve.py ذخیره کنید و این دستور را برای اجرای سرور اجرا کنید:

# serve.py
import http.server
import socketserver
PORT = 8000 # شماره پورتی که می‌خواهید استفاده کنید
Handler = http.server.SimpleHTTPRequestHandler
with socketserver.TCPServer(("", PORT), Handler) as httpd:
 print(f"در حال سرویس دادن در پورت {PORT}")
 httpd.serve_forever()

Copy

این اسکریپت را با نام serve.py در همان پوشه‌ای که فایل index.html صادر شده شما در آن قرار دارد ذخیره کنید. سپس، یک ترمینال یا پنجره دستور را باز کنید، به پوشه صادر شده ناوبری کنید و دستور زیر را برای شروع سرور اجرا کنید:

تبریک می‌گویم! با موفقیت یک بازی کامل برای تلگرام ایجاد کردید. می‌توانید آن را به دوستان خود ارسال کرده و از بازی کردن لذت ببرید.

python3 server.py -n --root . # in some operating systems like Windows, use `python` instead.