好玩APP

项目简介

好玩 APP 是一款面向 C 端用户的 AI 语音聊天移动应用，用户可与虚拟角色进行实时语音对话，通过亲密度系统与角色解锁机制提升用户粘性。

主要功能

• AI 语音对话：与虚拟角色进行实时语音交互
• 用户认证：手机号登录、验证码发送验证、注册、密码设置
• 亲密度系统：数值随时间自动增长，本地持久化存储
• 二维码扫描：扫描激活码解锁虚拟角色
• 个人中心：完善资料、头像编辑、昵称修改、兴趣标签

技术亮点

WebSocket 心跳保活机制

情境：AI 语音对话需要实时双向通信，使用 WebSocket 长连接。但移动端网络波动大，连接容易断开。

任务：保证语音对话连续性，断线后能快速恢复。

行动：

• 实现 30 秒定时 ping/pong 心跳包，维持连接活跃
• 设计指数退避重连策略：1s → 2s → 4s → 8s，最多重试 5 次
• 连接断开时暂停录音提示用户，重连成功后自动恢复

结果：连接稳定性显著提升，用户很少遇到对话中断的情况。

Opus 音频编解码

情境：语音对话需要实时传输，PCM 原始数据太大（1 分钟约 1MB），直接传输会占用大量带宽。

任务：降低音频传输带宽，同时保证语音质量。

行动：

• 采用 Opus VOIP 模式，针对语音场景优化编码参数
• PCM 16bit 采样、16000Hz、单声道录制
• 实现编码器/解码器生命周期管理：页面切换时检测异常自动重置

结果：压缩比约 1:10，大幅降低网络传输量，语音延迟可控。

智能音频资源管理

情境：Flutter 页面切换时（从聊天页切到个人中心页），音频播放状态不会自动清理，导致解码器状态混乱，出现杂音、卡顿、甚至无声。

任务：解决页面切换时的音频冲突问题，保证每次进入对话页面时音频系统都是干净的状态。

行动：

• 设计页面切换音频重置流程：停止当前播放 → 重置解码器 → 重新初始化
• 实现智能解码器重置策略：连续错误超过 3 次 / 2 秒无数据 / 每 100 块定期清理
• 通过 try-catch 捕获音频异常，自动恢复

结果：页面切换后音频播放正常，不再出现杂音或卡顿。

iOS 平台深度适配

• 后台音频模式：UIBackgroundModes: audio，支持切后台继续播放 AI 回复
• AVAudioSession 配置：playAndRecord 模式，支持蓝牙耳机连接
• 系统权限配置：麦克风（语音录制）、相机（二维码扫描）、蓝牙（音频输出）

工作职责

从 0 到 1 开发 iOS 前端

• 使用 Flutter 框架开发 iOS 端，支持 iOS 13.0+

实时语音通信核心开发

• WebSocket 长连接：实现连接管理、30 秒心跳保活、指数退避重连机制
• 音频处理链路：PCM 采样 → Opus VOIP 编码 → WebSocket 传输 → Opus 解码 → 播放
• 音频资源管理：设计智能解码器重置策略，解决页面切换音频冲突问题

业务模块开发

• 用户认证流程：手机号登录、验证码发送验证、注册、密码设置
• 亲密度系统：ChangeNotifier 监听 + SharedPreferences 持久化，数值随时间自动增长
• 二维码扫码模块：扫描激活码解锁虚拟角色
• 个人中心：资料完善、头像选择、昵称编辑、兴趣标签

iOS 平台适配

• 配置系统权限：麦克风、相机、蓝牙
• 实现后台音频播放模式
• 配置 AVAudioSession 支持蓝牙设备

技术栈 Flutter, Dart, Provider, WebSocket, Opus, CocoaPods, iOS 原生开发