水体区域
阅读本文大概需要 10 分钟
本文概述了水体区域的定义,水体区域都有哪些功能,表现效果以及使用方式。
什么是水体区域
水体区域定义:水体区域是一个具有一定形状的区域,它具有水面和水下效果,并且可以在角色进入该区域时,切换为游泳状态。开发者使用该对象在自己想要的区域,实现角色游泳效果。例如场景中的游泳池,河流湖泊和海洋都可以放置水体区域。
水体区域在编辑器中以功能对象的形式存在,打开编辑器后在左侧资源栏中的“逻辑资源”中,选取“游戏功能对象”,红框中就是水体区域,资源ID为WaterVolume。
水体区域使用
如何找到水体区域?
在【资源库】-【游戏功能对象】列表中找到【水体区域】的对象。
中文示例 | 英文示例 |
---|---|
使用水体区域
我们在找到水体区域后,可以根据需求手动拖入场景内,修改其属性来实现相应的效果,也可以通过代码动态生成水体区域。
中文示例 | 英文示例 |
---|---|
基础属性中包括了水体的物理属性和水体的表现效果。我们可以通过调节水体摩擦力,改变角色在水中的移动效果。我们也可以通过调节水体属性和水波效果调整水面的表现效果。
动态生成水体区域
中文示例 | 英文示例 |
---|---|
也可以将鼠标悬停在要的的资源上方,查看资源的GUID;也可以通过右键,复制对象的GUID。然后通过GUID动态创建相应的资源。
动态生成特效的示例脚本:
ts
// 异步spawn,没有找到资源时会下载后在生成
GameObject.asyncSpawn("12683").then((obj) => {
let pool = obj as WaterVolume;
})
// 异步spawn,没有找到资源时会下载后在生成
GameObject.asyncSpawn("12683").then((obj) => {
let pool = obj as WaterVolume;
})
ts
// 普通spawn生成,没有优先加载或预加载资源则无法生成
let pool = GameObject.spawn("WaterVolume") as WaterVolume;
// 普通spawn生成,没有优先加载或预加载资源则无法生成
let pool = GameObject.spawn("WaterVolume") as WaterVolume;
注意
为了保证之前版本水体的兼容性,我们新增水体的逻辑对象,它将会使用的是WaterVolume的GUID,之前游泳区域的逻辑对象GUID依旧是SwimmingVolume,在后续的版本中我们依旧会保留SwimmingVolume的功能,之前的项目可以正常使用。
游泳区属性介绍
水体摩擦力
功能说明:角色在游泳区域内的摩擦力,影响角色移动的加速度和表现效果,角色在水中的制动力表现同时受角色属性中[游泳属性]-[游泳制动速度]的影响
演示效果:
水体摩擦力=1 | 水体摩擦力=100 |
---|---|
启用浮力
功能说明:为水体区域添加浮力效果,可能将具有物理模拟属性的对象浮在水体中.
演示效果:
水体属性介绍
主体颜色
功能说明:水体区域主要显示的颜色
演示效果:
相关接口:
ts
//找到水体区域
let water = GameObject.findGameObjectById("21C44BBD") as WaterVolume;
//主体颜色设置为红色
water.waterColor = LinearColor.red
//找到水体区域
let water = GameObject.findGameObjectById("21C44BBD") as WaterVolume;
//主体颜色设置为红色
water.waterColor = LinearColor.red
透明度
功能说明:水体区域的透明化程度。0为完全透明,1为完全不透明。
演示效果:
相关接口:
ts
//透明度设置为0.6
water.transmittance = 0.6
//透明度设置为0.6
water.transmittance = 0.6
水波属性介绍
水波强度
功能说明:水面上的水波强弱显示效果
演示效果:
相关接口:
ts
//设置水波强度为0.3
water.normalFlat = 0.3
//设置水波强度为0.3
water.normalFlat = 0.3
水波角度
功能说明:水波的倾斜角度效果
演示效果:
相关接口:
ts
//设置水波的角度为0.5
water.flowAngle = 0.5
//设置水波的角度为0.5
water.flowAngle = 0.5
水波速度
功能说明:水波的流动速度
演示效果:
相关接口:
ts
//设置水波的速度为20
water.flowSpeed = 20
//设置水波的速度为20
water.flowSpeed = 20
水波密度
功能说明:水波在水面上的整体密集程度
演示效果:
相关接口:
ts
//设置水波密度为500
water.flowTile = 500
//设置水波密度为500
water.flowTile = 500
其他说明
控制角色上浮下沉
演示效果:
相关接口:
ts
@Component
export default class Example_Character_SwimDown extends Script {
// 当脚本被实例后,会在第一帧更新前调用此函数
protected onStart(): void {
// 下列代码仅在服务端执行
if(SystemUtil.isServer()) {
// 生成拱形容器并适配游泳区域
GameObject.spawn("WaterVolume",{transform: new Transform(new Vector(0, 0, 500), new Rotation(0, 0, 90), new Vector(10, 10, 10))});
}
// 下列代码仅在客户端执行
if(SystemUtil.isClient()) {
// 获取当前客户端的玩家(自己)
let myPlayer = Player.localPlayer;
// 获取当前玩家控制的角色
let myCharacter = myPlayer.character;
// 添加一个按键方法:按住键盘“1”,角色上浮
InputUtil.onKeyPress(Keys.One, () => {
myCharacter.swimUp(5);
});
// 添加一个按键方法:按住键盘“2”,角色下潜
InputUtil.onKeyPress(Keys.Two, () => {
myCharacter.swimDown(5);
});
}
}
}
@Component
export default class Example_Character_SwimDown extends Script {
// 当脚本被实例后,会在第一帧更新前调用此函数
protected onStart(): void {
// 下列代码仅在服务端执行
if(SystemUtil.isServer()) {
// 生成拱形容器并适配游泳区域
GameObject.spawn("WaterVolume",{transform: new Transform(new Vector(0, 0, 500), new Rotation(0, 0, 90), new Vector(10, 10, 10))});
}
// 下列代码仅在客户端执行
if(SystemUtil.isClient()) {
// 获取当前客户端的玩家(自己)
let myPlayer = Player.localPlayer;
// 获取当前玩家控制的角色
let myCharacter = myPlayer.character;
// 添加一个按键方法:按住键盘“1”,角色上浮
InputUtil.onKeyPress(Keys.One, () => {
myCharacter.swimUp(5);
});
// 添加一个按键方法:按住键盘“2”,角色下潜
InputUtil.onKeyPress(Keys.Two, () => {
myCharacter.swimDown(5);
});
}
}
}