xr-frame框架下的GLTF模型自发光动画实现教程

一、前言

微信小程序官方于2022年12月31日新推出了一套AR/VR/3D框架——xr-frame，他相比于传统的3D开发，性能更高、效果更好并且开发更加便捷（开发体验和效率都提升了非常多）。

1.1 更新日志：

基础库更新日志 (v2.x版本) | 微信开放文档

1.2 官方文档：

开始 | 微信开放文档

不过官方文档并不详细，很多案例以外的功能都需要自主实现，对于更高级的效果由于资料缺乏，导致无法实现。

二、效果演示

作者也是在实际项目研发中通过不断摸索，找到了一些门道，在这里分享给大家，希望对大家有所启发，话不多说，先上效果图：

三、实现教程

3.1 官方GLTF文档：

GLTF介绍 | 微信开放文档

3.2 分析gltf模型数据：

也就是glb结尾的模型文件的jsonRaw信息，我们如何才能获取到gltf模型的jsonRaw数据呢？方法也比较简单，官方文档有写，但也就是一笔带过

第一步：在<xr-asset-load> 标签上加上一个属性（红色字处）

<xr-asset-load type="gltf" asset-id="gltfModel" src="/assets/xxx.gltf" options="preserveRaw: true"/>

第二步：在资源加载完成的事件（bind:loaded="handleAssetsLoaded"）里面将gltf的jsonRaw打印出来（红色标记处是gltf模型的资源id）

console.log(this.scene.assets.getAsset("gltf", "gltf-text"))

第三步：分析gltf模型的json数据

这一步就不完全的展开说了，里面内容较多，我们仅找到要的东西就行

通过观察gltf模型的json数据，我们可以看到TA的material（材质），然后material下面还有texture（纹理），要想实现自发光动画，我们得找到 emissiveFactor，这一步很关键，我们可以看到 emissiveFactor的值为[1,1,1]的数组，这应该就是控制自发光的关键了

3.3 通过代码修改值：

我们需要将gltf模型的mesh赋值到全局，然后在全局的tick方法中去改变该mesh下的material的texture的u_emissiveFactor的值，看起来比较绕，代码实现起来也比较绕，哈哈

第一步：在<xr-gltf>标签上加加载完成事件，然后在事件里面实现这段逻辑

index.wxml

<xr-scene ar-system="modes:Marker" bind:ready="handleReady" bind:ar-ready="handleARReady" bind:tick="handleTick">

...

<xr-gltf model="gltf-text" scale="0.1 0.1 0.1" rotation="-90 0 0" bind:gltf-loaded="handleTxtLoaded"/>

...

</xr-scene>

第二步：实现改变模型材质纹理的自发光值核心代码

# index.ts

...

handleTick: function({detail}) {

  // 帧触发

  // console.log('handleTick', detail)

  if (this.text02Mesh) {

    this.text02MeshTickCount++;

    if (this.text02MeshTickCount >= 100) {

      this.text02MeshTickCount = 0;

    }

    // 是否增加

    let add = true;

    if (parseInt(this.text02MeshTickCount / 10) % 2 == 0) {

      add = true;

    } else {

      add = false;

    }

    let ef = 0;

    if (add) {

      ef = this.text02MeshTickCount % 10 / 10;

    } else {

      ef = 1 - this.text02MeshTickCount % 10 / 10;

    }

    this.text02Mesh.material.setTexture("u_emissiveFactor", [ef, ef, ef])

  }

},

handleTxtLoaded: function({detail}) {

  const el = detail.value.target;

  const gltf = el.getComponent("gltf");

  for (const mesh of gltf.getPrimitivesByNodeName("Text02")) {

    mesh.material.setTexture("u_emissiveFactor", [0, 0, 0])

    this.text02Mesh = mesh;

    this.text02MeshTickCount = 0;

  }

},

...

四、结束语 

教程有些短，希望能给大家带来一些启发

基于xr-frame我们可以实现一些自定义效果，是需要不断摸索的，过程中充满了痛苦，但要坚持

对于官方文档我相信大家都在内心或多或少地吐槽了千百遍了，吐槽归吐槽，也还是很感谢微信官方降低了xr的开发难度，希望未来的xr-frame文档更清晰，功能更强大，效果更上一层楼，一起加油，共勉~