Telegram открывает перед разработчиками захватывающие возможности с помощью своей Gaming Platform. Теперь ваш бот может предлагать пользователям HTML5-игры, которые можно запускать как в одиночку, так и в групповых или личных чатах. Это новый тип контента, который добавляет интерактивности и веселья в общение. Оригинал документации доступен на официальном сайте Telegram, а здесь мы представляем адаптированный перевод с дополнительными комментариями и советами.
Боты могут предлагать своим пользователям HTML5 игры для игры в одиночку или для соревнований друг с другом в группах и личных чатах. Игры — это новый тип контента в Telegram, который ваш бот может отправлять пользователям.
Посмотрите на ботов @gamebot и @gamee, чтобы увидеть примеры того, что можно делать с помощью новой игровой платформы.
Веб-приложения
С апреля 2022 года вы также можете использовать Web Apps для создания мощных игр с использованием JavaScript.
Посмотрите Руководство по Web App для получения подробной информации.
Создание игры
Чтобы начать, отправьте команду /newgame @BotFather. Вам будет предложено ввести текст описания и загрузить фото. Вы также можете загрузить необязательную GIF-анимацию, которая демонстрирует вашу игру пользователям, чтобы сделать сообщения с игрой более привлекательными (посмотрите примеры Lumberjack или Corsairs).
Запуск игры
Как только игра создана, ваш бот может отправлять её в чаты как обычные сообщения или предлагать их через инлайн-режим. Сообщение об игре всегда будет содержать инлайн кнопку Играть.
Когда эта кнопка нажата, ваш бот получает запрос обратного вызова, который указывает на запрашиваемую игру. Вы предоставляете правильный URL для этого конкретного пользователя, и приложение автоматически открывает игру в встроенном браузере.
Отслеживание рекордов
Сообщение с вашей игрой также будет отображать высокие достижения для текущего чата. Когда устанавливается новый рекорд, в чат будет отправлено служебное сообщение, и сообщение с текущей таблицей рекордов будет обновлено. Вы также можете запросить необходимые данные для создания таблиц рекордов в игре.
Публикация игры в чатах
Существует множество способов, с помощью которых пользователи могут вирусно распространить вашу игру, если она им понравится. Интерфейс всегда будет иметь стандартную кнопку "поделиться" для игры в верхнем правом углу:
Вы также можете создать дополнительную Кнопку на вашей HTML-странице. Нажатие на эту кнопку отправит игру в желаемый чат вместе с лучшим результатом пользователя в игре.
Чтобы добавить кнопку "поделиться", включите этот скрипт в конце тега <body> на вашей странице:
<script src="https://telegram.org/js/games.js"></script>Затем используйте метод TelegramGameProxy.shareScore(), чтобы вызвать опцию "поделиться".
Предупреждение: Не вызывайте этот метод без согласия и прямого действия пользователя.
Пример:
<button onclick="TelegramGameProxy.shareScore()">Поделиться результатом</button>Эта библиотека будет работать только при запуске изнутри Telegram, поэтому, пожалуйста, не используйте ее на обычных веб-страницах.
Использование параметров URL
Если ваш URL использует идентификатор фрагмента, обратите внимание, что приложения Telegram могут добавлять определенные служебные параметры к идентификатору фрагмента. Имена таких параметров будут начинаться с tg (вы можете проверить код, который их добавляет здесь). Используйте объект TelegramGameProxy.initParams, если вам нужно прочитать ваши собственные параметры из идентификатора фрагмента.
Создание отличного HTML5-опыта
Пожалуйста, убедитесь, что ваша HTML5 страница адаптивна и хорошо работает во всех приложениях Telegram и поддерживаемых платформах. Если вы считаете невозможным поддерживать определенные условия или платформы, не оставляйте своих пользователей в неведении и хотя бы предоставьте уведомление.
Смотрите Руководство по Bot API для соответствующих методов и объектов.