CRIWARE Unity Plugin Manual  Last Updated: 2025-05-08
WebGL版概述

概述

本章介绍 WebGL 版 CRIWARE 的平台环境特有的信息。
WebGL 平台相比 iOS 或 Android 有更多限制,您需要注意多种事项。

它是如何工作的

CRIWARE

与其他模型一样,适用于 WebGL 目标的CRIWARE Unity 插件作为本机 Unity 插件提供。
有关 Unity 原生插件的更多信息,请参阅 Unity 文档。
CRIWARE由使用 Emscripten 构建的 .a 文件和用于使用浏览器功能的 .jslib 文件组成。
下图是CRIWARE for Unity (WebGL) 的概述。
cri4u_webgl_modules.png
CRIWARE for Unity WebGL

操作环境

基于 Unity 支持的浏览器。详细信息请参阅 Unity 文档。
另外,由于 AudioWorklet 用于ADX音频输出,因此它只能在 https 环境(或 localhost)中工作。

使用 WebGL 插件的注意事项

在使用WebGL版本的CRIWARE插件之前,请注意以下几点:

支持的 UnityEditor版本和 WebGL 插件包

WebGL 的CRIWARE Unity 插件当前使用 Emscripten 3.1.8 构建。
使用需要Unity 2022.3或更高版本。如果您需要使用不同 Emscripten 版本构建的库,请联系我们。
请参阅下文了解不同配置的插件的详细信息。

数据格式

适用于 WebGL 的CRIWARE Unity 插件支持ADX/HCA 编解码器。请使用包含为 PC 目标构建的ADX/HCA 编解码器的ADX数据 (.acb/.awb)。
请注意,它与使用旧版插件的 WebGL 目标构建的 AAC 数据不兼容。

异步加载

由于 WebGL 目标需要异步加载数据,
根据数据加载的时间,可能会出现它无法像其他目标一样工作的情况。
在这种情况下,您将需要修改一些 WebGL 脚本。

故障排除

对于特定于 WebGL 目标的问题,请参阅此处。