易现 InsightWeb 渲染引擎常见问题

资源下载异常（加载进不去）

1. 资源加载时，遇到报错 Right-hand side of 'instanceof' is not callable** 如下:

上述问题一般在 Android 平台出现，iOS 上加载正常，微信开发者工具上加载也正常； 原因是材质贴图使用 jpg 格式就会报错，改成 png 格式即可

2. 提示 xxx image is not found! 类问题？

• 请检查丢失贴图的路径和命名
• 文件所在路径中不能包含空格；
• 贴图命名：不使用空格、特殊字符、连接符等；使用下划线；命名中不使用点（这里不指 .png 中的点）
• 请检查是否使用了包含贴图的默认材质，带贴图的默认材质导出找不到对应的图片素材，请替换材质球

3. 加载时下载资源包报错

答：Unity 资源导出路径只能修改前边的路径，比如修改导出所在盘，以及给它加父文件夹，但不能修改 EZXRWebWXMini3DEngine/EZXRDemoExport 以及在其后添加子文件夹。

4. VKsession start error 112 类 VKsession 相关报错问题

112 隐私指引相关请参考：用户隐私保护指引参考

渲染异常

1. 模型在 iOS 上不显示，Android 端正常显示？（导出工具 v1.4.1 以后不存在该问题）**

答：进入 Unity 导出工具的 Json Shader (DO NOT DELETE)目录下，查找 json 文件中 textureCubeLodEXT 字段，替换为 textureCube，然后重新导出场景。

2. Skinned Mesh Renderer 中 BlendShape 是否支持？

答：不支持

3. 使用自定义 shader 的模型导出后，有时会遇到模型加载后不显示或者渲染异常问题？

答：原因一般是自定义 shader 使用外部工具自动化构建，用到了某些 Web3DEngine 不支持的接口，导致模型不能正常渲染，试图从以下方面进行下排查：

1）检查自定义 shader 代码，找到不常见的接口或命令，用其他代替

4. shader 问题可能会导致以下问题：

1）模型亮度忽明忽暗；可替换标准材质看是否还存在。

2）场景在某些角度会画面发白，可尝试在摄像机下背面放置一个默认的 cube

5. 小程序纯颜色模型以及调整颜色属性效果不大

答：小程序渲染效果对贴图依赖较大，纯颜色模型建议给颜色贴图后再调整；

6. 当导出场景中只有一张贴图时，渲染物体纯黑显示

答：受算法影响，一个场景中至少要有两张贴图，且均需显示；

即需要在场景中添加一个 quad，赋予一个不同于要显示内容贴图的材质球。缩放设为 0 且保持激活。一般作为摄像机子物体（挂载到摄像机下）方便管理。

7. Mac M1 芯片导出资源贴图不对（重复）

最新的导出工具已修复该问题

答：M1 芯片导出存在问题，可使用 windows 导出场景；

8. 模型纯黑显示

可能原因如下：

• 整个场景中的所有模型资源中，只使用了一张贴图资源；一个场景中至少要有两张贴图资源，故可在场景中添加一个使用了其他贴图资源的片。
• 使用了 jpg 格式的贴图，小程序请均使用 png 格式的资源文件
• 标准材质使用了金属度贴图，金属度只支持进行数值调整，不要赋予金属度贴图
• 小程序美术制作请在摄像机下放置一个 unity 创建的默认 cube（材质也使用默认材质），可规避一些shader 问题。
• shader 或其属性不支持

9. 模型或一些效果在 ios 显示正常，在 Android 端不显示或显示为黑，或其他显示异常

答：请检查模型所用贴图格式是否为 png，小程序要求必须使用 png 格式