在智能硬件与情感陪伴、儿童教育、银发关怀等行业中，用户需要随时与 AI 进行自然语音对话，并统一管理多个「角色/设备」身份。传统方案往往依赖单一网页或分散工具，存在连接不稳定、语音体验差、角色配置与账号体系割裂等问题。本项目立项旨在为「小智」类语音智能服务提供一体化移动端入口，打通账号登录、设备列表与对话会话，降低终端用户使用门槛。业务背景为：企业与个人用户已通过云端（云函数与 WebSocket）接入 AI 能力，需在 iOS/Android 上提供稳定、可迭代的原生级体验，以支撑日常陪伴、互动娱乐与轻量客服等场景。
「伴语」客户端面向已登录用户提供主对话界面：支持文本与按住说话式语音输入，消息气泡展示多轮对话；内置与小智服务的 WebSocket 长连接，含连接状态巡检与断线自动重连策略；可发起语音通话模式，配合 Opus 等编解码与录音、播放链路完成实时语音交互。侧链能力包括：从服务端拉取并缓存设备/角色列表，在角色管理、角色库、生成与音色等页面中切换当前使用配置；个人中心与资料维护；启动时版本检测与 APK 下载安装类更新流程；权限申请（麦克风、存储、Android 蓝牙等）与本地配置持久化（SharedPreferences）。整体以 Provider 管理全局配置，并与后端云函数 req 统一鉴权与多语言请求头，形成「账号—设备—会话—音视频」闭环。
项目采用 Flutter 跨平台实现，入口完成 Opus 与 AudioUtil 初始化及权限申请；使用 MaterialApp 结合本地 userInfo 分流欢迎页、登录页与 ChatPage。核心业务通过单例 XiaozhiService 与 XiaozhiWebSocketManager 维护 WebSocket 与事件分发，聊天页集成 XiaozhiConfig、消息模型与 UI 组件；网络层以 http/dio 调用云函数域名并携带 token，辅以 record、just_audio、flutter_pcm_player 等完成采集与播放，实现端到端可运行的移动客户端工程。
评论