01 · 用户画像与身份读取

用于提取并在 UI 上展示玩家真实的 Telegram 昵称、数字 ID、语言偏好及大会员身份。

---

双轨接入方式

Track A — 预制体积木工作流

1. 打开 01_UserInfo_Demo 演示场景。
2. 在 Packages/com.fasttma.core/Runtime/Prefabs/ 中找到 FastTMA_UserInfoWidget，将其直接拖入 Canvas 节点下。
3. 点击 Play，界面将自动展示格式化后的玩家全名与用户名。

编辑器行为

在 Unity Editor 内，控件自动使用 Mock 调试数据进行预览，无需连接真实 Telegram 账号。

---

Track B — 非侵入式组件挂载

1. 在现有项目中选择任意包含 Text 或 TextMeshPro - Text (UI) 组件的节点。
2. 点击 Add Component → TelegramUserInfoText。
3. 在 Inspector 面板中配置 Format 格式模板：

占位符	说明
{firstName}	名（First Name）
{username}	用户名（带 @ 符号）
{id}	数字 UID
{isPremium}	大会员状态

格式模板示例：

玩家：{firstName}（@{username}）| ID：{id}

---

演示参考

完整演示实现请参见 Packages/com.fasttma.core/Samples/01_UserInfo。