为 AR 构建

为 AR 构建 - 用于 Convai 的 AR 开发的 Unity 插件指南。

AR 安装

如果你想让你的 Convai 插件兼容 AR，可以通过两种方式实现。请查看下面的说明，或者看看我们的 最新教程视频 在 YouTube 上。

方法 1：自动设置

推荐用于新项目。

将执行以下过程：

• 通用渲染管线（URP）
• ARCore 插件
• Convai 自定义 AR 包
• Convai URP 转换器

如果这些包不存在，将会安装它们。

如果目标构建平台不是 Android，将切换为 Android。

请确保已从 Unity Hub 下载与你项目版本对应的 Android 平台支持。

1. 点击“ Convai / Convai Custom Package Installer / 安装 AR 包 "

1. 确认将要进行的更改和操作。如果你同意，流程将开始。点击“ 是，继续 ”，流程将开始。你会在控制台中看到日志。

1. 如果你遇到类似“Failed to Resolve Packages”的错误，不要担心。流程会继续，包安装完成后该错误会自动解决。

1. 打开“ Convai / Scenes / Convai Demo - AR ”演示场景。如果出现 TMP 导入器窗口（如果你的项目中未安装 TMP Essentials，就会出现），点击“ 导入 TMP Essentials ”以安装用于 UI 文本对象的 TextMeshPro Essentials。

或者，你可以使用“ Window / TextMeshPro / 导入 TMP 基础资源 ”来安装它。

1. 导入 TMP Essentials 后，你可以删除场景中触发 Prompt 窗口出现的空 GameObject。

1. 通过前往“ 文件 / 构建设置 / 构建 ”。请确保“ Convai Demo - AR ”场景已包含在 Scenes in Build 部分中。

请确保已设置你的 API 密钥。（Convai / Convai Setup）

现在一切都已准备好，可以测试了。🙂✅

方法 2：手动设置

请确保你的项目中已安装以下包：

• ARCore
• URP（Universal Render Pipeline）- 推荐用于优化，但并非必需

1. 双击“Convai / Convai Custom Unity Packages / ConvaiVRUpgrader.unitypackage”

1. 你会看到一个警告，提示这些设置将覆盖你的项目设置。你可以点击“ 导入 ”或者通过点击“ 切换项目 "

1. 在 Import Unity Package 窗口中，查看将要导入的资源并点击“ 下一步 "

1. 选择 Project Settings 中所有要更改的设置，然后点击“ 导入 "

1. 打开“ Convai / Scenes / Convai Demo - AR ”演示场景。如果出现 TMP 导入器窗口（如果你的项目中未安装 TMP Essentials，就会出现），点击“ 导入 TMP Essentials ”以安装用于 UI 文本对象的 TextMeshPro Essentials。

或者，你可以使用“ Window / TextMeshPro / 导入 TMP 基础资源 ”来安装它。

1. 导入 TMP Essentials 后，你可以删除场景中触发 Prompt 窗口出现的空 GameObject。

1. 如果你看到 3D 对象呈粉色，那是着色器问题。如果你正在使用 URP，请双击“ Convai / Convai Custom Unity Packages / ConvaiURPConverter ”并导入弹出窗口中的所有资源。

1. 请确保已设置你的 API 密钥（Convai / Convai Setup）。
2. 通过前往“ 文件 / 构建设置 / 构建 ”。请确保“ Convai Demo - AR ”场景已包含在 Scenes in 构建 部分开始。

现在一切都已准备好，可以测试了。🙂✅

如何添加并调整我自己的角色大小？

如果你在 convai.com playground 上创建了一个 Ready Player Me 角色，并想将其添加到你的 AR 项目中，请按照以下步骤操作：

1. 右键单击“ Convai / ConvaiAR / Prefabs / Convai NPC AR Base Empty Character ”预制体。
2. 点击“ 创建 / 预制体变体 "

1. 你会看到为“ Convai NPC AR Base Empty Character "
2. 双击这个预制体变体。

1. 在 Hierarchy 部分，将你导入的角色作为该预制体变体的子对象添加进去。

使用“ 导入 Ready Player Me（RPM）角色 ”指南将你的角色添加到项目中。

1. 添加角色后，点击你的角色。
2. 在 Inspector 中，根据需要调整 Scale 设置。为了防止你的角色在说话时随动画移动，请禁用“ 应用根运动 ”选项。

1. 完成这些步骤后，按以下键保存你的预制体变体 CTRL + S.
2. 打开“ Convai / Scenes / Convai Demo - AR ”场景。
3. 点击“ Convai AR Player ”对象，位于“ ConvaiAR Base Scene "

1. 在 Inspector 中，在“ Convai Character Spawner ”组件下，将你的预制体变体添加到 Character Prefab 字段中。

现在，一切都已准备好，可以在 AR 环境中测试你的角色了！🙂✅

创建这个预制体变体是为了防止你的预制体在 AR 环境中实例化时自动缩放为（1,1,1）。

为避免缩放调整问题，我们将角色作为一个空父对象的子对象添加。为了方便起见，我们创建了一个空的预制体变体。