VRM设置
概述
VRM（Virtual Reality Model）是一种3D角色模型格式，在AITuberKit中，您可以使用VRM模型来显示AI角色。
环境变量:
bash
# 选择的VRM模型路径
NEXT_PUBLIC_SELECTED_VRM_PATH=/vrm/default.vrm
# VRM角色的照明强度（0.1-3.0）
NEXT_PUBLIC_LIGHTING_INTENSITY=1.0准备VRM模型
AITuberKit支持以下VRM版本：
- VRM 0.0
- VRM 1.0
要使用VRM模型，请按照以下步骤操作：
- 准备VRM文件（.vrm扩展名）
- 将VRM文件放置在
public/vrm目录中 - 在应用程序中选择VRM模型
加载模型
从选项中选择
应用程序中可用的VRM模型可以从下拉菜单中选择。选择后，模型会实时切换。
上传新的VRM模型
通过点击"打开VRM"按钮，您可以上传本地VRM文件以在应用程序中使用。上传的VRM文件会自动保存在public/vrm目录中，并添加到选择选项中。
如何操作模型
3D模型可以通过以下鼠标操作自由调整：
调整位置、方向和大小
- 右键点击 + 拖动：移动头像的位置
- 左键点击 + 拖动：旋转头像的方向
- 鼠标滚轮滚动：放大或缩小头像的大小
通过组合这些操作，您可以将屏幕上的头像放置调整到最佳状态。根据屏幕构成自由定制角色的外观。
照明强度
VRM角色的照明强度可以通过环境变量 NEXT_PUBLIC_LIGHTING_INTENSITY 进行调整。值可以设置在0.1到3.0的范围内。
姿势设置
为VRM角色应用姿势的功能。可以在角色设置选项卡中添加、删除和排序姿势。
姿势调整模式
在设置画面的角色设置选项卡中启用"姿势调整模式"后，屏幕上会显示姿势按钮。点击按钮即可将对应的姿势应用到角色上。
姿势类型
姿势有两种类型：
- 普通姿势: 使用一个姿势JSON文件应用固定姿势
- 序列姿势: 交替播放多个姿势JSON文件以创建动画（例如：挥手、鼓掌等）
默认姿势
以下姿势为默认提供：
| 姿势ID | 类型 | 说明 |
|---|---|---|
| think | 普通 | 思考姿势 |
| cheer | 普通 | 加油姿势 |
| cross | 普通 | 叉号姿势 |
| mouth_cover | 普通 | 捂嘴姿势 |
| crossed_arms | 普通 | 双臂交叉姿势 |
| bow | 普通 | 鞠躬姿势 |
| shrug | 普通 | 耸肩姿势 |
| shy | 普通 | 害羞姿势 |
| wave | 序列 | 挥手动画 |
| clap | 序列 | 鼓掌动画 |
添加姿势
可以从角色设置选项卡的"姿势设置"部分添加新姿势。
添加普通姿势
- 输入ID（例如：
think） - 从下拉菜单中选择姿势JSON文件
- 点击"添加"按钮
添加序列姿势
- 输入ID（例如：
wave） - 选择2个以上交替播放的JSON文件
- 设置切换间隔（秒）（0.1~5.0秒）
- 点击"添加"按钮
创建自定义姿势JSON
您可以创建自定义的姿势JSON文件并放置在 public/poses/ 目录中来使用自定义姿势。支持VRM Web Pose格式的JSON。
此外，也可以使用 scripts/vrma_to_json.py 脚本将VRMA文件转换为姿势JSON。
关于模型的注意事项
- 某些模型在初始显示时可能需要时间加载
- 显示效果可能因浏览器类型和版本而异
- 大型VRM文件可能会影响性能
关于VRM模型许可证
请务必检查您使用的VRM模型的许可证。可能有商业使用或再分发的限制。使用VRM模型时，请遵循创作者的使用条款。