跳到主要内容

如何加载资产

XRMOD引擎允许创作者通过CSharp脚本或可视化脚本加载自定义资产。

但是，我们应该如何做到这一点?

危险

你必须安装Unity Engine和Dev-environment。

首先，我们需要创建一个XRMOD项目（如何创建）。

信息

如何在创建后找到XRMOD项目？ 点击这里了解更多信息

收集资产​

创意者可以导入自己的艺术资产或使用Unity内置资产（Primitive Objects）。

信息

点击这里，了解Unity如何导入资产。

跟随步骤:

  1. 将你的艺术资产导入你的项目/Artwork文件夹中。
  2. 创建一个新的文件夹并将其命名为Prefabs。这个文件夹将用来存储项目的预制体。
  3. 将艺术资产拖放至Unity Scene或Hierarchy
  4. 处理你的艺术资产，例如，模型的渲染、贴图、比例等。
  5. 将你的艺术资产从Unity Scene或Hierarch拖放至你的项目/Artwork/Prefabs文件夹，它将成为一个Prefab
  6. 将你的艺术作品的预制件拖放至 PackageToolsEditor->Contents

编辑脚本​

进入PROJECT_PATH->PROJECT_NAME->Scripts->Runtime并打开PROJECTNAMEMainEntry.cs文件（通过双击）。

然后在OnLoad方法上写一些代码。

危险

ARMODAPI.LoadAssetAsync

("VirtualObject");对象名称（VirtualObject）必须与PackageToolsEditor->Contents`资产名称相同。

HowToCreateProjectMainEntry.cs
using System;
using UnityEngine;
using System.Collections;
using com.Phantoms.ARMODAPI.Runtime;
using com.Phantoms.ActionNotification.Runtime;
using Object = UnityEngine.Object;


namespace HowToCreateProject.Runtime
{
    public class HowToCreateProjectMainEntry
    {
        //XRMOD API
        internal static API ARMODAPI = new API(nameof(HowToCreateProject));

        public async void OnLoad()
        {
            var tmp_ARVirtualObjectPrefab = await ARMODAPI.LoadAssetAsync<GameObject>("VirtualObject");
            Object.Instantiate(tmp_ARVirtualObjectPrefab);
        }
    }
}

我们使用LoadAssetAsync来按资产名称和类型从XR-Experience包中加载我们的虚拟对象。因为LoadAssetAsync方法将资产从磁盘加载到内存，它并没有将资产实例化，所以我们需要调用Instantiate方法来实例化它。

可编程块​

  1. 转到PackageToolsEditor
  2. 切换到Properties部分
  3. 将你的鼠标指向自由区域
  4. 右击你的鼠标按钮
  5. 选择Programmable

建立XR-体验​

  1. 转到PackageToolsEditor
  2. 切换到Build部分
  3. 选择你需要构建的平台
  4. 点击Build AR-Experience按钮，开始构建
危险

Build Platform和Platform Group所选的两个平台必须是相同的。

测试​

现在我们已经完成了所有的工作，但我们还不知道内容是否正常加载，所以我们需要进一步测试以验证我们的结果。

如何测试?

XRMOD引擎目前提供了在Unity编辑器中加载测试等流程，所以我们可以在Unity编辑器中验证所有的逻辑。在开始测试之前，我们需要通过Unity Package Manager安装XRMOD Engine Simulator插件。

信息

点击这里来学习如何安装XRMOD引擎工具链。

在这里，我们需要安装XRMOD引擎模拟器插件。

Install XRMOD Simulator Plugin

当你完成安装后，你可以在Unity编辑器的左上角看到一个XR按钮，这主要是用来启动XRMOD引擎模拟器的。

Simulator

启动模拟器​

  1. 点击左上方的XR Play按钮，启动XRMOD引擎模拟器。
  2. 切换到Game视图
  3. 将你的项目名称输入模拟器
  4. 点击Fetch Project来加载我们的项目

总结​

在这一节中，我们学习了如何在XRMOD引擎中加载一个资产。在加载过程中，我们需要注意以下几点。

  1. 通过ARMODAPI.LoadAssetAsync方法加载资产。
  2. ARMODAPI.LoadAssetAsync需要传入要加载的类型和要加载的项目名称。
  3. ARMODAPI.LoadAssetAsync是一个异步方法，需要在函数中标记为异步，并在ARMODAPI.LoadAssetAsync方法前添加await。
  4. 在API中加载的对象的名称必须与PackageToolsEditor->Contents中的资产名称相同。