V0.33.0.0 Release Note ​

注意事项 ​

1. 资源库中的预制体使用时，改为网络资源引用的方式。 ​

如果需要对预制体节点进行二次编辑或其他使用需求，可以手动将引用的网络预制体资源导入到工程内容库中：

2. 对027遗留旧资源进行第二轮替换 ​

在033上打开旧版本工程后，可能会弹出资源替换窗口，如：

若提示中存在需要修改的资源，可以按照版本更新手册 | 脚本资源替换，替换旧的资源。

新增功能 ​

一、编辑器交互、资源管理、发版 ​

[优化]属性面板去除“生存时间” ​

在之前的版本中，属性面板上存在失效的“生存时间”属性，为了防止其造成误解，在本次更新中我们将该属性去除。

033之前生存时间

033

[新增]网络预制体引用规则改进 ​

由于之前版本中，从资源库拖动预制体到场景上时，会自动在工程内容中增添预制体文件，这可能在预览预制体时会造成工程内容的污染。所以在本次更新中，我们优化了网络预制体的引用规则。

创建预制体的改动：

• 优化前：从资源库中拖拽一个预制体到场景中时，会自动在工程内容中创建一份预制体资源，对象列表中引用的是工程内容中的预制体；
• 优化后：从资源库中拖拽一个预制体到入场景中时，对象列表将直接引用网络资源，不会在本地创建预制体文件；

预制体编辑的改动：

• 优化前：由于已经在工程内容中创建了预制体资源，所以可以直接对预制体的节点信息、属性进行编辑；
• 优化后：可以直接编辑引用的网络资源的属性，但如果需要编辑节点信息，需要先手动将预制体导入到本地工程。

二、UI编辑器功能新增及优化 ​

[新增]安全区适配及机型预览功能 ​

我们注意到，当前游戏项目在异形屏手机上运行时（尤其是 IPhone X 等 IOS 设备），UI可能会被刘海屏挡住，或者出现在无法进行点击交互的区域。为了解决这个问题，我们新增了以下功能：

1. 在UI文件的 Root 层级（对应 UserWidget 类中的 safeAreaEnable 属性）中，我们新增了【适配安全区】属性。默认情况下，这个功能是关闭的。

2. 勾选了【适配安全区】的UI文件在实例化为UI对象时，会自动读取玩家设备信息，并自动调整此UI文件中 RootCanvas 层级的尺寸和位置，将其收进异形屏设备的安全区范围内，从而避开 iPhone X 刘海屏、屏幕内部摄像头等无法显示/点击的区域，包括横屏翻转屏幕或者竖屏游戏的情况；同时不影响非异形屏设备的UI显示。

控制是否开启【适配安全区】API：

3. 主编辑器和UI编辑器的机型预览菜单新增了若干种预设机型，便于直接选择

主编辑器中选择预览某种机型后，主视口内的显示区域和运行时窗口的尺寸能调整为该机型的长宽比；

UI编辑器中选择预览某种机型后，能将该UI文件的设计尺寸自动调整为该机型的分辨率，同时应用DPI缩放，选择存在安全区配置的机型还能预览此UI文件的安全区适配情况；如果手动修改了设计尺寸，会结束机型预览状态，自动切换为主视口平铺状态。

4. UI编辑器中新增预览聊天框的区域，与主视口的聊天框区域类似，建议UI摆放尽量空出这一区域

• 目前UI编辑器中聊天框区域的提示没有单独控制是否展示的开关，如果想要关掉，请取消勾选【主编辑器右上角——显示——聊天框区域】。

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

[新增]实体建模工具 ​

编辑器中的基础模型支持布尔运算，可以使用实体建模工具对两个及以上的物体进行并集、差集运算，通过组合一些基本的静态模型，如方块、球体和圆柱体等，来创建新的复杂模型，可以自由组合出符合项目和游戏需求的物件。

• 组合：将多个模型融合为一个模型。
• 镂空：将模型设置为镂空状态。
• 分离：将融合模型分离为原始状态。

实体建模工具仅适用于静态模型中的基础模型，可以使用工具栏中的模型工具快捷创建。

组合工具 ​

基础模型可以使用组合工具(快捷键：Ctrl+Shift+U) 将多个模型融合为一个模型，若基础模型材质不同，则操作后的融合模型继承运算时首个输入模型的材质，如A+B再+C，则A+B+C的融合模型继承A模型的材质。

组合规则1:若选中的基础模型和融合模型都未产生交集，则组合时将所有选中对象组合为一个模型，镂空模型进行隐藏。

组合前

组合后

组合规则2:若产生交集的对象为实体对象+实体对象，则使用组合工具时，将选中的实体对象之间进行并集集合运算。

组合前

组合后

组合规则3：若产生交集的对象为镂空对象+镂空对象，则使用组合工具时，将选中的镂空对象之间进行并集集合运算。

组合前

组合后

组合规则4：若产生交集的对象为实体对象+镂空对象，则使用组合工具时，进行差集集合运算，从实体对象中减去与镂空对象重合的部分，镂空对象隐藏不可选中。

组合前

组合后

组合规则5：若选中对象中，同时存在以上情况，既包含未产生交集的对象，又包含产生交集的对象（实体+实体 / 镂空+镂空 / 实体+镂空），则使用组合工具时，将产生交集的基础模型按照上述规则进行分别计算。

组合前

组合后

镂空工具

基础模型可以使用镂空工具(快捷键：Ctrl+Shift+N)在实体状态和镂空状态之间切换。

镂空规则1：若选中对象皆为实体状态对象，则使用镂空工具时，所有实体状态的基础模型将切换为镂空状态。

镂空前

镂空后

镂空规则2：若选中对象皆为镂空状态对象，则使用镂空工具时，将所有镂空状态的基础模型切换为实体状态。

镂空前

镂空后

镂空规则3：若选中对象中同时包含实体状态和镂空状态对象，则使用镂空工具时，将所有基础模型切换为镂空状态，再次使用镂空工具，将所有基础模型切换回实体状态。

镂空前

镂空后

分离工具

融合模型可以使用分离工具(快捷键：Ctrl+Shift+S)将组合起来的各个模型还原。

若选中对象中包含融合模型，则使用分离工具时，按照组合顺序依次对融合模型进行分离。如A+B求并集后，再与C求并集，则分离时先将融合模型分离为Union（A+B）和C，再次分离时分离A和B。

分离前

分离后

保存为本地文件

1. 在对象管理器中右键选中组合模型时，可以在右键菜单中将该模型保存为本地文件，存储在在工程内容-模型路径下，命名为对象管理器中的命名，若出现名称相同的情况，则自动在名称后面添加正序序号1/2/3...

   

2. 模型列表中的文件支持拖入到场景和预制体中，生成一个新的融合模型，二者之间无引用关系。支持在主视口中还原为融合前的各个基础模型并支持继续对各个基础模型进行二次调整。

   

[新增]死亡边界功能 ​

为了防止玩家意外坠落到地图边界时，出现一直坠落的情况，我们提供了死亡边界功能。死亡边界开启后，角色在接触到死亡边界时，将会触发死亡状态，物体在接触到死亡边界时，触发删除功能。不启用时，死亡边界高度的属性将会被隐藏。

启用死亡边界和死亡边界高度需要在设置面板中设置：

• 可以在脚本中获取当前死亡边界的高度，但暂不支持在脚本中修改

  EnvironmentSettings类新增属性

[优化] 脚本逻辑 & 生命周期梳理 ​

在每帧tick期间，可以在代码多个入口写入业务逻辑。033版本将大部分脚本逻辑固定执行顺序，至此脚本的每一帧有一个比较清晰的帧生命周期和执行顺序。

[新增]支持TS监测当前触发层级是否为UI控件 ​

<Class><ScreenUtil> - 屏幕工具

方法

[新增]新增Touch回调事件，不受其他影响始终会在屏幕上响应 ​

<Class><InputUtil>

四、游戏功能对象新增功能及API更新 ​

[优化]水体优化 ​

• 水体功能我们进一步优化，完善了水体预设，并新增了屏幕空间反射效果。
  • 画质分级为7、8、9时自动开启，暂不支持手动开启
• 详情请见产品手册：水体区域 | 产品手册

[新增]角色基础状态二期（角色推动/角色死亡/角色起身） ​

我们补充了角色基础状态，新增了角色推动状态、角色死亡状态、角色起身状态。

推动状态 ​

用法:通过调用setStateEnabled方法开启角色的推动状态开关

Player.asyncGetLocalPlayer().then((player) => {
    this.character = player.character;
    // 开启角色的推动状态
    this.character.setStateEnabled(mw.CharacterStateType.Pushed, true)

    // 监听状态改变
    // prevState: mw.CharacterStateType, currentState: mw.CharacterStateType
    this.character.onStateChanged.add((ps, cs)=>{
         console.log("ps, cs ", ps, cs);    
    })
});

Player.asyncGetLocalPlayer().then((player) => {
    this.character = player.character;
    // 开启角色的推动状态
    this.character.setStateEnabled(mw.CharacterStateType.Pushed, true)

    // 监听状态改变
    // prevState: mw.CharacterStateType, currentState: mw.CharacterStateType
    this.character.onStateChanged.add((ps, cs)=>{
         console.log("ps, cs ", ps, cs);    
    })
});

开启后的角色将能被其他角色推着走:

死亡状态 ​

角色切换到死亡状态后会自动播放死亡动画，并在3秒后在离死亡地点最近的出生点复活，复活过程会从死亡状态切换回地面移动状态

起身状态 ​

当角色在布娃娃状态时，可以使用changeState(CharacterStateType.GettingUp)让角色更为自然的恢复到地面状态，使用代码如下：

jumpBtn.onPressed.add(() => {
    Player.asyncGetLocalPlayer().then((player) => {
        this.character = player.character;
        //使角色进入起身状态
        this.character.changeState(CharacterStateType.GettingUp)
    });
})

attackBtn.onPressed.add(() => {
    Player.asyncGetLocalPlayer().then((player) => {
        this.character = player.character;
        //使角色进入布娃娃状态
        this.character.changeState(CharacterStateType.Ragdoll)
    });
})

jumpBtn.onPressed.add(() => {
    Player.asyncGetLocalPlayer().then((player) => {
        this.character = player.character;
        //使角色进入起身状态
        this.character.changeState(CharacterStateType.GettingUp)
    });
})

attackBtn.onPressed.add(() => {
    Player.asyncGetLocalPlayer().then((player) => {
        this.character = player.character;
        //使角色进入布娃娃状态
        this.character.changeState(CharacterStateType.Ragdoll)
    });
})

角色将根据布娃娃状态，自动播放起身动画：

• 详情请见产品手册：角色基础状态 | 产品手册

[新增]获取角色morph位置接口 ​

• 我们提供了通过角色的MorphName实时获取顶点位置的接口，方便大家制作捏脸功能时绘制UI。

[新增]提供角色mesh旋转参数 ​

• 基于原来的mesh偏移我们进行调整和新增，将原来的meshOffset废弃，新增meshPositionOffset，用来控制角色mesh的相对坐标偏移。新增meshRotationOffset，用来控制角色的旋转偏移。（碰撞盒不变）

• meshPositionOffset应用场景 - 滑板模型在脚下，角色漂浮
• meshRotationOffset应用场景 - 直升机倾斜，角色跟着倾斜

修复BUG ​

[修复] 角色对象setVisibility，第二参数propagateToChildren = false不生效 ​

以头顶UI为例（挂载在角色胶囊体上）

修复前：character.setVisibility(false, false)，角色隐藏+头顶UI隐藏

修复后：character.setVisibility(false, false)，角色隐藏+头顶UI显示

之前项目中如果使用propagateToChildren = false，但是期望挂载子对象一起隐藏，则需要进行下列改动：

// 第二个参数默认值为true
character.setVisibility(false);

// 指定propagateToChildren = true
character.setVisibility(false, true);

// 第二个参数默认值为true
character.setVisibility(false);

// 指定propagateToChildren = true
character.setVisibility(false, true);