V0.37.0.0 Release Note

注意事项

UI自适应文本框优化

此前，034版本优化了【自适应文本框】的算法，解决了部分文本开启【自适应文本框】后，没有填满框或超框的问题，

034-036版本让动态创建的文本框仍采用旧算法，导致了一些自适应计算字号错误的情况，从037开始会让动态创建的文本框都采用新算法，这可能会导致与旧算法的字号不一致，如果发现这种情况，需要辛苦手动调整项目。

一、编辑器交互及发版策略

[优化]编辑器去除MGS开关

编辑器在发布游戏时去除接入MGS开关，默认为开。在发布游戏后，可以统一在创作者中心的聊天服务中进行修改。

注意

MGS开关设置之后，会在新创建的房间上生效

[优化]对象管理器UX重构

优化前	优化后

新增筛选功能

新增对象管理器筛选功能，支持按照对象类型、网络状态、视口展示状态、视口锁定状态筛选对象。

同分类下的选项取并集进行筛选。不同分类下的选项取交集进行筛选。

新增脚本图标

支持在挂载了脚本的Object上面展示脚本图标。

滚动状态保持

编辑器运行前后保持对象的选中状态，并保持属性面板的页面滚动进度。

多选展开收起子对象

支持多选对象后，使用右键菜单展开和收起全部子对象。

预加载资源名称统一

预加载中的资源名称与资源库中的资源名称保持统一，解决预加载资源较多时，维护困难的问题。

ALT拖拽复制逻辑更新。

使用ALT+左键复制对象时，新生成的对象与原对象在同一个父节点下。

支持单独创建空节点。

支持单独创建组合（Group）的头节点，作为空父节点进行使用。

统一创建入口。

将对象右键菜单中的创建文件夹、创建合并对象统一放在对象管理器右上角的加号入口。

去除单击重命名。

选中文件时，去除单击文本区域重命名的功能，该交互与拖拽交互冲突，可以使用右键菜单或快捷键F2进行重命名。

更新前

更新后

二、UI 编辑器新增功能及 API 更新

[新增]提供克隆/序列化UI控件的方法

新增UI控件的克隆方法

<Class><Widget> - 控件

功能说明	方法名	返回类型	输入说明	输出说明	使用域
克隆，请注意只有.ui文件中保存的信息才能被克隆，父级信息和所有子级控件也会被克隆	clone(position：Vector2): Widget	Widget	position克隆创建的UI控件位置	widget返回克隆创建的UI控件	仅客户端

新增UI控件的序列化和反序列化方法，能把UI控件序列化为字符串，以及把字符串反序列化为UI控件

<Class><Widget> - 控件

功能说明	方法名	返回类型	输入说明	输出说明	使用域
序列化UI控件	serialize(): string;	string	Widget: 需要序列化的UI控件	返回传入控件序列化后的JSON字符串	只在客户端调用生效
反序列化UI控件	deserialize(Data: string, Parent?: Widget): Widget;	Widget	Data: 需要反序列化的JSON字符串Parent: 生成的UI控件的父节点	返回传入JSON字符串反序列化后得到的UI控件	只在客户端调用生效

注意

克隆和序列化所保留的控件信息范围的区别为：

UI控件的assetId信息，克隆会重新生成，序列化会保留原有assetId
UserWidget所携带的脚本信息，克隆不会保留，序列化会保留

除了以上两点，克隆和序列化所保留的控件信息范围完全一致，都仅限于.ui文件中保留的信息，也就是只保留暴露到属性面板上的属性，而UI控件的各种方法/监听以及属性面板上没有记录的属性无法被保留；如果未来暴露更多参数到属性面板及.ui文件中（例如预计039上线的控件自定义属性功能），新参数也能在克隆和序列化中被保留

[新增]UI控件——树视图

新增树视图控件，使用方法类似列表视图，区别在于树视图支持分层列表，其中具有包含嵌套项的展开/折叠项目，可用于编辑器插件中说明文件夹结构或对象父子级关系。详情请查看UI 控件-列表视图/瓦片视图/树视图 | 产品手册 (ark.online)

三、编辑器新增功能及 API 更新

[优化]基础人形形象/多足角色资源拖入场景生成Character

新版本中，基础人形形象/多足角色资源拖入场景将会自动生成Character，作为角色对象使用。旧资源当展示使用的均会迁移至模型分类下。

当前的项目不需要做适配改动，实际上是制作了一批新的资源放到了角色/NPC分类中

[新增]天空球扰动功能

为了方便大家实现空气扰动的视觉效果，本次更新我们在<SkyBox>下新增了扰动功能：

可以用于实现天空球贴图扰动效果：

新增API：

<SkyBox>

属性含义	属性名	类型	默认值	取值范围	说明
开启扰动	disturbanceEnabled	boolean	false	true/false	开启对天空球贴图进行扰动处理
扰动强度	disturbanceIntensity	number	0.0	[0.0-1.0]	设置扰动强度
扰动密集度	disturbanceDensity	number	0.0	[0.0-30.0]	设置扰动密集度

TIP

目前天空球扰动效果仅对“天空球贴图”生效，对天空盒上的其他项不生效

[新增]角色攀爬功能

角色新增“Climbing”状态，默认禁用状态（考虑到影响玩法），可以通过setStateEnabled开启状态。

进入攀爬的条件：
- 击中面的倾斜度大于角色“可站立角度”
- 击中点到角色盆骨处连线处于角度范围[-60°, 60°]内

墙面攀爬速度固定120，目前攀爬速度没有开放出来给大家调整
可绕边攀爬（边缘过于尖锐可能失败）
可通过“跳跃”退出攀爬状态
二次进入攀爬状态无cd（平面落地后会默认切换角色旋转防止重复进入）

JavaScript

if(SystemUtil.isServer()) {
    Player.onPlayerAdd.add((p) => {
        p.onCharacterAdd.add(async (chara) => {
            // 等待角色完成
            await chara.asyncReady();
            // 加载新姿态
           let newStance = chara.loadStance("216081");
           newStance.play();
           // 开启攀爬状态
           chara.setStateEnabled(CharacterStateType.Climbing, true);
        })
    });
}

if(SystemUtil.isServer()) {
    Player.onPlayerAdd.add((p) => {
        p.onCharacterAdd.add(async (chara) => {
            // 等待角色完成
            await chara.asyncReady();
            // 加载新姿态
           let newStance = chara.loadStance("216081");
           newStance.play();
           // 开启攀爬状态
           chara.setStateEnabled(CharacterStateType.Climbing, true);
        })
    });
}