layaair引擎 v3.3.2官方版

layaair引擎是一个商业级HTML5引擎，一般又称为layaair游戏引擎，是Layabox家族的核心产品，同时也是中国三大HTML5引擎之一，分别有支持ActionScript3、TypeScript、JavaScript三种语言版本，主要面向移动端和PC端的大型游戏和小型游戏研发，能够支持2D、3D、VR的开发，并实现开发3D产品时同步发布VR产品，其核心引擎库仅100K左右、运行内存仅占用2M左右，极轻，但是功能性并未打折，包括动画、UI、粒子、骨骼、物理、3D等系统，还具有支持引擎扩展与分包的独家优势，适用于广告、营销、教育、应用软件、PC工具、网站、3D、VR等领域的产品研发。

相对上一代引擎，layaair游戏引擎3.0在性能、API、工具链等方面做了整体优化，更小、更快、更强。同时软件具备AI生产力，已经全面拥抱AIGC（人工智能生成内容）。引擎支持AI创作生成、编辑器的AI控制、引擎技术AI客服等AI插件能力。未来，LayaAir将在保障在国产Web 3D引擎渲染能力持续领先的基础上，继续深入与掌趣科技的合作，大力发展AIGC与3D引擎的结合，定位“最易用的AIGC引擎生态”，快下载体验吧。

layaair游戏引擎3优势

1、极致性能

优异的性能一直是LayaAir引擎的核心追求，永无止境，极致追求。

2、领跑Web 3D引擎

LayaAir自推出3D引擎以来，多年商业案例技术积累，是基于web 图形API最成熟的国产开源3D引擎。在行业中已达成共识：开发3D小游戏就用LayaAir 。

3、完善工具链+AIGC

支持UI编辑器、3D场景编辑器、3D材质编辑器、3D粒子编辑器、3D蓝图编辑器、动画编辑器(2D+3D)、物理编辑器(2D+3D)、插件系统、资源商店、代码与美术设计分离等，以及AI创作生成、编辑器AI控制、引擎技术AI客服等AI插件能力！

4、全平台发布

一次开发，可同时发布Web版、安装包（安卓与iOS）、小游戏平台。

5、行业优选

拥有超百万的开发者生态，腾讯、阿里巴巴、网易、三七互娱、掌趣科技、猎豹移动、汤姆猫、商汤科技、电魂网络等大型企业选用的引擎。

6、应用广泛

适用于游戏、广告营销、教育、动画、元宇宙、数字人、数字孪生、智慧城市、工业控制、仿真模拟、国防模拟、线上展示（展厅、看房、旅行……）等众多3D 数字领域。

layaair引擎新功能：

一、升级为真正的全平台引擎

从LayaAir3.2开始，在历史版本的发布能力之上，我们会新增支持Windows系统、Linux系统、鸿蒙Next系统的发布。其中，Windows系统的exe安装包发布在3.2.0-beta.1版本内率先推出测试，Linux系统、鸿蒙Next系统还在紧密对接中，将会在3.2正式版之前推出。

一旦3.2正式版推出，开发者可以基于各个操作系统发布安装包、基于HTML5标准发布Web版本、以及发布到各个主流小游戏平台，使得LayaAir引擎升级为真正的全平台游戏引擎。

相对于非全平台的游戏引擎，LayaAir3引擎一套代码开发，全部平台发布运行的模式，可以大幅降低开发成本、提升市场推广机会。

二、Native易用性大幅提升

layaair 3.2版本中，我们支持自动打包成为各平台的安装包（例如exe、apk、ipa），并且提供选项，由开发者自主选择对应平台的安装环境，然后自动安装好打包所需的环境，使得开发者不必再为安装什么样的环境才能顺利打包而发愁。

当然，对于资深的开发者，如果更习惯使用传统的开发环境来打安装包，我们也保留了发布为原生包工程的方案。例如安卓勾选导出Android Studio项目、iOS勾选导出Xcode项目即可发布为原生包工程，而不是直接打包。

三、性能与效率大幅提升

无论何时，引擎的性能都是非常核心的指标，这将是项目发挥效果的天花板。本次版本，我们从Native安装包的运行性能、Spine动画的运行性能、3D粒子性能这几个方面对引擎性能进行了明显提升。

1、安装包运行性能提升

LayaAir3.2开始，我们优化了Native引擎的底层架构。引擎的渲染底层以及部分对性能消耗较大的核心模块，已下沉到Native C++层进行了实现。经过此次调整，Native APP的运算性能得以明显提升。同样以7477个渲染节点的3D示例为例，安卓测试机型的性能提升了50%，iOS测试机型的性能提升了近100%。

2、Spine运行性能提升

3.2开始，为提升Spine动画使用者的体验，我们针对Spine的官方库做了私有的性能优化，大幅提升了Spine官方库的动画在LayaAir引擎中的运行性能。我们首先采用了合并指令、GPU运算优化、缓存运算优化，这几种方式对CPU计算能力瓶颈进行提升。在一些CPU计算能力相对较差，但GPU相对较好的机型上，甚至可以得到几十倍的提升。这对CPU能力不强的机型，以及不支持JIT的iOS小游戏环境，是非常有价值的。

3、3D粒子编译效率提升

曾有开发者反馈3D粒子较多的时候导致卡顿。我们分析Demo后发现，shader的define数量较多，这导致了shader变体数量庞大，编译时间过长。由于shader在持续编译的过程出现卡顿现象，这是不可避免的。所以，我们进行了一系列的优化工作，主要目标是减少shader的define数量，降低shader变体数量，以减少编译时间，避免出现明显的卡顿现象。

例如一个Demo的粒子材质球，在优化前有92种变体，编译时长为7.004秒。使用3.2优化后的版本，只剩下66种变体，总编译时长也降至1.474秒。

4、正式支持WebGPU

LayaAir3.0开始接入WebGPU，直到此次的3.2版本，我们终于全面接入了WebGPU的图形API，这将是非常有意义的一个LayaAir引擎发展新里程。WebGPU作为现代Web图形标准，具有支持CPU多线程、支持通用计算能力等WebGL所不具备的能力与众多优势。注定要替代WebGL图形标准，主流3D引擎均会陆续接入该标准的API。

从引擎的角度，相较于WebGL，WebGPU提供了更高的性能优化和更低级别的硬件控制，使游戏引擎能够充分利用现代硬件的图形处理能力，这会带来更加出色的图形渲染和计算性能，以及更多基于WebGL无法实现的引擎功能。

5、3D相关功能的新增

在3D方面，LayaAir3.2中有两个重要的更新，其一是新增了材质缩略图预览，使得开发者可以在IDE中通过缩略图快速识别和选择所需的材质，而无需逐一打开，节省了大量时间，并使得材质的管理更加直观和高效，进一步提升了材质功能的易用性。

软件适用范围

【广泛应用】

可广泛适用于小型游戏、大型游戏、广告、营销、H5应用、教育、VR等领域

【双版本发布】

一次开发，同时发布：手游APP、HTML5双版本

【开发高效】

支持代码开发与美术设计分离。

【3D&VR】

满足即将来临的HTML5 3D及VR的统一引擎需求

为什么选择LayaAir？

一、引擎免费开源，问答社区、QQ群、开发者文档中心等开发者服务齐全。

二、性能最强的HTML5引擎，支持大型游戏流畅裸跑，性能媲美APP引擎。

三、支持ActionScript3、JavaScript、TypeScript三种开发语言，学习成本低，DEMO示例、API文档、工具链完善，一小时快速上手。

四、LayaAir IDE操作可视化，集成UI、地图、场景、动画、粒子、骨骼、3D等常用开发工具，大幅优化工作流程，提升开发效率。

五、只需一次开发，即可全平台(Android、IOS、Windows)同时发布，并且支持同时发布HTML5和APP双版本，项目单版本维护，成本低。

六、支持自定义Canvas、WebGL渲染模式，在WebGL模式下可自动切换。

更新日志

v3.3.2版本

引擎

修复了 Spine 资源中没有宽高参数时，导致无法显示的问题

修复了 Spine 添加后处理效果后显示异常的BUG

修复了 Spine 开启接受光照后显示异常的BUG

修复了List的Item模版是预制体时反序列化的BUG

修复了在微信小游戏连续执行Laya.SoundManager.playMusic方法会报错的问题

修复了切片组件不进行切割时，值为1，因资源异步导致的索引取错而显示异常的问题

修复了对使用了mask的节点设置zIndex属性无效的BUG

修复了Graphics绘制图形颜色半透明并且折叠的时候存在颜色叠加的问题

修复了RadioGroup设置标签边距后，运行效果对应不上IDE中的编辑效果问题

修复了因合批功能导致的，发布后draw9GridTexture绘制图像会出现异常的BUG

修复了 UI 赋予材质无效的BUG

修复了新 UI List 空白区域mouseThrough属性不生效的BUG

修复了startDrag方法的hasInertia为true时，拖拽结束后显示对象会飞走的BUG

修复了新2D系统遮罩的宽高为0，以及mask添加了图形后又删除后，遮罩效果异常的BUG

修复了安卓手机按HOME键离开浏览器，在失去焦点后，音乐播放未停止的BUG

修复了2D相机和2D区域在编辑状态下无法拖动的BUG

修复了2D相机会影响不是其子节点的节点显示BUG

修复了按钮置灰后设置隐藏依然会触发事件的BUG

修复了时间轴动画ctrl+shift+点击多选时只会选中有显示的关键帧的BUG

修复了NavAgent代理寻路中朝向和移动方向不匹配的BUG

修复了导航组件初始化时序问题（先初始化的agent预制体会导致导航surface还未初始化出现报错警告）

修复了Native的包名和窗体标题的名字没有采用IDE配置的显示名称问题

修复了PBR材质在Native包显示异常的BUG

修复了Native PBR渲染错误的问题

修复了windows中的videoNode currentTime和reload方法不能用的问题

修复了安卓Native在部分机型上因输入框导致的崩溃问题

IDE

修复了IDE属性面板中设置box的宽高为0时，运行宽高为自动适配的问题

修复了在IDE中按住shift拉伸精灵宽高，如果锚点不在中心或初始值，精灵宽高不会按等比缩放的BUG

修复了旧UI树状列表滚动条删除后编辑场景中没有变化的BUG

修复了编辑器快速连续启动预览与停止预览会报错的BUG

修复了3D刚体通过编辑工具改变形状后无法撤销的BUG

修复了IDE内SpotLight2D 在照射2D网格的时候存在位置偏移的BUG

新增与优化

新增：Native Android 适配16KB 页面大小

新增：自动图集功能现在在预览播放状态也会加载为图集形式，而不是之前版本的散图形式，提升了预览和发布的一致性。也支持了开发者手动加载自动图集（注意扩展名要使用atlas）。

新增：FBX模型文件导入选项增加了添加根节点属性，默认是勾选的，因为之前导入模型时自动增加了一个空节点作为根节点。用户可以取消这个勾选，避免生成额外的根节点。

新增：在经典UI系统的UIGroup（子类Tab和RadioGroup）中新增若干提升易用性的功能

新增根据节点宽高的子项自动换行开关lineWrap，并新增不换行时节点宽高根据子项总宽高自动适配的功能

新增换行后的行距大小控制功能lineSpace

新增标签文本溢出模式labelOverflow

新增标签垂直对齐模式labelVAlign

新增：在经典UI系统的RadioGroup中新增节点宽高是否自适应文本内容fitContent以及不自动适应文本内容时的文本标签固定的宽高设置labelFixedSize

新增：新增回收后处理效果中使用的所有RT（recoverAllRTS()）

新增：Laya.loader.loadPackage加载分包，新增了返回值，用于判断成功与失败

新增：在LayaAir Native引擎中，支持VideoNode.currentTime和reload

新增：在LayaAir Native引擎中，支持 webp 图片格式

新增：IDE插件系统在创建自定义的配置文件时，可以指定contributeToPlayerConfig参数，使配置文件可以在运行时（即预览或发布后）读取。详细用法参阅插件文档。

新增：Spine渲染器新增自动调整autoAdjust与位置偏移offset功能，方便开发者将Spine资源在IDE的显示位置与Spine设计工具的锚点位置对齐

优化：在经典UI系统的tree组件中支持在子项超出宽高时默认滚动显示

优化：使用本地模板创建IDE项目时，忽略模板中已有的.laya文件，由系统自动按项目名称生成

优化：更新 StatUI 的 show 方法以接受位置参数（感谢Geequlim贡献的代码）

优化：简化 AnimatorState 的 isLooping 取值逻辑（感谢Geequlim贡献的代码）

优化：增加设置材质时候的shader类型校验，禁止2D材质属性使用3D材质，以及3D材质属性使用2D材质，避免错用而导致底层报错。

优化：优化FPS实现逻辑，使得渲染刷新效果更加平稳