导入 Oculus 集成 SDK 包（旧版）

1. 在 Unity 中创建一个新的 3D 项目。
2. 前往 Unity Asset Store⁠，使用您的 Unity 身份验证登录，然后点击在 Unity 中打开。Unity 会在 Unity 编辑器中打开 Package Manager（包管理工具）窗口。
3. 如果出现提示，请输入 Unity 凭证。
4. 在Package Manager（包管理工具）窗口，展开 Oculus Integration（Oculus 集成），选择最新版本，然后在窗口右下方，点击Download（下载）。
5. 下载完成后，点击 Import（导入），将最新的 SDK 导入到您的项目中。
6. 在 Import Unity Package（导入 Unity 包）窗口上，保留所有选中的文件和文件夹，然后点击 Import（导入）。
7. 当提示更新 Oculus 实用程序插件时，点击 Yes（是）。
   此步骤可确保您使用的是与安装包捆绑在一起的 Oculus 实用程序插件。如果您选择此时不更新插件，您需要稍后手动更新。
8. 当提示使用 OpenXR 作为后端时，点击 Use OpenXR（使用 OpenXR），将后端设置为使用 OpenXR。如果您希望继续使用旧版 VRAPI 后端，点击 Cancel（取消）。有关 Oculus XR 插件如何与 OVR 插件互动的详细信息，请参阅安装、卸载和升级 XR 插件。
9. 当提示清理旧的互动 SDK 资产时，点击 Show Assets（显示资产），然后点击 Delete Assets（删除资产）。
10. 当提示更新空间化器插件时，点击 Upgrade（升级），然后点击 Restart（重启）。

1. 转到开发者中心的包页面，然后点击下载。
2. 在 Unity 中创建一个新的 3D 项目。
3. 在菜单上，前往 Assets（资产）> Import Package（导入包）> Custom Package（自定义包）。
4. 找到下载的 .unitypackage 文件并点击 Import（导入）。
5. 在 Import Unity Package（导入 Unity 包）窗口上，保留所有选中的文件和文件夹，然后点击 Import（导入）。
6. 当提示更新 Oculus 实用程序插件时，点击 Yes（是）。
   此步骤可确保您使用的是与安装包捆绑在一起的 Oculus 实用程序插件。如果您选择此时不更新插件，您需要稍后手动更新。
7. 当提示使用 OpenXR 作为后端时，点击 Use OpenXR（使用 OpenXR），将后端设置为使用 OpenXR。如果您希望继续使用旧版 VRAPI 后端，点击 Cancel（取消）。有关 Oculus XR 插件如何与 OVRPlugin 互动的详细信息，请参阅将 Oculus 实用程序插件设置为 OpenXR。
8. 当提示清理旧的互动 SDK 资产时，点击 Show Assets（显示资产），然后点击 Delete Assets（删除资产）。
9. 当提示更新空间化器插件时，点击 Upgrade（升级），然后点击 Restart（重启）。

1. 若已打开 Unity，将它关闭。
2. 前往电脑上保存项目的文件夹。例如 /username/sample-project/。
3. 在您的项目中打开 Assets 文件夹，然后删除 Oculus 文件夹。
4. 在您的项目中，搜索以下列文字开头的文件，然后手动删除它们：Oculus 和 OVR。另外，如果您要构建的是 Android 应用，请搜索以 AndroidManifest、vrapi、vrlib 和 vrplatlib 开头或与它们匹配的文件名。这些文件通常位于您项目的不同文件夹中，因此最好请按文件名搜索并加以删除。
5. 打开您要升级包的项目。
6. 请按照从下载页面导入 SDK 部分的步骤 1 操作。
   手动删除先前版本的文件可避免覆盖某些文件和多个插件版本。

1. 前往 Meta Horizon 开发者中心页面，从列表中选择任何早期版本，然后点击下载。
2. 按照升级到最新 SDK 的步骤 1 至步骤 4，删除现有的 Oculus 集成文件。
   注意：如果要在新项目中导入早期版本，可以跳过这一步。
3. 打开要导入 SDK 的项目。或者，如果要在新项目中导入，请创建一个新的 3D 项目。
4. 从菜单中，转到资产 > 导入包 > 自定义包。
5. 在计算机上找到包的早期版本，然后点击打开。包名称设置为 OculusIntegration.unitypackage。我们建议您用相关版本号重命名包。例如，如果要导入 Oculus Integration 14.0 版本，请将包重命名为 OculusIntegration_v14.0.unitypackage。
6. 按照从 Unity Asset Store 导入或从 Meta Horizon 开发者中心导入中的步骤 5 开始操作。

• 在 Unity 中，转至 Meta > Tools（工具）> OVR Utilities Plugin（OVR 实用程序插件）> Manual Update OVR Plugin（手动更新 OVR 插件）。

1. 若已打开 Unity，将它关闭。
2. 前往电脑上保存项目的文件夹。例如 /username/sample-project/。
3. 在您的项目中，打开 Assets 文件夹，然后删除 Oculus 文件夹。
4. 在您的项目中，打开 Library 文件夹，然后删除 /Library/PackageCache/。
5. 重新开启项目。如果出现提示，请在安全模式下打开，因为项目可能会出现编译错误。
6. 按照此处的步骤，将 Meta XR SDK 作为 UPM 包安装。我们建议从 Meta XR 一体化 SDK 开始，因为该包有与旧版 Oculus 集成 SDK 类似的功能集。
7. 如果您的项目出现错误或缺少素材，可能是因为较大的示例素材（例如 SampleFrameworks）已作为 Unity StarterSamples 移动到 Github。请按此处的说明将素材导入您的项目。

• 如果对现有的 Meta XR SDK 文件作出任何自定义修改，这些自定义更改必须手动合并到新的 UPM 发布的 Meta XR SDK 文件中。欲了解更多信息，请参阅导入 Meta XR 包。
• 可能有旧的 Oculus 文件在 Assets/Oculus 文件夹之外被引用。要清理这些文件，请搜索以下列文字开头的文件，并手动删除它们：Oculus 和 OVR。另外，如果您要构建的是 Android 应用，请搜索以 AndroidManifest、vrapi、vrlib 和 vrplatlib 开头或与它们匹配的文件名。这些文件通常位于您项目的不同文件夹中，因此最好请按文件名搜索并加以删除。

1. 导航至 Window（窗口）> Package Management（包管理）> Package Manager（包管理工具）。
2. 选择已安装的 Meta XR SDK。
3. 点击 Remove（删除）按钮来卸载 Meta XR SDK。
4. 对所有已安装的 Meta XR SDK 重复上述操作。
5. 按照导入 Oculus 集成 SDK 页面上的说明，从开发者中心导入 SDK。