小遇 (Xiaoyu) 是一款面向 iOS 和 Android 平台的开源数字人陪伴应用。它允许用户通过选择官方形象或上传照片创建自定义角色,并配置独特的人设与声音,从而实现与数字人的实时语音、视频互动。该应用目前处于开发与内测阶段(版本 0.1.0+1),底层接入了 Vidu S2-Avatar 实时版 技术,旨在提供低延迟、高拟真的沉浸式陪伴体验。

核心功能亮点
1. 灵活的角色创建与管理
- 官方形象库:浏览并选择平台推荐的预设形象,系统会自动预填名称、人设及简介,用户只需微调即可使用。
- 自建角色:支持从本地相册上传照片(JPG/PNG/WEBP,<20 MiB)创建专属数字人。用户可深度定制角色名称(最多 30 字)、详细人设(最多 5 万字)、开场白及记忆开关等高级设置。
- 草稿与资产管理:支持保存未完成的配置为草稿,所有角色数据通过 Drift + SQLite 本地存储,确保隐私安全。
2. 实时音视频通话
- 云端驱动:点击角色卡片即可发起通话,连接由 Vidu 提供 Agora 入会信息,无需用户自行配置声网房间。
- 交互界面:全屏展示数字人画面,配备绿色呼吸灯指示通话状态及计时器。为保持沉浸感,界面不显示双方转写字幕。
- 控制选项:支持麦克风静音、声音播放开关、输出路由选择及随时挂断。App 在前台运行时保持亮屏以防休眠,切入后台则自动结束通话以节省资源。
3. 丰富的动作与文字互动
- 106 个快捷动作:涵盖常用、吃喝、外表、表情、手势、道具六大类,用户可通过横向滑动快速选择并发送动作指令。
- 文字聊天:通过键盘输入面板发送文本消息,与动作发送独立操作。
- 注意:动作效果取决于平台渲染能力,当前版本暂无执行成功回执,连续动作发送有 2 秒本地间隔限制。
4. 历史记录与账号管理
- 会话追踪:在“我的”页面可查看最近记录及全部历史会话详情,包括平台结束核对状态。
- API Key 配置:用户需在设置中填入有效的 Vidu 开放平台 API Key。支持将密钥保存至系统安全存储(开启“记住密钥”后),或仅在当前进程中使用。
- 多语言支持:根据设备系统语言自动切换中文或英文界面。

技术架构与依赖
- 前端框架:Flutter,支持跨平台部署。
- 后端服务:
- Vidu S2-Avatar:提供实时数字人渲染与驱动能力。
- Agora (声网):提供实时音视频传输通道,由 Vidu 代为配置入会参数。
- 数据存储:Drift + SQLite 用于本地持久化存储角色、草稿、历史消息及配置信息。
- 安全存储:利用系统级安全存储机制保存用户 API Key。
开始使用指南
由于项目不内置 API Key 且不提供正式安装包,用户需通过源码编译运行:
- 准备环境:
- 安装 Flutter 及对应平台(iOS/Android)开发环境。
- 注册 Vidu 开放平台 账号,获取 API Key 并确保账户拥有实时数字人调用权限及足够余额。
- 确保网络可访问 Vidu 和 Agora 服务。
- 配置账号:
- 打开 App,进入“我的 → 右上角设置 → 账号设置”。
- 输入昵称和 Vidu API Key,点击“检查连接”进行鉴权。
- 建议开启“记住密钥”以便后续自动登录。
- 创建与通话:
- 在首页选择官方形象或点击“新增”上传照片创建角色。
- 等待形象处理就绪后,点击角色卡片发起通话。
- 通话期间保持 App 在前台,通过语音或快捷动作与数字人互动。
注意事项
- 计费说明:真实通话产生云端费用,具体以 Vidu 平台记录为准。App 内显示的“待核对”状态表示本地已释放连接,但平台计费可能尚未完全停止,需保留记录以备核对。
- 隐私保护:当前版本不发布本地摄像头画面,仅采集麦克风音频用于交互。
- 开发状态:组件版尚未迁移,部分功能(如动作回执)仍在完善中。
小遇通过开源代码和灵活的配置方式,为开发者和个人用户提供了一个探索实时数字人交互的实验平台。随着 Vidu 技术的迭代和小遇功能的完善,未来有望带来更丰富、更智能的虚拟陪伴体验。