Skip to content
角色基础状态

角色基础状态

阅读本文大概需要 15 分钟

本文概述了角色的基础状态都有哪些,每种基础状态的切换与表现效果,以及可以利用角色的基础状态做哪些功能。

基础状态介绍

角色基础状态指的是角色在使用某种基础能力的情况下,使角色做出相应的动作效果,并且可以让角色在一段时间内处于一种稳定的状态,这种状态就是角色的基础状态。举个例子,角色在地面移动的时候,角色会播放跑步的动作,这个时候,角色就是处于地面移动状态。

角色基础状态

目前角色基础状态有9个,玩家可以通过接口切换基础状态,也可以通过跳跃等基础能力,自动切换到对应的基础状态。

中文名称枚举名称枚举序号应用说明
None0取消角色的复杂移动模式,采用简单移动模式状态
地面移动状态Running1角色在地面移动时的状态
飞行状态Flying2角色在空中飞行时的状态
游泳状态Swimming3角色在游泳时的状态
跳跃状态Jumping4角色在执行跳跃功能时的状态
自由落体状态Freefall5角色在空中下落时的状态
着陆状态Landed6角色在自由落体后,接触到地面时的状态
布娃娃状态Ragdoll7角色在布娃娃状态时的状态
下蹲状态Crouching8角色在下蹲时的状态

地面移动状态

状态定义:角色在地面的情况下,移动或静止时的状态效果。

状态说明:地面移动状态是大多数角色切换状态后的最终状态,也是角色最为基础的状态。比如角色切换为自由落体状态后,然后经过一段时间会接触到地面触发着陆状态,最后切换为地面移动状态。我们也可以动作主动切换地面移动状态,来重置角色当前的基础状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:地面移动状态
chara.changeState(CharacterStateType.Running)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:地面移动状态
chara.changeState(CharacterStateType.Running)

效果图:

飞行状态

状态定义:角色在忽略重力的情况下,在空中移动或静止时的状态。

状态说明:飞行状态是属于相对独立的角色状态,角色切换为飞行状态后,会自动播放飞行状态下的移动和待机动画。我们需要主动切换为其他的角色基础状态,才会取消角色的飞行状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:飞行状态
chara.changeState(CharacterStateType.Flying)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:飞行状态
chara.changeState(CharacterStateType.Flying)

效果图:

游泳状态

状态定义:角色在水中情况下,移动或静止时的状态效果。

状态说明:游泳状态是属于相对独立的角色状态,角色切换为游泳状态后,会自动播放游泳状态下的移动和待机动画。我们需要主动切换为其他的角色基础状态,才会取消角色的游泳状态。

中文示例英文示例
imgimg

注意:我们逻辑对象中提供了游泳区域的逻辑对象,进入游泳区域时,玩家会自动切换为游泳状态。离开游泳区域时,玩家会自动切换为自由落体状态,最终变为地面移动状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:游泳状态
chara.changeState(CharacterStateType.Swimming)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:游泳状态
chara.changeState(CharacterStateType.Swimming)

效果图:

跳跃状态

状态定义:角色在执行跳跃功能时的状态效果。

状态说明:跳跃状态并不是一个持续状态,属于过度状态,角色在执行跳跃功能时,将会切换为跳跃状态。在达到设定的跳跃高度后,会自动切换为自由落地状态,最后着陆,进入到地面移动状态。

注意:角色主动切换跳跃状态时,角色会直接执行跳跃功能。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:跳跃状态
chara.changeState(CharacterStateType.Jumping)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:跳跃状态
chara.changeState(CharacterStateType.Jumping)

效果图:

自由落体状态

状态定义:角色在受到重力影响下,从空中下落的状态效果。

状态说明:自由落体状态并不是一个持续状态,属于过度状态,角色在通过高空坠落时,将会切换为自由落体状态。角色在碰触到地面后会触发着陆状态,最后进入到地面移动状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:自由落体状态
chara.changeState(CharacterStateType.Freefall)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:自由落体状态
chara.changeState(CharacterStateType.Freefall)

效果图:

着陆状态

状态定义:角色在高空下落并接触到地面后的瞬时状态。

状态说明:着陆状态并不是一个持续状态,属于过度状态,角色在通过在空中接触到地面上时,将会切换为着陆状态,并播放着陆动画,最后进入到地面移动状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:着陆状态
chara.changeState(CharacterStateType.Landed)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:着陆状态
chara.changeState(CharacterStateType.Landed)

效果图:

布娃娃状态

状态定义:角色在不受玩家控制,且处于物体模拟的状态效果。

状态说明:角色在受到外力被击飞或倒地时,模拟现实中的真实效果,而产生的角色状态,该状态下角色不受玩家控制,并且角色模型会受到外力影响,产生一些物理效果。布娃娃状态是属于相对独立的角色状态,角色切换为布娃娃状态后,会自动切换为布娃娃效果。我们需要主动切换为其他的角色基础状态,才会取消角色的布娃娃状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:布娃娃状态
chara.changeState(CharacterStateType.Ragdoll)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:布娃娃状态
chara.changeState(CharacterStateType.Ragdoll)

效果图:

下蹲状态

状态定义:角色在执行下蹲功能时的状态效果。

状态说明:下蹲状态是属于相对独立的角色状态,角色切换为下蹲状态后,会自动播放下蹲状态下的移动和待机动画。我们需要主动切换为其他的角色基础状态,才会取消角色的下蹲状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:下蹲状态
chara.changeState(CharacterStateType.Crouching)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:下蹲状态
chara.changeState(CharacterStateType.Crouching)

效果图:

状态定义:角色将取消复杂移动逻辑,需要用户自定义动作状态和移动效果的状态。

状态说明:无状态是属于相对独立的角色状态,角色切换为无状态后,角色会关闭复杂移动逻辑,玩家需要自定义动作姿态和移动效果。我们需要主动切换为其他的角色基础状态,才会取消角色的无状态。

示例脚本:

ts
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:无状态
chara.changeState(CharacterStateType.None)
//获取玩家角色
let chara = Player.localPlayer.character
//如果是老项目,需要重新设置动作资源
chara.loadStance("216081").play();
//设置角色状态:无状态
chara.changeState(CharacterStateType.None)

效果图:

启用/禁用状态

我们提供了启用和禁用基础状态的功能,如果我们禁用了某种基础状态后,角色将无法切换到该禁用的基础状态下,角色会维持在切换前的上一个基础状态效果。

示例脚本:

ts
//禁用角色的地面移动状态
chara.setStateEnabled(CharacterStateType.Running,false);
//启用角色的地面移动状态
chara.setStateEnabled(CharacterStateType.Running,true);
//禁用角色的地面移动状态
chara.setStateEnabled(CharacterStateType.Running,false);
//启用角色的地面移动状态
chara.setStateEnabled(CharacterStateType.Running,true);

获取状态和切换状态回调

我们提供了获取角色当前状态,以及角色在切换状态时的回调,方便角色在切换状态时增加一些游戏逻辑。

示例脚本:

ts
//获取当前玩家角色
Player.asyncGetLocalPlayer().then((player) => {
    //角色状态改变时,回调角色之前状态和现在状态
    chara.onStateChanged.add((pre, curr)=>{
        //打印信息
        console.log(`pre: ${pre} curr: ${curr}`);
    })
});
//获取当前玩家角色
Player.asyncGetLocalPlayer().then((player) => {
    //角色状态改变时,回调角色之前状态和现在状态
    chara.onStateChanged.add((pre, curr)=>{
        //打印信息
        console.log(`pre: ${pre} curr: ${curr}`);
    })
});