03 · Stars 虚拟币支付
用于拉起 Telegram 原生收银台,扣除 Stars 并安全下发商品。
双轨接入方式
Track A — 预制体积木工作流
- 打开
03_StarsPayment_Demo演示场景。 - 将
FastTMA_StarsPayButton拖入Canvas或商城货架面板下。 - 选中按钮,在 Inspector 中配置
TelegramStarsButton参数:
| 字段 | 说明 |
|---|---|
| Product Id | 商品唯一标识符(如 vip_pass_tier1) |
| Title | 收银台标题,最多 32 字(如 30天 VIP 通行证) |
| Description | 商品描述,最多 255 字 |
| Stars Price | 扣除 Stars 数量(如 50) |
- 履约绑定:在组件底部的
On Purchase Success (String)事件槽中点击 +,拖入道具发放脚本(如BagManager),从下拉菜单中选择奖励发放方法。
Track B — 非侵入式组件挂载
- 在商业项目中选择现有自定义购买按钮(保留原有动画与材质)。
- 点击 Add Component →
TelegramStarsButton。 - 将原 Button OnClick 中的发放方法移除,绑定到
TelegramStarsButton的OnPurchaseSuccess事件槽。
运行时逻辑:点击后组件自动完成:
- 向步骤 2 部署的 Cloudflare Worker 请求发票链接
- 拉起原生 Telegram 收银台
- 支付确认后触发道具发放函数
演示参考
完整演示实现请参见 Packages/com.fasttma.core/Samples/03_StarsPayment。