Uncategorized

如何构建你的第一个 Telegram Mini App:分步指南

如何构建你的第一个 Telegram Mini App:分步指南

Telegram vs. 微信:超级应用之战

微信长期以来一直主导着超级应用市场。自 2011 年推出以来,它已无缝集成消息、社交媒体、支付和电子商务,成为中国人日常生活中不可或缺的一部分。

而 Telegram,尽管在 2013 年才推出,但它增长迅速,正逐步成为全球超级应用的有力竞争者。凭借注重安全性、去中心化和 Mini Apps,Telegram 已成功建立了一个与微信生态系统相抗衡的竞争环境。

Telegram 和微信的主要区别:

 

功能微信Telegram
推出年份2011 年2013 年
主要市场中国(全球影响力有限)全球
隐私保护加密有限;遵守中国法律规定端到端加密;严格的隐私政策
超级应用功能成熟的生态系统:支付、购物、服务快速扩展,支持 Mini Apps 和加密钱包
用户基础约 13 亿月活跃用户(主要在中国)超过 8 亿月活跃用户(全球范围)

 

微信长期以来一直主导着中国市场,作为一款多功能集成的超级应用。然而,Telegram 正在全球范围内发起强有力的挑战。凭借对隐私的高度重视、前沿功能以及为开发者提供的强大工具,Telegram 正在开辟独特的发展空间。

得益于 Telegram Mini Apps (TMA),开发者现在可以创建无缝集成到 Telegram 平台的 Web 应用。这一创新帮助 Telegram 迅速缩小与微信的差距,并在全球范围内提升其吸引力。

接下来,我们将深入探讨如何创建自己的 Mini App,并加入这股日益壮大的开发者浪潮,充分挖掘 Telegram 的潜力。

什么是 Telegram Mini Apps,为什么它们如此受欢迎?

Telegram Mini Apps (TMA) 本质上是在 Telegram 生态系统中运行的 Web 应用程序。它们类似于传统的 HTML、CSS 和 JavaScript 网站,但能够访问 Telegram 独有的功能,如用户数据集成和内置支付系统。

为什么开发者喜欢 Telegram Mini Apps:

 

功能优势
无需通过应用商店或 Google Play 审核跳过冗长的审核流程,更快上线。
无需安装用户可以直接在 Telegram 内访问您的应用。
自由选择技术栈使用 React、Vue 或纯 JavaScript 构建——选择最适合您的技术栈。
庞大的用户群覆盖超过 8 亿名 Telegram 用户。

 

成功的 Telegram Mini Apps 示例

让我们看看一些真实案例,了解其潜力:

  • Wallet – 一个支持 TON 交易的钱包,具有购买用户名的功能。
  • Hamster Kombat – 一款点击类游戏,获得了极高的用户互动。
  • DurgerKing – 一个模仿快餐连锁店的趣味体验,仅供娱乐。

如何开始使用 Telegram Mini Apps

所需准备:

  • 一个代码编辑器(VS Code 或 WebStorm 均可)。
  • 基本的 HTML、CSS 和 JavaScript 知识。
  • 在手机和电脑上安装 Telegram。
  • 探索新事物的兴趣和动力。

步骤 1:创建一个辅助 Bot

您的旅程从创建一个 Bot 开始。这个 Bot 将作为您的 Mini App 的入口点。以下是操作步骤:

  1. 在 Telegram 中搜索 @BotFather。
  2. 发送命令 /newbot。
  3. 选择一个适合的 Bot 名称。
  4. 保存 BotFather 提供的 token,稍后您将需要它来与 API 进行交互。

例如,以下是一个使用 Node.js 构建的简单 Bot:

картинка1

 

const TelegramBot = require(‘node-telegram-bot-api’);

const bot = new TelegramBot(token, { polling: true });

 

bot.onText(/\/start/, (msg) => {

  const chatId = msg.chat.id;

  bot.sendMessage(chatId, ‘Welcome! Click the button below to open the app.’, {

    reply_markup: {

      inline_keyboard: [[

        {

          text: ‘Open App’,

          web_app: { url: ‘https://your-domain.com/app’ }

        }

      ]]

    }

  });

});

步骤 2:设置开发环境

创建一个基础的项目结构:

картинка2

 

my-tma/

├── index.html

├── styles/

│   └── main.css

├── scripts/

│   └── app.js

└── assets/

    └── images/

 

最小化的 index.html 示例:

 

картинка3

 

<!DOCTYPE html>

<html>

<head>

    <meta charset=”UTF-8″>

    <meta name=”viewport” content=”width=device-width, initial-scale=1.0″>

    <title>My First TMA</title>

    <link rel=”stylesheet” href=”styles/main.css”>

    <script src=”https://telegram.org/js/telegram-web-app.js”></script>

</head>

<body>

    <div id=”app”>

        <h1>Hello, Telegram!</h1>

    </div>

    <script src=”scripts/app.js”></script>

</body>

</html>

 

步骤 3:构建您的应用

以下是一个简单的计数器应用示例:

 

картинка4

 

app.js:

const app = {

  data: { count: 0 },

 

  init() {

    this.setupTheme();

    this.setupCounter();

    this.setupMainButton();

  },

 

  setupTheme() {

    const theme = window.Telegram.WebApp.themeParams;

    document.body.style.backgroundColor = theme.bg_color;

    document.body.style.color = theme.text_color;

  },

 

  setupCounter() {

    const counter = document.createElement(‘div’);

    counter.innerHTML = `

      <h2>Counter: <span id=”count”>0</span></h2>

      <button id=”increment”>+1</button>

      <button id=”decrement”>-1</button>

    `;

    document.querySelector(‘#app’).appendChild(counter);

 

    document.querySelector(‘#increment’).onclick = () => this.updateCount(1);

    document.querySelector(‘#decrement’).onclick = () => this.updateCount(-1);

  },

 

  setupMainButton() {

    const MainButton = window.Telegram.WebApp.MainButton;

    MainButton.setText(‘Save’);

    MainButton.onClick(() => this.saveData());

    MainButton.show();

  },

 

  updateCount(delta) {

    this.data.count += delta;

    document.querySelector(‘#count’).textContent = this.data.count;

  },

 

  saveData() {

    window.Telegram.WebApp.sendData(JSON.stringify(this.data));

  }

};

 

window.Telegram.WebApp.ready();

app.init();

为您的应用设计样式

使用 Telegram 的设计指南来确保原生外观。以下是基本样式:

 

картинка5

 

/* main.css */

body {

  margin: 0;

  padding: 16px;

  font-family: -apple-system, BlinkMacSystemFont, ‘Segoe UI’, Roboto, Helvetica, Arial, sans-serif;

}

 

#app {

  max-width: 600px;

  margin: 0 auto;

}

 

button {

  background: var(–tg-theme-button-color, #3390ec);

  color: var(–tg-theme-button-text-color, #ffffff);

  border: none;

  border-radius: 8px;

  padding: 8px 16px;

  margin: 4px;

  cursor: pointer;

}

 

button:hover {

  opacity: 0.9;

}

 

扩展功能

在构建基础功能后,您可以:

  • 集成 TON 进行支付。
  • 在服务器上存储用户数据。
  • 添加动画和高级逻辑。

接下来的步骤

  • 在 HTTPS 服务器上托管您的应用。
  • 通过 @BotFather 添加应用 URL。
  • 在真实环境中进行测试。
  • 收集用户反馈并进行优化迭代。

按照这些步骤,您将顺利创建一个成功的 Telegram Mini App,并充分利用该平台不断扩展的生态系统。

加入 Telegram 廣告領導者團隊

在我們的頻道中找到有關電報廣告的所有問題的答案