官方预制体积木库
专为新项目和独立开发者打造的开箱即用 UI 积木库。预制体均存放于 Packages/com.fasttma.core/Runtime/Prefabs/。只需将预制体拖入场景,即可瞬间获得已挂载好脚本、配置好事件的商业级成熟界面。
1. FastTMA_SafeAreaContainer(全屏安全区容器)
全屏自适应安全区容器,能够自动按硬件像素收缩边距,完美避让 iPhone 灵动岛、刘海、底部 Home 指示条以及 Telegram 顶部标题栏。


- 资产路径:
Packages/com.fasttma.core/Runtime/Prefabs/FastTMA_SafeAreaContainer.prefab - 锚点预设:全屏拉伸 Stretch / Stretch(
Min: 0,0 | Max: 1,1 | 边距: 0) - 核心挂载组件:
TelegramSafeArea - 集成方式:作为根节点直接挂在
Canvas下,将游戏场景中所有需要防遮挡的 UI 控件(顶部金币栏、底部操作栏、弹窗)放入此容器内即可。
2. FastTMA_StarsPayButton(Stars 原生支付按钮)
预制了 Telegram 官方蓝(#2481CC)样式的原生 Stars 支付按钮,内置中度触觉震动反馈与支付状态拦截器。


- 资产路径:
Packages/com.fasttma.core/Runtime/Prefabs/FastTMA_StarsPayButton.prefab - 核心挂载组件:
TelegramStarsButton:管理商品 ID、定价、发票生成与支付成功回调。TelegramHapticButton:点击时分发Medium中度震动反馈。
- 集成方式:拖入货架或商城面板,修改商品名与 Stars 价格,并在底部的
On Purchase Success (String)事件槽直接拖拽绑定道具发放逻辑。
3. FastTMA_UserInfoWidget(用户头像与信息牌)
排版好的水平流布局玩家信息组件,自动拉取并渲染当前打开小程序的 Telegram 真实玩家信息。



- 资产路径:
Packages/com.fasttma.core/Runtime/Prefabs/FastTMA_UserInfoWidget.prefab - 核心挂载组件:
TelegramUserInfoText - 字段选择:通过 Inspector 下拉菜单直接切换要显示的数据:
Id(数字 UID)、Username(用户名)、First Name(名)、Last Name(姓)、Full Name(全名)、Language Code(语言)、Is Premium(大会员)、Photo Url(头像链接)等。
- 集成方式:拖入游戏主界面,启动游戏后文本自动替换为真实玩家信息(在 Unity Editor 中自动展示 Mock 调试数据)。