保留现有语音技术栈，通过 Spatius 官方插件加入同步、端侧渲染的实时 3D 数字人。
克隆 Spatius Avatar Demo 仓库，然后进入 LiveKit Agents Quickstart 目录。
git clone https://github.com/spatius-ai/spatius-avatar-demo.gitcd spatius-avatar-demo/platform-integrations/livekit-agents-demo/livekit-agent-quickstart复制两份模板并打开，然后在 backend/.env 与 frontend/.env 中填入 Spatius、LiveKit 和 Google AI Studio 凭证。
cp backend/.env.example backend/.envcp frontend/.env.example frontend/.env安装前后端依赖。后端会将 livekit-agents、livekit-plugins-google 与 livekit-plugins-spatius 锁定为匹配版本。
# backendcd backenduv sync# frontendcd ../frontendpnpm install分别启动 Token Server、LiveKit Agent Worker 和前端。打开 localhost:3000，依次点击 Connect 与 Enable Mic。
# Terminal 1: token servercd spatius-avatar-demo/platform-integrations/livekit-agents-demo/livekit-agent-quickstart/backenduv run token_server.py# Terminal 2: LiveKit agent workercd spatius-avatar-demo/platform-integrations/livekit-agents-demo/livekit-agent-quickstart/backenduv run agent.py dev# Terminal 3: frontendcd spatius-avatar-demo/platform-integrations/livekit-agents-demo/livekit-agent-quickstart/frontendpnpm devLiveKit Agents 继续编排对话；Spatius 把语音转成同步 motion data，再由 AvatarKit 在本地渲染。
LiveKit 传输同步音频与 motion data；AvatarKit 再在用户设备上把数据渲染成透明、可交互的 3D 数字人。
LiveKit 同步传输 Agent 语音与 Spatius motion data。
AvatarKit RTC 在本地渲染数字人。
LiveKit 传输同步音频和 motion data，而不是持续传输渲染后的视频流。
透明 3DGS 数字人层可以自然嵌入你的界面、前景和背景。
渲染工作在浏览器完成，减少逐会话服务端视频渲染带来的 GPU 负担。
motion-first 架构避免为每个会话单独渲染并推送一条视频流。
LiveKit 继续处理实时语音会话，Spatius 则加入可见的数字人层，让语言练习更像面对面交流。
阅读客户案例
不会。VAD、STT、LLM、TTS、轮次管理和业务逻辑仍由你的 LiveKit Agent 负责。Spatius 只把 Agent 的语音转成 motion data，并在 Web 客户端渲染数字人。
数字人轨道承载的是同步 motion data，而不是已经渲染好的视频帧。请使用 @spatius/avatarkit-rtc 与 AvatarKit 在本地解码和渲染。
LiveKit Agents 集成的客户端路径目前面向 Web。iOS 和 Android 请通过其他集成路径使用 Spatius 原生 SDK。
Spatius 和 LiveKit 的密钥必须保存在服务端，不要把 SPATIUS_API_KEY 或 LIVEKIT_API_SECRET 写进浏览器代码。