AI Friends SDK

Appearance

常见问题 (FAQ) ​

本文档收集了 AI Friends SDK 使用过程中的常见问题和解决方案。

目录 ​

安装与环境 ​

Q1: 我需要什么才能开始使用 AI Friends SDK？ ​

💬A: 您需要：

  • AI Friends 平台账号：用于上传和管理角色
  • Unity 2022.3 LTS：推荐使用长期支持版本
  • Unity Hub：用于管理 Unity 版本和项目
  • iOS & Android Build Support：Unity 的构建支持模块
  • Windows/Mac 电脑：能够运行 Unity 的计算机

快速开始

建议使用官方启动器，它会自动帮您配置所需环境。详情请查看安装与配置教程。

Q2: 必须使用启动器吗？我可以手动安装吗？ ​

💬A: 不是必须的，但强烈推荐使用启动器。启动器会：

  • 自动安装正确版本的 Unity
  • 自动配置项目环境
  • 减少配置错误的可能性

如果您选择手动安装，请确保：

  • Unity 版本为 2022.3 LTS
  • 已安装 iOS & Android Build Support
  • 正确导入 AI Friends SDK

详情请查看自行安装 Unity。

Q3: 我的电脑已经安装了 Unity，需要卸载重新安装吗？ ​

💬A: 不需要卸载。您可以：

  1. 在 Unity Hub 中安装 Unity 2022.3 LTS（可以同时安装多个版本）
  2. 使用 Unity 2022.3 打开 AI Friends SDK 项目
  3. 确保已安装 iOS & Android Build Support 模块

多版本共存

Unity Hub 支持同时安装多个 Unity 版本，您可以在不同项目中使用不同版本。

Unity 相关问题 ​

Q4: 我可以使用 Unity 2023.x 或其他版本吗？ ​

💬A: 不建议。AI Friends SDK 目前仅支持 Unity 2022.3 LTS 版本。

使用其他版本可能导致：

  • 功能异常
  • 构建失败
  • 兼容性问题

请查看Unity 版本支持文档了解详细信息。

Q5: 为什么必须安装 iOS & Android Build Support？ ​

💬A: AI Friends SDK 需要这些模块来：

  • 确保跨平台兼容性
  • 正确打包和优化资源
  • 支持多平台部署

来保证您上传的角色在多个平台上可用

Q6: 如何检查我的 Unity 版本是否正确？ ​

💬A: 有几种方法：

  1. 通过 Unity Hub：

    • 打开 Unity Hub
    • 查看"安装"标签页中的版本列表
    • 确认是否有 Unity 2022.3.x

  2. 在 Unity 编辑器中：

    • 打开 Unity 编辑器
    • 点击 Help > About Unity
    • 查看版本信息

  3. 查看项目设置：

    • 在 Unity 中打开项目
    • Edit > Project Settings > Player
    • 查看 Unity 版本信息

模型相关问题 ​

Q7: 支持哪些模型格式？ ​

💬A: AI Friends SDK 支持以下格式：

  • .fbx：常见的 3D 模型格式
  • .vrm：VRoid Studio 导出的格式
  • .pmx：MMD 常用的人物模型文件（需要转换）
  • .unitypackage：Unity 专用格式 一般引入后找到其中的角色文件 .fbx或prefab

Q8: 我的模型需要满足什么要求？ ​

💬A: 您的模型需要：

  1. 骨骼绑定：模型必须具有完整的骨骼绑定并在unity中转换为 humanoid
  2. Blend Shape 支持：脸部需要具有 Blend Shape控制器，用于表情和口型
  3. 合理的面数：建议控制在合理范围内以保证性能

模型来源

从 VRoid Studio、模之屋、Booth 等渠道获取的模型通常已满足这些要求。

Q9: PMX 格式的模型如何使用？ ​

💬A: PMX 格式需要先转换为 FBX：

  1. 将 PMX 文件导入 Unity 项目
  2. 使用 MMD4Mecanim 插件进行转换
  3. 选择 .asset 文件，点击 Process
  4. 等待转换完成后使用生成的 .fbx 文件

详细步骤请查看创建角色教程。

Q10: 如何确认模型是否有 Blend Shape？ ​

💬A: 在 Unity 中：

  1. 选中角色模型
  2. 查看 Inspector 面板
  3. 找到 Skinned Mesh Renderer 组件
  4. 检查是否有 Blendshapes 条目
  5. 拖动滑竿测试效果

如果存在 Blend Shape，您可以看到控制器列表并实时预览效果。

配置相关问题 ​

Q11: 配置口型/眨眼时找不到对应的 Blend Shape 怎么办？ ​

💬A: 可以尝试以下方法：

  1. 检查所有可用的 Blend Shape：

    • 在 Skinned Mesh Renderer 中查看所有 Blend Shape
    • 尝试不同的组合

  2. 组合使用多个 Blend Shape：

    • 某些效果可能需要多个 Blend Shape 组合
    • 在面部配置器中同时调整多个滑竿

  3. 参考模型文档：

    • 查看模型制作者提供的文档
    • 了解模型使用的 Blend Shape 命名规范

  4. 使用替代方案：

    • 如果缺少特定 Blend Shape，尝试用类似的替代

Q12: 口型配置不自然怎么办？ ​

💬A: 可以尝试：

  1. 调整 Blend Shape 值：

    • 建议使用 10-90 之间的值

  2. 确保三种口型有明显区分：

    • 小、中、大口型应该有视觉差异
    • 但不要过度夸张

  3. 测试过渡效果：

    • 确保口型之间的过渡平滑
    • 避免突兀的跳跃

  4. 参考官方示例：

    • 查看示例角色的配置
    • 了解标准的配置方式

Q13: 眨眼配置需要注意什么？ ​

💬A: 眨眼配置要点：

  1. 左右眼分别配置：确保左右眼都有对应的 Blend Shape
  2. 对称性：左右眼的眨眼应该对称
  3. 闭合程度：眼睛应该完全闭合，但不要过度压缩
  4. 测试效果：在配置器中实时预览效果

Q14: 动画配置有什么要求？ ​

💬A: 动画配置要求：

  1. Humanoid 格式：所有动画必须转换为 Humanoid 格式
  2. 单一动作：动画应为单一动作切片，不能为循环
  3. 自然语言命名：自定义动画需要使用自然语言命名，便于 AI 理解

详情请查看动画配置文档。

上传与发布 ​

Q15: 构建失败怎么办？ ​

💬A: 检查以下方面：

  1. 错误提示：

    • 查看资产面板中的错误提示区域
    • 解决所有红色错误

  2. 配置完整性：

    • 确认所有必需配置项已完成
    • 检查面部配置和动画配置

  3. 网络连接：

    • 确保网络连接稳定
    • 检查是否能访问服务器

  4. Unity 版本：

    • 确认使用 Unity 2022.3 LTS
    • 检查是否有版本相关错误

Q16: 上传后角色无法加载怎么办？ ​

💬A: 可能的原因和解决方案：

  1. 检查 Unity 控制台：

    • 查看错误日志
    • 根据错误信息排查问题

  2. 验证配置：

    • 重新检查所有配置项
    • 确认配置已正确保存

  3. 检查资源路径：

    • 确认所有资源路径正确
    • 检查贴图是否丢失

  4. 重新构建：

    • 尝试重新构建和上传
    • 确保构建过程无错误

Q17: 如何更新已发布的角色？ ​

💬A: 更新步骤：

  1. 在 Unity 中修改角色配置
  2. 重新执行构建和上传流程
  3. 新版本将覆盖旧版本
  4. 所有使用该模型的角色将同步收到更新

注意

SDK 使用模型 GameObject 的名称作为唯一标识，同名的模型会触发覆盖更新。

使用与功能 ​

Q18: 角色在 App 中显示异常怎么办？ ​

💬A: 可能的原因：

  1. shader问题：

    • 检查在unity中材质是否显示正常
    • 检查贴图是否正确导入

  2. Blend Shape 配置：

    • 重新验证面部配置
    • 检查 Blend Shape 值是否合理

  3. 动画控制器：

    • 检查动画控制器的状态机配置
    • 确认动画转换正确

  4. 模型问题：

    • 检查模型是否有损坏
    • 验证模型格式是否正确

Q19: 自定义动画不触发怎么办？ ​

💬A: 检查以下几点：

  1. 动画命名：

    • 使用自然语言命名（如"挥手"、"点头"）
    • 避免使用代码或缩写

  2. 状态机配置：

    • 确认 state 已挂载 Act behaviour 脚本
    • 检查 ActName 参数是否正确填写

  3. 使用配置工具：

    • 建议通过"动画配置"工具新增自定义动画
    • 工具会自动完善上述步骤

错误与故障排除 ​

Q21: 出现"找不到 Avatar Descriptor"错误 ​

💬A: 解决方案：

  1. 在角色对象上添加 Avatar Descriptor 组件
  2. 在 Inspector 面板最下方点击 Add Component
  3. 搜索并添加 Avatar Descriptor

Q22: 面部配置检测失败 ​

💬A: 检查：

  1. 脸部 Mesh 检测：

    • 点击 Auto Detect 自动检测
    • 或手动指定角色的脸部 Mesh

  2. Blend Shape 支持：

    • 确认模型支持 Blend Shape
    • 检查 Skinned Mesh Renderer 中的 Blend Shape

  3. 配置完整性：

    • 确保口型和眨眼配置都已完成
    • 检查配置是否正确保存

Q23: 动画控制器创建失败 ​

💬A: 可能的原因：

  1. Unity 版本：确认使用 Unity 2022.3
  2. SDK 完整性：检查 SDK 是否正确导入
  3. 权限问题：检查文件写入权限
  4. 重新创建：尝试删除后重新创建

Q24: 性能问题（卡顿、加载慢） ​

💬A: 优化建议：

  1. 模型优化：

    • 减少不必要的面数
    • 优化模型结构

  2. 贴图优化：

    • 使用压缩格式
    • 控制贴图分辨率

  3. 动画优化：

    • 移除冗余动画
    • 优化关键帧

  4. 资源管理：

    • 清理未使用的资源
    • 优化资源加载

获取帮助 ​

如果以上 FAQ 无法解决您的问题，您可以：

联系技术支持：

反馈建议

如果您发现文档中的问题或有改进建议，欢迎通过反馈渠道告诉我们！

沪ICP备2025124771号-1

© 2025 AIFriends. All rights reserved.