【Unity AR开发插件】五、运行示例程序

专栏

本专栏将介绍如何使用这个支持热更的AR开发插件,快速地开发AR应用。

链接: Unity开发AR系列

热更数据制作:制作热更数据-AR图片识别场景

插件简介

通过热更技术实现动态地加载AR场景,简化了AR开发流程,让用户可更多地关注Unity场景内容的制作。

"EnvInstaller..."支持HybridCLR和ARCore的一键安装。

"AR SDK..."基于HybridCLR和ARFoundation实现,使热更技术贯穿AR开发的全流程。

包含热更数据制作与导出、热更数据上传与下载、热更数据的版本控制与数据加载

资源下载

"EnvInstaller":点击下载

"AR SDK":点击下载

运行AR示例程序

在前面的《使用插件一键安装》、《配置带HybridCLR的AR开发环境》已介绍如何使用插件导入ARFoundation(ARCore)、HybridCLR相关的Package,以及如何划分程序集。

运行示例

划分程序集

示例中包含如下程序集定义,这里需要在"HybridCLR Settings"中划分程序集

程序集 类型 简介
Holo.Demo 热更程序集 包含各单项功能示例的程序集,示例Demo中使用
DynamicScene 热更程序集 AR动态场景示例的程序集,示例Demo中使用
Holo.Runtime AOT程序集 AR SDK核心程序集,已编译成dll并添加至项目中。
Assembly-CSharp AOT/热更都可 Unity的默认全局程序集

打包程序

  1. 参考之前的文档,在"HybridCLR Settings"中完成"划分程序集"和"补充元数据"的步骤。

  2. 打开场景"/Assets/Scenes/AOT/Scene_AOT_2.unity"。

  3. 打开"Build Settings",点击"Add Open Scenes"后,执行"Build"或"Build And Run"。

注意:若遇到gradle报错,请检查"compileSdkVersion"和"buildToolsVersion"版本。

BTW,网上很多教程,这里不再补充说明。

运行示例

UI使用的是AssetsStore中的"UI Samples"

进入首页:

加载数据:

程序启动时,若本地数据存在,则自动载入热更数据。点击"开始"按钮,进入热更数据中的入口场景。

参考《制作热更数据-AR图片识别场景》制作热更数据,在"场景导出"时设置入口场景。

下载数据:

前提:服务器已上传热更数据

参考《制作热更数据-AR图片识别场景》制作热更数据,并将数据上传至服务器。

点击"更新",会先校验数据版本,若服务器数据版本较新,则更新数据。

关键组件

DataDownLoader组件

方法:

  • StartDownload:开始下载数据(内部调用CheckDataVersion方法)

检视面板:

DllLoader组件

这里采用的是HybridCLR,通过初始化从打包成assetbundle的scene还原挂载的热更新脚本的方式。HybridCLR 文档

主要方法:

  • StartReadData:开始读取热更数据(包括热更程序集和AB包)
  • getEntrance:获取热更数据的入口场景名称

检视面板:

热更数据管理

DataDownLoader和DllLoader分别实现了数据下载和数据加载。

现创建了一个脚本,统一管理热更数据。参考工程中的HotFixDataMgr.cs

  • 给"开始"按钮添加点击事件,挂载HotFixDataMgr的StartGame()方法
复制代码
    public void StartGame()
    {
        if(m_Status != Status.READY)
        {
            AndroidUtils.Toast("数据加载中,请稍候...");
            return;
        }

        //获取入口场景名称
        string mainSceneName = dllLoader.getEntrance();
        if (mainSceneName == null)
        {
            AndroidUtils.Toast("请先更新数据,点击"更新"");
            return;
        }

        SceneManager.LoadSceneAsync(mainSceneName, LoadSceneMode.Single);
    }
  • 给"更新"按钮添加点击事件,挂载HotFixDataMgr的UpdateData()方法
复制代码
    public void UpdateData()
    {
        if (m_Status != Status.READY)
        {
            AndroidUtils.Toast("程序未就绪,请稍后再试!");
            return;
        }
        ...
        if (dataDownLoader != null)
        {
            m_Status = Status.UPDATING;//开始更新,切换为更新状态
            ...
            //开始下载数据
            dataDownLoader.StartDownload();
        }
    }
  • 在HotFixDataMgr.cs的Awake方法中添加委托事件

    复制代码
      private void Awake()
      {
          ...
          //数据处理失败时触发
          dataDownLoader.OnError += HandleError;
          dllLoader.OnError += HandleError;
    
          //进度更新
          dllLoader.OnProgressUpdate += HandleProgressFromDllLoader;
          dataDownLoader.OnProgressUpdate += HandleProgressFromDataDownLoader;
          ...
      }
      ...
      /// <summary>
      /// 处理错误
      /// </summary>
      /// <param name="message"></param>
      private void HandleError(string message)
      {
          if (Application.platform == RuntimePlatform.Android)
          {
              AndroidUtils.Toast("数据版本校验失败");
          }
          Debug.Log("数据版本校验失败");
          m_Status = Status.READY;
      }
      private void HandleProgressFromDataDownLoader(float progress)
      {
          int pro = (int)(progress * 100);
          Debug.Log("数据同步进度:  " + pro + " %");
      }
    
      private void HandleProgressFromDllLoader(float progress)
      {
          int pro = (int)(progress * 100);
          Debug.Log("数据加载进度:  " + pro + " %");
      }
相关推荐
ellis197020 小时前
Claude Code[二] 上下文相关的机制
unity·ai编程
zdr尽职尽责2 天前
Unity 3C 动画系统:从「蜘蛛网」到可维护的动画架构
unity·架构·游戏引擎
国家一级摸鱼选手2 天前
[Unity]几何碰撞检测:SAT 分离轴定理详解(从数学原理到 C# 实现)
unity·c#·游戏引擎·分离轴定理(sat)·多边形相交
视+老张4 天前
遗址区不能铺线贴标记,户外XR怎样把汉代宫殿放回未央宫?
ar·xr·增强现实·文化遗产·easyar
暴走约伯4 天前
【VFX工具链源码拆解 09】终极工业化闭环:基于 ID 规则驱动的全自动场景建档、骨骼挂载与男转女场景迁移
unity·c#·游戏引擎·材质
寂寞的船5 天前
【Unity知识速递】第13期 Unity 内存泄漏排查实战:从 Memory Profiler 到 Lua 引用泄漏的生产级全链路诊断
unity·junit·c#·游戏引擎·lua
寂寞的船6 天前
【Unity Bug挑战】第12期 Awaitable 二次 await 死锁之谜 —— 为什么同一个异步操作等两次就卡死?
unity·c#·游戏引擎·bug
虹科数字化与AR6 天前
农业机械AR质检ROI怎么算?从搬运、测量、返工和交付成本入手
经验分享·ar·质检·农业机械
探求虚无7 天前
用 AI 在 Unity 里做一款 RTS:最难的不是生成代码,而是证明它真的能玩
人工智能·unity·游戏引擎
17岁的勇气8 天前
Unity Shader unity文档学习笔记(二十二):shader变体
笔记·学习·unity