7.金融知识问答游戏初步开发

7.金融知识问答游戏初步开发摘要本文记录Flutter Unity 游戏 FastAPI 后端混合架构下金融知识游戏模块的完整推进过程。工作并非线性完成而是经历了多条并行线索嵌入与路由在知识页打开 Unity、在个人页展示金币Android 工具链 新版Gradle与旧版 Unity 插件的兼容联调网络模拟器、真机、后端热重载各有不同localhost运行环境x86 模拟器、ARM 模拟器、真机三种环境对 Unity 的支持完全不同玩法与数据题目预取、金币入库、答题反馈等产品迭代进度总览阶段主题解决方案1Flutter 嵌入 Unity打通路由与消息桥2Android 构建Unity 与 Flutter 插件对 NDK 诉求不同3前后端联调登录 200 不代表链路永远稳定4运行环境选型x86 PC 上不要强行走 ARM 模拟器5Unity 生命周期pause 优于 unload6操控与横屏体验输入曲线比绝对速度更重要7AI 题目系统Flutter 做桥后端做源Unity 做表现8金币数据存储内存金币不算数入库才算数一、从Unity工程到Flutter能打开游戏1.1 需求拆解最初需求可以拆成三件事优先级不同需求本质优先级知识页进入游戏路由 原生视图嵌入P0个人页显示金币跨端状态同步P1Unity 配置正确构建能过、真机能跑P0阻塞项这不是写一个游戏页面而是引入第二条运行时Unity Player和第二条通信通道Flutter ↔ Unity 消息。Flutter 页面、Provider、路由都要为这条通道让路。1.2 嵌入架构认知项目选用flutter_unity_widgetUnity工程通过Editor导出到 android/unityLibraryFlutter 侧用 UnityWidget 承载原生视图。UnityNativeFlutterpush /finance-gamegold_update JSONonUnityMessageKnowledgePageFinanceGamePageUnityWidgetGameCoinsProviderunityLibraryUnity PlayerFinanceGameManagerProfilePage 金币展示初版落地knowledge_page.dartAppBar 游戏图标 顶部闯关入口卡片 → /finance-gamefinance_game_page.dartUnityWidget 消息回调 横屏game_coins_provider.dart解析 Unity 的 gold_update 消息FinanceGameManager.cs挂载 UnityMessageManagerAddGold 时向 Flutter 发 JSONprofile_page.dart我的金币卡片混合项目的第一步是消息格式约定我选用简单 JSON。1.3 Unity 导出与 Android 工程关系pubspec.yaml 已声明 flutter_unity_widgetsettings.gradle.kts 已 include:unityLibrary但 C# 脚本改动不会自动进 APK必须在 Unity 里执行Flutter → Export Android Debug导出到 android/unityLibrary这些属于环境配置债务不解决功能代码写得再好也跑不起来。二、Android 构建链2.1 第一个硬错误flutter run 在 :flutter_unity_widget 处失败。根因是 Android Gradle Plugin 8 强制要求 namespace而插件 2022.2.x 仍按 AGP 4 时代编写。处理策略在 pub cache 中补丁 android/build.gradle补 namespace、抬高 compileSdk、统一 JVM 17修复 Kotlin 2.x 下 LifecycleOwner / LifecycleProvider 的 getLifecycle 冲突新增 tool/patch_flutter_unity_widget.ps1每次 flutter pub get 后可重打补丁第三方原生插件的能 pub get 不等于能编过。混合栈要把插件补丁纳入日常流程而不是一次性手工改完就忘。2.2 第二个硬错误组件需要的 NDK原因Unity IL2CPP23.1.7779620Unity 2022.3 推荐工具链Flutter 新插件jni 等27 / 28随 Flutter SDK 升级若全局只配一个版本要么 IL2CPP 编不过要么插件报 version disagrees。那我应该怎么解决第一unityLibrary/build.gradle 固定服务 IL2CPP。第二app/build.gradle.kts 对齐 Flutter 插件。第三去掉 local.properties 里易冲突的 ndk.dir让 Gradle 按模块各自解析。2.3 构建成功的判据看到 Built build\app\outputs\flutter-apk\app-debug.apk只说明 Flutter 壳 unityLibrary 打包成功不代表 Unity 游戏在任意 Android 设备上都能跑因为运行环境还要单独讨论。三、联调网络3.1 API 地址模拟器与真机不是同一套规则app_constants.dart 按平台选择 API Host运行环境应使用的 Host常见误区Android模拟器10.0.2.2误用 127.0.0.1指向模拟器自身Android真机电脑局域网 IP误用 10.0.2.2真机上无效Web与页面同 host—真机联调命令flutter run --dart-defineAPI_HOST电脑局域网IP换 WiFi 或连手机热点后 IP 会变需重新 ipconfig 并确认手机浏览器能打开 http://:8000/health。UI 上的登录失败要先区分是401业务拒绝还是连接超时。前者查账号后者查 Host 与防火墙。四、运行环境4.1 x86 模拟器在 sdk gphone64 x86 64 上打开游戏Unity 弹窗Failed to load ‘libmain.so’Your hardware does not support this application. 因为 unityLibrary 的 abiFilters 仅包含 armeabi-v7a、arm64-v8a没有 x86_64 原生库所以x86 模拟器无法加载 ARM 的 .so。4.2 ARM 模拟器尝试Google Play ARM 64 v8a系统镜像后模拟器启动失败在 Intel/AMD Windows 开发机上不要指望 ARM 系统镜像模拟器跑 Unity。这与代码无关是宿主 CPU 与 AVD 架构不匹配。4.3 环境选型矩阵环境Flutter 常规功能Unity 游戏推荐度x86_64 模拟器✅ 快❌ 缺 ARM 库日常 UI/APIARM 模拟器 x86 PC❌ 不支持—不推荐Android 真机ARM✅✅ 现有导出即可Unity 联调首选x86 模拟器 Unity 导出 x86_64✅⚠️ 需重新 Export可选折中4.4 真机调试最短路径手机开启开发者模式 USB 调试USB 连接并授权flutter devices 确认出现设备电脑 ipconfig 查局域网 IPv4终端 1python main.py 启动后端终端 2flutter run --dart-defineAPI_HOSTIPv4控制台确认 baseUrl http://IPv4:8000/api/v1先测登录再进金融知识问答游戏五、Unity 生命周期5.1 问题进游戏 → 点退出 → 再进 → 闪退日志Unity onDestroy Lost connection to device5.2 原因退出时调用 UnityWidgetController.unload()Unity Player 进入已卸载但实例仍被持有状态。再次进入时插件误判为已加载并复用 → 原生层崩溃。5.3 解决操作含义适用场景pause()暂停渲染与逻辑暂时离开游戏页unload()卸载 Unity Player频繁进出时慎用退出 pause() pop()UnityWidget(unloadOnDispose: false)系统返回键与 AppBar 返回统一走 _exitGame()。六、体验层——横屏与摇杆手感6.1 进游戏自动横屏FinanceGamePage 进入时允许横屏退出恢复竖屏避免在竖屏下操作 3D 场景。6.2 摇杆太灵敏移动逻辑对输入做归一化轻推也是满速。所以我使用多种方法调整保留摇杆推力幅度、增加死区、降低默认速度、推力过小时不触发转身。手感问题多在输入曲线不在绝对速度数值。七、题目系统7.1 架构分层LLMBackendFlutterUnityLLMBackendFlutterUnity场景加载 — 预取NPC 交互 — 即时展示prefetch_quizPOST /knowledge/game-questions/batch批量生成 JSON 题目questions[]CacheQuestions(json)ShowQuestion() 从 Queue 取题层级职责后端AI 出题、JSON 校验、兜底题库FlutterJWT 鉴权、批量请求、消息桥接Unity本地 Queue 缓存、UI 展示、客户端判题7.2 问题交互时现拉题目会有有延迟场景 Start 预取 N 题入队低于阈值自动补货7.3 三种运行环境环境出题通道Unity Editor可直连 /batch/devDEBUGtrue真机 Flutter经 Flutter 桥 JWT纯模拟器 API 测试不涉及 Unity 原生库Editor、模拟器、真机是三条联调路径必须分别验证。八、金币系统8.1 问题版本存储位置问题初期Unity 内存 Flutter 的 SharedPreferences与个人页脱节当前MySQL users.game_coins API后端为权威源8.2 当前数据流DBBackendFlutterUnityDBBackendFlutterUnity进入游戏答对 10GET /game/coinsSELECT game_coinsSetGold(total)gold_update {delta:10}POST /game/coins/deltaUPDATESetGold(服务器总数)Unity 乐观更新 UI但 Flutter 后端 保证最终一致性SharedPreferences 仅作离线兜底。当前进度与已知边界✅ 已完成Flutter 嵌入 Unity知识页入口、游戏页、路由Android 构建插件补丁、双 NDK 策略、IL2CPP 首次编译联调网络模拟器、真机、后端防误重启运行环境认知ABI 预检、真机 Unity 路径文档化使用 pause 策略解决 Unity 反复进出不闪退AI 批量出题 本地缓存 即时展示Unity Editor 独立调试通道金币入库、前后端同步、双端展示答题反馈 UI、解析换行、摇杆手感结语这个模块表面是AI 出题 答对加金币的小游戏实质是一次跨端协作系统工程工具链— 新 Gradle 与老 Unity 插件如何共存网络认知— 模拟器、真机、后端的 localhost 各指谁运行环境— 架构不匹配时代码正确也会原生崩溃数据一致性— 金币不能只活在内存里体验节奏— 预取消除等待、反馈时长匹配阅读