Skip to content

官方预制体积木库

专为新项目和独立开发者打造的开箱即用 UI 积木库。预制体均存放于 Packages/com.fasttma.core/Runtime/Prefabs/。只需将预制体拖入场景,即可瞬间获得已挂载好脚本、配置好事件的商业级成熟界面。


1. FastTMA_SafeAreaContainer(全屏安全区容器)

全屏自适应安全区容器,能够自动按硬件像素收缩边距,完美避让 iPhone 灵动岛、刘海、底部 Home 指示条以及 Telegram 顶部标题栏。

FastTMA_SafeAreaContainer 层级FastTMA_SafeAreaContainer 属性面板

  • 资产路径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 支付按钮,内置中度触觉震动反馈与支付状态拦截器。

FastTMA_StarsPayButton 层级FastTMA_StarsPayButton 属性面板

  • 资产路径Packages/com.fasttma.core/Runtime/Prefabs/FastTMA_StarsPayButton.prefab
  • 核心挂载组件
    • TelegramStarsButton:管理商品 ID、定价、发票生成与支付成功回调。
    • TelegramHapticButton:点击时分发 Medium 中度震动反馈。
  • 集成方式:拖入货架或商城面板,修改商品名与 Stars 价格,并在底部的 On Purchase Success (String) 事件槽直接拖拽绑定道具发放逻辑。

3. FastTMA_UserInfoWidget(用户头像与信息牌)

排版好的水平流布局玩家信息组件,自动拉取并渲染当前打开小程序的 Telegram 真实玩家信息。

FastTMA_UserInfoWidget 层级FastTMA_UserInfoWidget 属性面板TelegramUserInfoText 下拉选择

  • 资产路径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 调试数据)。