安装 (Installation)

在您深入 realvirtual.io 的世界之前，您需要正确设置开发环境。以下是帮助您入门的详细指南。

realvirtual.io 6.3 (Unity 6.3 LTS)

第 1 步：安装 Unity 6.3 LTS

通过 Unity Hub 安装 Unity 6.3 LTS。在 Unity Hub 中，版本号显示为 6000.3（例如 6000.3.5f1）。详细说明请参阅 Unity 官方安装指南。中国用户请选择Tuanjiehub，安装团结引擎1.3.0及以上版本。

Unity 6 安装指南

第 2 步：创建新的 Unity 项目

1. 打开 Unity Hub 并点击 New project。
2. 在 Core 模板下选择 Universal 3D 以使用通用渲染管线 (URP)。
3. 设置项目名称并选择项目文件夹的位置。
4. 确保选择了 Editor version 6000.3（Unity 6.3 LTS）。
5. 点击 Create project。

第 3 步：安装 realvirtual 包

安装方式取决于您在哪里购买的 realvirtual。请选择适用于您的部分。

从 Unity中国资源商店 购买

1. 在 Unity 中打开 Window > Package Manager。
2. 在左侧面板中选择 My Assets。
3. 找到 realvirtual Starter（如果已购买，还包括 realvirtual Professional）并点击 Download。
4. 下载完成后，点击 Import 将 UPM 包安装到您的项目中。

直接从(www.realvirtul.com.cn中国合作伙伴)购买

首次安装时，请从 realvirtual 客户门户 (Customer Portal) 下载 .tgz 包文件。链接和登录凭据在您的发票上提供。

下载完成后，在 Unity 中安装包：

1. 打开 Window > Package Manager。
2. 点击左上角的 + 按钮并选择 Install package from tarball...。

3. 导航到下载的 .tgz 文件并首先选择 io.realvirtual.starter。

4. 等待导入完成。这可能需要几分钟。
5. 如果您购买了 Professional 版本，请对 io.realvirtual.professional 重复此过程。

为后续更新设置 User Hub

安装包后，Unity 菜单栏中会出现 realvirtual 菜单。使用内置的 User Hub 管理更新：

1. 在 Unity 菜单中转到 Tools > realvirtual > User Hub。

2. 在 Login 选项卡中，输入您的 Invoice Number、Billing ZIP Code 和 Email。点击 Login。

激活 UPM Registry（推荐）

要接收自动更新通知，请激活 realvirtual UPM Registry：

1. 在 User Hub 中，转到 Packages 选项卡。
2. 点击 Activate UPM Registry。

3. Unity 将在您的 Project Settings > Package Manager 中添加一个作用域注册表 (scoped registry)，并显示确认对话框。

4. 未来的更新现在会自动出现在 Package Manager 的 My Registries 下。使用 User Hub 中的 Check for Updates 进行验证。

通过 Tarball 手动更新

或者，您可以从 User Hub 的 Downloads 选项卡（或从客户门户）下载较新版本，并按照上述 Install package from tarball 方法进行安装。

第 4 步：处理签名警告

第 5 步：导入演示场景

安装后，会出现一个对话框询问您是否要导入 Getting Started 演示场景。点击 Import Now 立即开始。

您可以随时使用两种方法导入其他演示类别：

通过 Package Manager：在 Package Manager 中选择 realvirtual Starter（或 Professional），转到 Samples 选项卡，然后点击您想要的演示类别的 Import。

通过演示场景浏览器 (Demo Scenes Browser)：在 Unity 菜单中转到 Tools > realvirtual > Demo Scenes Browser。此窗口显示按类别组织的所有可用演示场景及其描述。

第 6 步：探索演示场景

Getting Started 演示场景在导入后会自动打开。它展示了一个完整的自动化单元，包括传送带、机器人、传感器和一台机器 — 所有这些都协同工作。

在 Unity 编辑器中按 Play 启动仿真，查看自动化的实际运行。

可能的问题和修复

输入系统错误

如果您在 Console 中看到与 Input System 相关的红色错误消息，请确保 Project Settings > Player > Configuration 中的 Active Input Handling 设置为 Both (old and new Input System)。

渲染管线错误

如果您的演示场景显示为粉色，您可能使用了错误的渲染管线。我们建议切换到 通用渲染管线 (URP)。详情请参阅渲染管线 (Render Pipelines)。

TextMesh Pro Essentials 未导入

如果您在运行时 UI 中遇到文本问题，请转到 Window > TextMeshPro > Import TMP Essential Resources 安装所需组件。

（可选）清理不必要的 Unity 演示文件夹

为了保持项目整洁，您可以删除 Unity 的默认演示资源（如果存在）：

• Scenes
• Settings
• TutorialInfo

从 realvirtual 6.0 升级到 6.3

如果您有一个使用 realvirtual 6.0.x（.unitypackage 版本）的现有项目，请按照以下步骤迁移到新的 UPM 包格式。

第 1 步：将 Unity 升级到 6.3 LTS

1. 打开 Unity Hub 并将您项目的 Editor Version 更改为 6000.3（Unity 6.3 LTS）。
2. 接受任何兼容性警告并让 Unity 转换您的项目。

第 2 步：删除旧的 realvirtual 文件夹

1. 完全关闭 Unity。
2. 从您的项目目录中删除 Assets/realvirtual 文件夹（这是旧的 .unitypackage 内容）。
3. 删除 Library 文件夹以强制 Unity 重新生成所有缓存的元数据。

第 3 步：安装 UPM 包

1. 在 Unity 6.3 LTS 中重新打开您的项目。您会看到编译错误 — 这是预期行为。
2. 按照上方安装说明中的第 3 步安装新的 UPM 包（通过 Asset Store 或客户门户 tarball）。
3. 安装包后，编译错误应该会解决。

第 4 步：验证升级

1. 检查 Console 窗口中是否还有剩余错误。
2. 打开您的其中一个场景，验证所有组件、引用和材质是否完好。
3. 如果材质显示为粉色，请转到 Tools > realvirtual > Settings > Switch to Universal Render Pipeline (URP) 进行转换。

realvirtual.io 6.0 (Unity 6 — .unitypackage)

realvirtual.io 6 和 Unity 6 安装教程

第 1 步：安装 Unity 6 LTS

通过 Unity Hub 安装 Unity 6000.0 LTS（Unity 6）。

第 2 步：创建新的 Unity 项目

1. 打开 Unity Hub。
2. 在 Core 模板下选择 Universal 3D。
3. 确保选择了 Editor version 6000.0 LTS。
4. 点击 Create Project。

第 3 步：安装 realvirtual.io 6

• 直接从 realvirtual.io 购买：
  1. 从您在 realvirtual.io 下载网站上的账户下载 realvirtual.unitypackage 文件。
  2. 将文件拖放到 Unity Project 窗口中，或转到 Assets > Import Package > Custom Package。
  3. Unity Asset Store：
  4. 打开 Window > Package Manager。
  5. 在 My Assets 下，找到 realvirtual.io 6 并点击 Download，然后点击 Import。

当提示 URP Upgrade 时，选择 Install / Upgrade。

导入后，演示场景会自动打开。

可能的问题和修复

请参阅上方的问题和修复部分 — 相同的问题和解决方案适用。

realvirtual.io 2022 及更早版本

1. 安装 Unity

如果您还没有安装 Unity，请在您的计算机上安装。Unity 提供免费和授权版本，具体取决于您的使用场景。请查看 Unity 官方网站此处以确定适合您需求的版本。

realvirtual.io 2022 安装（旧的已弃用版本）

我们的新版本始终基于最新的 Unity 长期稳定版 (LTS)。我们的主版本号（例如 6）始终对应 Unity 版本号。例如，要运行 realvirtual.io 2022.09，您需要 Unity 2022.03 LTS。

2. Unity Hub（推荐）

我们强烈建议安装 Unity Hub，这是一个简化管理多个项目和 Unity 安装的工具。您可以从 Unity 官方下载页面下载 Unity Hub。

3. 创建新项目

启动 Unity 并通过选择"New"创建一个新的空项目。在您的计算机上选择一个位置来存储项目文件，并为您的项目命名。然后，点击"Create Project"。

当提示选择模板时，选择标准 3D 模板。这将构成您项目的基础：

5. 确保 .NET Standard Framework 2.1 和 Mono 已启用

默认情况下，Unity 应该已启用 .NET Standard 2.1 和 Mono。但是，在某些情况下，特别是将 realvirtual.io 集成到较旧的项目中时，此设置可能不正确。要确认或更改此设置：

• 通过选择"Build Settings" > "Player Settings"转到 Player Settings。
• 在"Configuration"下，将 Scripting Runtime Version 更改为".NET Standard 2.1"

对于脚本后端，建议从 Mono 而不是 IL2CPP 开始，因为 Mono 通常编译速度更快。

6. 获取 realvirtual.io

前往 Unity Asset Store 并购买适合您需求的 realvirtual.io 版本，无论是 Lite 还是 Professional。

7. 导入 realvirtual.io

您可以直接从 Unity Asset Store 导入 realvirtual.io 或手动下载资源。要手动安装，请按照以下步骤操作：

• 从主菜单中，转到"Assets" > "Import Package" > "Custom Package..."
• 将出现一个新窗口，显示 realvirtual.io 包的内容。选择"All"并点击"Import"。

这将显示一个包含所有 realvirtual.io 包内容的新窗口：

请选择 All 并点击 Import。

8. 验证安装

导入 realvirtual.io 包后，请检查以下内容：

• 您应该在项目结构中看到一个额外的"realvirtual"文件夹（2022 年之前为"game4automation"）。
• 主菜单栏中应该有一个新的"realvirtual"菜单可用。

9. 设置标准设置

在这种情况下：

• 首先解决编译错误，确保没有剩余错误。
• 错误解决后，通过从主菜单中选择"realvirtual" > "Apply Standard Settings"来应用标准设置。

应用标准设置将配置：

• 标准层命名（用于物理）。
• 标准物理碰撞矩阵。
• 标准光照设置。

恭喜！您现在已经完成了安装过程，可以开始探索文档中描述的演示模型了。