Asosiy kontentga o‘tish
Innovialabs

Telegram’dagi o‘yinlar: Games API yoki Mini App — qanday ishlaydi

Asoslar3 daq

Qisqacha

Games API — chatdagi rekordlar jadvali bilan HTML5-o‘yinni ishga tushirishning oddiy eski usuli, Mini App esa to‘liq ekran, foydalanuvchi ma’lumotlari, Stars’da to‘lov va ulashishni beradi; yangi loyihalar uchun deyarli doim Mini App tanlanadi.

Qisqa javob: Telegram’da o‘yin yaratishning ikki usuli

Telegram’da o‘yinlar uchun ikki mexanizm bor va ikkalasi ham ilova ichida oddiy HTML5-o‘yinni ishga tushiradi.

  • Games API — Mini Apps’dan oldin paydo bo‘lgan platforma. Bot chatga «O‘ynash» tugmali o‘yin kartochkasini yuboradi, o‘yin ichki brauzerda ochiladi, ochkolar esa umumiy rekordlar jadvaliga tushadi.
  • Mini App — Telegram ichidagi veb-ilova: foydalanuvchi ma’lumotlari, to‘liq ekran rejimi, Stars’da to‘lovlar va ulashish funksiyalari bilan. Bu yerda o‘yin — Mini App turlaridan biri xolos.

Yangi loyiha uchun ko‘p hollarda Mini App tanlanadi. Games API guruh chatidagi rekordlar jadvali muhim bo‘lgan oddiy o‘yinlar uchun ma’noga ega.

Games API qanday ishlaydi

  1. BotFather’da /newgame buyrug‘i bilan o‘yin yaratiladi: nom, tavsif, rasm va short name.
  2. Bot shu short name bilan sendGameni chaqiradi. Chatda ishga tushirish tugmali kartochka paydo bo‘ladi.
  3. Bosilganda bot game_short_name bilan callback_query oladi va o‘yin URL’i bilan answerCallbackQuery orqali javob beradi.
  4. O‘yin ochiladi, tugagach serveringiz setGameScoreni chaqiradi, getGameHighScores esa shu chat o‘yinchilari reytingini qaytaradi.
  5. Inline-rejim orqali foydalanuvchi o‘yinni istalgan chatga yuborib, do‘stlarini chaqirishi mumkin.

Cheklov: Telegram o‘yin sahifasiga deyarli hech narsa uzatmaydi. Kim o‘ynayotganini o‘zingiz aniqlaysiz — masalan, bot shakllantiradigan URL’dagi imzolangan parametr orqali.

Mini App’dagi o‘yin qanday ishlaydi

Mini App imzoli initData oladi, server u orqali foydalanuvchini tekshiradi. Keyin Games API’da yo‘q imkoniyatlar ochiladi:

  • to‘liq ekran rejimi va ekran yo‘nalishini boshqarish;
  • o‘yinning o‘zida Stars’da to‘lov;
  • o‘yinchining kichik ma’lumotlari uchun bulutli xotira;
  • vibratsiya, Telegram interfeysi tugmalari, bosh ekranga yorliq;
  • ulashish: chatlarga yuborish uchun tayyor xabarlar, hikoyalarga joylash, referal mexanika uchun parametrli havolalar.

Solishtirish

MezonGames APIMini App
Ishga tushirishChatdagi o‘yin kartochkasiMenyu tugmasi, havola, xabardagi tugma
Foydalanuvchi ma’lumotlariURL orqali o‘zingiz uzatasizImzoli initData
Rekordlar jadvaliIchki, chat bo‘yichaServerda o‘zingiz qilasiz
To‘lovlarFaqat bot orqali alohidaO‘yin ichida Stars
EkranIchki brauzerTo‘liq ekran rejimi ham bor
Platforma rivojiSezilarli o‘zgarishlarsizFaol rivojlanmoqda

Monetizatsiya

  • Stars. Mini App ichidagi raqamli tovar va xizmatlar uchun Telegram Stars’dan foydalanishni talab qiladi. Bu qo‘shimcha jonlar, skinlar, darajalar, reklamasiz rejim bo‘lishi mumkin.
  • Reklama. Mini Apps uchun uchinchi tomon reklama tarmoqlari mavjud: bannerlar, to‘liq ekranli qo‘shimchalar, mukofotli videolar. Reklama o‘yin siklini buzmasligi muhim.
  • Faqat pul emas. Brend uchun o‘yin ko‘pincha ichki sotuvlar bilan emas, kanal obunachilari, lidlar, promokodlar va taniqlilik orqali o‘zini oqlaydi.

Virusli mexanikalar

  • Referal havolalar. startapp parametrli havola o‘yinchini kim taklif qilganini ko‘rsatadi; taklif uchun bonus beriladi.
  • Do‘stga chaqiruv. O‘yinchi natijasini «O‘ynash» tugmali tayyor xabar sifatida chatga yuboradi.
  • Do‘stlar va guruhdagi reytinglar — qaytib kelish uchun kuchli turtki.
  • Hikoyalar. Natijani hikoyaga joylash kontaktlardan yangi o‘yinchilarni olib keladi.

Mexanikalar spamga aylanib ketmasligini kuzating: buni na Telegram qoidalari, na foydalanuvchilar kechiradi.

Biznes aslida nima qila oladi

  • Mahsulot chiqishi yoki mavsumiy aksiya uchun promokod sovrinli promo-o‘yin.
  • Mahsulot yoki brend haqida, natijasini ulashgingiz keladigan kviz.
  • Geymifikatsiyalangan sodiqlik dasturi: xaridlar uchun ballar, darajalar, kunlik vazifalar.
  • Murakkab mahsulot uchun o‘yin shaklidagi onboarding.

Agar o‘yinda sovrinlar o‘ynalsa, mamlakatingizda rag‘batlantiruvchi aksiyalar va lotereyalarga oid qonun talablarini oldindan tekshiring.

Ko‘p beriladigan savollar

Ha. Phaser, PixiJS, Unity WebGL va boshqa dvijoklardagi o‘yinni Mini App sifatida ishga tushirish mumkin. Odatda uni mobil ekranga moslashtirish, initData tekshiruvini qo‘shish, to‘lovlar va ulashishni ulash kerak bo‘ladi.

Bunda yordam beramiz

O‘zingiz shug‘ullanmasdan natija olishni istasangiz — biz har kuni shu bilan shug‘ullanamiz.

Loyihani muhokama qilish

Yana o‘qing

G‘oya yoki vazifangiz bormi? Bizga aytib bering

Ish kuni davomida javob beramiz va yechim taklif qilamiz. Konsultatsiya bepul.