WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

栏目: 后端 · 发布时间: 5年前

内容简介:在浏览器环境下,解释运行JavaScript脚本实现高阶功能早已是家常便饭,然而,Web前端日新月异的需求已逐渐无法完全依赖JavaScript实现。幸运的是,打破瓶颈的新技术已逐渐成熟,它就是WebAssembly是一项神奇的技术,简而言之就是一种底层的类汇编语言,其编译后的二进制模块

在浏览器环境下,解释运行JavaScript脚本实现高阶功能早已是家常便饭,然而,Web前端日新月异的需求已逐渐无法完全依赖JavaScript实现。幸运的是,打破瓶颈的新技术已逐渐成熟,它就是 WebAssembly

什么是WebAssembly

WebAssembly是一项神奇的技术,简而言之就是一种底层的类汇编语言,其编译后的二进制模块 wasm 可在浏览器中运行以接近原生的性能运行CC++、C#、 JavaGOPHPRust 等等语言的代码!自2015年颁布、2017年初正式发布最小功能版本以来,WebAssembly迅速开始盛行,并已得到主流浏览器的广泛支持,详细支持情况可以参见下图或 MDN

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

(数据采于2019-01-25)

需要强调的是:WebAssembly并不旨在取代JavaScript或任何现有的H5/ES6技术,而是与他们共存 - 我们耳熟能详的WebGL、Web Audio等组件都是WebAssembly模块在浏览器端的运行时,在浏览器端实现所需功能

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

优势与异同

那么问题来了 - WebAssembly究竟和 asm.jsDart 等类似技术有何不同?我们早已可以通过Emscripten编译asm.js在浏览器中跑c/c++了,为什么还需要WebAssembly呢?相比之下,WebAssembly主要具备以下优势:

  • WebAssembly模块不论在加载速度和性能上都有明显优势 - 它以二进制码的形式在浏览器中原生运行,无需像asm.js那样将原始语言编译成JavaScript,远超JavaScript引擎解释脚本的运行速度,即便首屈一指的Chrome V8有 JIT 加持也无济于事。
  • WebAssembly并不是基于现有组建的扩展,而是一个Web开发新特性/标准,它有独立的 路线图 ,不断有新特性加入进来。
  • 不受asm.js等技术在 AOT 等层面的限制,特性拓展潜力极大,应用场景广泛,详见底部延伸阅读部分的介绍。

编译与运行

那么如此神奇的技术究竟如何编译运行?当下最主流编译器可谓就是Emscripten了,广泛应用于原始语言->LLVM中间码->JavaScipt(asm.js)的编译。当然在WebAssembly全面企稳的今天,直接将原始语言编译成WebAssembly(wasm)也不在话下。

较新版本的Emscripten支持跳过LLVM中间码->asm.js->wasm的过度,直接编译wasm,以 c语言 为例可通过如下命令直接编译:

# `WASM=1`:仅生成wasm模块(默认为LLVM中间码),`SIDE_MODULE=1`:仅编译用户代码,而不包含printf、memalloc等函数
./emcc hello-world.c -O3 -s WASM=1 -s SIDE_MODULE=1 -o hello-world.html

编译生成的结果包括:

  • hello-world.wasm: wasm模块二进制码
  • hello-world.html: 展示页面
  • hello-world.js: 读取wasm模块的JavaScript

其中编译生成的hello-world.js是帮助我们在页面中调用加载wasm模块的脚本,我们也可结合 Fetch API 在自己的代码进行加载:

fetch('path/to/wasm')
    .then(response => response.arrayBuffer())  \\将wasm文件响应转为二进制数组
    .then(bits => WebAssembly.compile(bits))  \\编译模块
    .then(module => { return new WebAssembly.Instance(module) }); \\生成模块实例

可通过自带的emrun工具在指定浏览器中运行编译结果,或直接托管在Web服务器上:

emrun --browser /path/to/browser/executable hello-world.html

实战Unity+WebAssembly

接下来我们就进入今天的实战:将经由 Autodesk Forge Model Derivative服务轻量化 的模型,通过 Forge AR/VR Toolkit 导入Unity场景,结合C#/JSLIB脚本与Unity插件,编译为WebAssembly,并集成至我们的前端框架中!

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

  • 参考 该教程 ,为 Unity3D 项目配置好 Forge AR/VR Toolkit
  • 将轻量化后的模型导入至Unity场景,如图所示填入模型的URN和从Forge服务端获取的Access Token

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

  • 需注意将.NET运行时版本调整为4.5以便支持TLS 1.2

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

  • 完成场景的建模与开发,本例结合 Cinemachine 的Freelook Camera插件与简单的c#脚本实现由键鼠操控的场景漫游。Cinemachine是一套强大的Unity相机管理工具,可利用其路径(Path)路点(Waypoint)等特性(并结合 Timeline )轻松制作强大的预制路线漫游等效果。
  • 通过较新Unity3D(2017/5.6+)直接将场景编译为WebAssembly,设定 发布目标 平台为WebGL,并在 发布设定 中将 连接器目标 设为 WebAssembly ,开始 Build 编译:

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

  • 编译结果包括:

    • html:展示页面
    • Build目录: <项目名>.json (包括运行所需的参数与设置)、 UnityLoad.js (浏览器加载wasm所需的脚本)、 <项目名>.*.unityweb ( 发布设定 中指定格式的压缩包,包含wasm模块与场景资源等)
    • Template:展示页面依赖

与前端框架整合

  • 浏览展示页面确认实际效果无误后,将 Build 目录导入前端项目的静态资源路径(如 ./src/assets
  • 接下来将分别介绍针对Vue、React、Angular框架与无框架的整合

React

npm install vue-unity-webgl
  • 在React组建中调用
import Unity, { UnityContent } from "react-unity-webgl";
class App extends Component {
  unityContent:UnityContent = new UnityContent(
      "Build/forge_sample.json",  \\引用编译结果,将所有编译结果置于相同路径下
      "Build/UnityLoader.js" \\并确保浏览器会话可以http协议访问
  );

  \\...
  render() {
    \\...
    <Unity unityContent={this.unityContent}  />
  }
}
  • 与Unity中的对象通讯
this.unityContent.send(
      "Unity对象名称", 
      "C#或JSLIB脚本函数名称", 
      1 \\参数值
    );
  • 在Unity脚本中与JavaScript通讯:
[DllImport("__Internal")]
  private static extern void EventName (int arg);
  
  public void CallAnEvent (int arg) {
    EventName(arg);
  }
  • 在Unity中创建JSLIB脚本(如 Assets/Plugins/WebGL/forge-sample.jslib )注入事件:
mergeInto(LibraryManager.library, {
 
  EventName: function(arg) {
    ReactUnityWebGL.EventName(arg);
  }
});
  • 在前端监听该事件

    this.unityContent.on("EventName", arg => {
      \\...
     });
  • 同理我们可以在前端监听Unity的生命周期事件:
public class NewBehaviourScript : MonoBehaviour {
\\...    
   [DllImport("__Internal")]
   private static extern void EventName ();
   void OnSceneLoaded (Scene scene, LoadSceneMode mode) {
        EventName();
    }
\\...    
}

Vue

npm install vue-unity-webgl
  • 在Vue组件中调用
<template>
  <div>
    /*...*/
    <unity src="Build/forge_sample.json"  unityLoader="Build/UnityLoader.js"></unity> \\引用编译结果,将所有编译结果置于相同路径下,并确保浏览器会话可以http协议访问
    /*...*/
  </div>
</template>
<script>
import Unity from 'vue-unity-webgl'
\\...
export default {
  components: { Unity }
  \\...
}
<script>

Angular与无框架

  • 对于适用于Angular的Unity组件库,我们只找到了 ng-unity ,但在实测中出现报错,似乎是由于其内置的 UnityLoader.js 与我们的模块并不兼容(该库不能引用外置Loader),因此我们结合了无框架的引用方式来做示范
  • 在页面中引用编译生成的 UnityLoad.js
<script language="JavaScript" src="assets/Build/UnityLoader.js"></script>
  • 组件页面中加入容器元素
/* app.component.html*/
   <div id=‘unityContainer’></div>
  • 在组件中载入模块
\\app.component.ts
declare var UnityLoader: any;  \\声明UnityLoader为任意类
export class AppComponent implements AfterViewInit{
  private unityInstance: any;
  \\...
  ngAfterViewInit(){
    (<any>window).UnityLoader = UnityLoader; \\将UnityLoader对象暴露为窗体具柄
    this.unityInstance = UnityLoader.instantiate('unityContainer', './assets/Build/forge_sample.json'); \\引用编译结果,将所有编译结果置于相同路径下,并确保浏览器会话可以http协议访问
    
  }

  sendMessage(objectName: string, functionName: any, argumentValue: any) {
    this.unityInstance.SendMessage(objectName, functionName, argumentValue); \\与Unity对象通讯
  }
  \\...
}
  • 运行结果如下

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

调试与优化

编译后的wasm是二进制的,可以通过编译工具(如 WABTBinaryen 等)生成或转换为 WebAssembly Text (wat) Format - 人类可读的类汇编代码:

(module
  (func $i (import "imports" "imported_func") (param i32))
  (func (export "exported_func")
    i32.const 42
    call $i
  )
)

在浏览器中也可以查看 wat ,并断点调试

WebAssembly + Forge实战 - 整合Forge AR/VR ToolKit + Unity场景至前端框架

优化考量

延伸阅读


以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

比特币

比特币

李钧、长铗 / 中信出版社 / 2014-1-1 / 39.00元

2009年,比特币诞生。比特币是一种通过密码编码,在复杂算法的大量计算下产生的电子货币。虽然是虚拟货币,比特币却引起了前所未有的全球关注热潮。 这一串凝结着加密算法与运算能力的数字不仅可以安全流通、换取实物,1比特币价值甚至曾高达8 000元人民币。有研究者认为比特币具备打破几千年来全球货币由国家垄断发行的可能性。在不经意间,比特币引起的金融新浪潮已悄然成型。 虚拟货币并不是新鲜事物,......一起来看看 《比特币》 这本书的介绍吧!

图片转BASE64编码
图片转BASE64编码

在线图片转Base64编码工具

URL 编码/解码
URL 编码/解码

URL 编码/解码

RGB CMYK 转换工具
RGB CMYK 转换工具

RGB CMYK 互转工具