Digital Human Platform

基于Web技术的3D数字人交互平台

🚀 项目介绍

这是一个完整的数字人项目，实现了3D建模与动画系统、语音交互系统、行为控制系统和渲染引擎等核心功能。

✨ 核心功能

1. 3D建模与动画系统

• ✅ 基于Three.js的高精度3D渲染
• ✅ 支持FBX/GLTF模型格式
• ✅ 实时光影渲染和材质系统
• ✅ 骨骼绑定和面部表情控制

2. 语音交互系统

• ✅ TTS语音合成技术（Web Speech API）
• ✅ ASR语音识别功能
• ✅ 多语言支持（中文优先）
• ✅ 自定义语音参数（音量、音调、语速）

3. 行为控制系统

• ✅ 情感状态机
• ✅ AI驱动的智能决策
• ✅ 可视化行为编辑器
• ✅ 复杂动作序列支持

4. 渲染引擎

• ✅ WebGL实时渲染
• ✅ 响应式设计
• ✅ 多平台适配
• ✅ 性能优化

🛠️ 技术栈

• 前端框架: React 18 + TypeScript
• 3D渲染: Three.js + React Three Fiber
• 状态管理: Zustand
• UI组件: Tailwind CSS + Lucide React
• 构建工具: Vite
• 部署: Vercel

📦 快速开始

安装依赖

npm install

开发模式

npm run dev

构建项目

# 标准构建
npm run build

# 移动端构建
npm run build:mobile

# 桌面端构建
npm run build:desktop

# AR模式构建
npm run build:ar

部署

# 部署到Vercel
npm run deploy

🎯 使用说明

基础控制

• 播放/暂停: 控制数字人动画播放
• 重置: 重置数字人到初始状态
• 自动旋转: 开启/关闭自动旋转展示

语音交互

• 录音: 点击录音按钮开始语音识别
• 语音合成: 支持自定义文本转语音
• 快速命令: 预设常用语音命令

表情控制

• 基础表情: 微笑、惊讶、悲伤、愤怒等
• 强度调节: 0-100%表情强度控制
• 自定义颜色: 支持表情颜色自定义

行为控制

• 行为模式: 待机、打招呼、倾听、思考、说话、兴奋
• 自动决策: AI驱动的自动行为决策
• 高级控制: 专注倾听、思考模式、演讲模式等

🔧 开发文档

项目结构

src/
├── components/          # React组件
│   ├── DigitalHumanViewer.tsx    # 3D数字人查看器
│   ├── ControlPanel.tsx          # 基础控制面板
│   ├── VoiceInteractionPanel.tsx # 语音交互面板
│   ├── ExpressionControlPanel.tsx # 表情控制面板
│   └── BehaviorControlPanel.tsx  # 行为控制面板
├── pages/               # 页面组件
│   ├── DigitalHumanPage.tsx      # 基础数字人页面
│   └── AdvancedDigitalHumanPage.tsx # 高级数字人页面
├── store/               # 状态管理
│   └── digitalHumanStore.ts      # 数字人状态管理
└── utils/               # 工具函数

核心API

数字人查看器组件

<DigitalHumanViewer
  modelUrl="/models/digital-human.glb"
  autoRotate={true}
  showControls={true}
  onModelLoad={(model) => console.log('模型加载完成')}
/>

语音服务

// 语音合成
const tts = new TTSService();
tts.speak('你好，我是数字人助手！', 'zh-CN');

// 语音识别
const asr = new ASRService();
asr.start(); // 开始录音

状态管理

const {
  isPlaying,
  currentExpression,
  setExpression,
  play,
  pause
} = useDigitalHumanStore();

🌐 多平台支持

Web平台

• ✅ 现代浏览器支持
• ✅ 响应式设计
• ✅ PWA支持

移动端

• ✅ 触摸交互优化
• ✅ 移动端UI适配
• ✅ 性能优化

桌面端

• ✅ 桌面级交互体验
• ✅ 键盘快捷键支持
• ✅ 多窗口支持

AR/VR

• ✅ WebXR支持
• ✅ 空间交互
• ✅ 沉浸式体验

📊 性能指标

• 首次加载时间: < 3秒
• 3D渲染帧率: 60 FPS
• 语音响应延迟: < 500ms
• 内存占用: < 200MB
• CPU使用率: < 30%

🔒 安全特性

• ✅ HTTPS强制
• ✅ CSP安全策略
• ✅ XSS防护
• ✅ 内容安全策略

🤝 贡献指南

1. Fork项目
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 创建Pull Request

📄 许可证

本项目采用MIT许可证 - 查看 LICENSE 文件了解详情。

🆘 支持

如遇到问题，请通过以下方式获取支持：

• 📧 邮箱: support@digital-human.com
• 💬 社区: GitHub Discussions
• 🐛 问题报告: GitHub Issues

🌟 更新日志

v1.0.0 (2024-01)

• 🎉 初始版本发布
• ✅ 基础3D渲染功能
• ✅ 语音交互系统
• ✅ 表情控制系统
• ✅ 行为控制系统
• ✅ 多平台支持

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！