027API变动列表 ​

[优化]统一使用命名空间mw并兼容省略 ​

027版本中对所有原先的范围较大的命名空间例如【Gameplay】、【UI】、【Type】等进行命名空间隐藏处理。部分范围较小的命名空间例如【Events】、【SystemUtil】、【StringUtil】新增同名类对象，静态封装之前的方法。所有API统一使用mw命名空间且支持省略命名空间的调用方式以缩短调用链。

// 027修改前
InputUtil.onKeyDown(Type.Keys.Enter, async () => {
    let particle = await Core.GameObject.asyncSpawn({guid: "1001"}) as Gameplay.Particle;
    particle.worldLocation = Type.Vector.zero;
    particle.worldRotation = Type.Rotation.zero;
    particle.worldScale = Type.Vector.zero;
    particle.play();
});

// 027修改后
InputUtil.onKeyDown(Keys.Enter, async () => {
    let particle = await GameObject.asyncSpawn("1001") as Effect;
    particle.worldTransform.position = Vector.zero;
    particle.worldTransform.rotation = Rotation.zero;
    particle.worldTransform.scale = Vector.zero;
    particle.play();
});

// 027修改前
InputUtil.onKeyDown(Type.Keys.Enter, async () => {
    let particle = await Core.GameObject.asyncSpawn({guid: "1001"}) as Gameplay.Particle;
    particle.worldLocation = Type.Vector.zero;
    particle.worldRotation = Type.Rotation.zero;
    particle.worldScale = Type.Vector.zero;
    particle.play();
});

// 027修改后
InputUtil.onKeyDown(Keys.Enter, async () => {
    let particle = await GameObject.asyncSpawn("1001") as Effect;
    particle.worldTransform.position = Vector.zero;
    particle.worldTransform.rotation = Rotation.zero;
    particle.worldTransform.scale = Vector.zero;
    particle.play();
});

[修改]隐藏内部接口Mobile Editor ​

in[修改]删除资源预加载字段preloadAsset ​

由于资源相关改动，027版本不再支持代码使用preloadAssets属性去预加载资源（临时方案设计不合理）。脚本中若有使用需要删除否则会检测出编译报错。提前下载资源的方式只保留优先加载栏。027针对该改动做了兼容方案，所有老项目使用preloadAsset去预加载的资源，当在027版本编辑器打开项目时会自动进行读取导入至优先加载栏中，保证与之前效果相同。下图显示027对比026优先加载栏内多出的资源。

[修改] 枚举类型 ​

[删除]<类>AbilityObject 能力对象 ​

• 删除低频使用对象【AbilityObject】

[修改]<类>AbilityState 能力状态 ​

• 删除低频使用对象【AbilityState】

[删除]<类>AccountService 账号服务 ​

• 删除getInstance()，支持类名+方法名的调用方式，缩短调用链。
• 删除getOpenId()方法，去除OpenId概念，后续凡是与账号相关服务统一使用【Player】下userId属性。

[修改]<类>AdsService 广告服务 ​

• 删除getInstance()，支持类名+方法名的调用方式，缩短调用链。
• 删除show()方法，替换为showAd()。

上图示例中的callback是封装的回调事件，外部处理了成功后想要做些其他业务逻辑（比如弹出UI，换装等等，给奖励），如果自己实现的方法里没有使用callback，则直接在成功失败逻辑里去做想要干的事情即可

[修改]<类>AdvancedVehicle 高级轮式载具 ​

• 删除废弃方法getGearRatio，替换为getGearData。
• 删除设置方法setDriver、setSimulatePhysics、setSteeringInput、setThrottleInput，替换为标准属性setter实现：owner、simulatePhysics、steeringInput、throttleInput。

[删除]<类>Anchor 空锚点 ​

• 因【Anchor】 空锚点运行态暂不具备任何特殊功能，且内部没有独立接口，删除对象。

[修改]<类>AnalyticsService 分析服务 ​

• 删除getInstance()，支持类名+方法名的调用方式，缩短调用链。

[删除]<类>AICharacter AI角色 ​

• 删除【AICharacter】类，统一使用【Character】类代表角色对象，消除角色对象之间的区别。
• 删除内部私有defaultV1EditorDataJson属性。
• 删除setServerMovementEnable方法和serverCalculateEnable属性，替换为【Character】类中新增属性complexMovementEnabled。complexMovementEnabled默认为true，开启移动组件计算。complexMovementEnabled为false，关闭移动组件计算。

[修改]<类>Animation 动画 ​

• 027版本由【Animation】对象承担角色播放动画的功能
• onAnimFinished事件委托替换为onFinish，去除时态。
• rate属性替换为speed

[修改]<namespace>AssetUtil 函数 ​

• 命名空间【AssetUtil】改为类【AssetUtil】。
• 删除冗余接口isAssetExist()和isAssetLoaded()，使用assetLoaded()代替。
• 删除冗余接口loadAsset()，asyncDownloadAsset()会自动加载已下载资源。

[修改]<类>AvatarSettings 人物设置 ​

[修改]<类>Base 基类 ​

• guid属性修改为gameObjectId
• 删除对象的无效属性useUpdate（仅保留脚本的属性）。
• 删除对象生命周期方法onDestroy、onReplicated、onStart和onUpdate（仅保留脚本的方法）。
• 删除单双端判定方法isRunningClient（仅保留脚本的方法）。
• 删除内部接口arrayDefaultItem。

[删除]<类>BlockingArea 禁行区 ​

• 原先的【BlockingArea】修改为【BlockingVolume】，空间区域统一使用Volume。
• 删除失效属性playerStateResponse。
• 删除针对角色设置通行权限的方法setCurrentPlayerPassable和getCurrentPlayerPassable。后续统一使用同一个接口控制【GameObject】的通行权限。

setCurrentPlayerPassable：false使用removePassableTarget进行替换。

setCurrentPlayerPassable：true使用addPassableTarget进行替换。

getCurrentPlayerPassable使用getTargetPassable进行替换。

[删除]<类>BlockingAreaManager 禁行区管理 ​

• 删除【BlockingAreaManager】，不再提供全局禁行区对象的管理类。

[删除]<类>CameraShake 摄像机抖动 ​

• 【CameraShake】类修改为【CameraShakeInfo】接口，迁移其中关于抖动数据的属性。
• 【CameraShake】类中的start方法迁移至新增【Camera】对象中已静态方法的方式实现。

[删除]<类>CameraSystem 摄像机系统 ​

• 原有【CameraSystem】替换为【Camera】，将摄像机与玩家角色解耦并继承【GameObject】成为游戏对象。支持场景摆放，挂载卸载和动态生成销毁切换等操作，实现逻辑上的多相机。

• 解构摄像机系统：弹簧臂+镜头，抽象SpringArm弹簧臂对象包裹原先实际操作弹簧臂的接口。每个Camera摄像机对象持有一个SpringArm弹簧臂对象。

• 新增switch静态方法在多个相机对象之间进行切换，切换过程可以通过参数自定义摄像机运动。同时新增onSwitchComplete事件委托，用户可以待摄像机切换完成时执行绑定函数。此外删除moveByPath方法，后续摄像机路径移动可以通过switch方法代替。

• 删除摄像机抖动对象cameraShake，通过Camera类调用新增shake/stopShake静态方法抖动/停止抖动摄像机，抖动数据【CameraShakeInfo】和抖动时间作为参数传入。

• 删除摄像机锁定方法：cameraLockTarget、cancelCameraLockTarget、setCameraLockTarget。【Camera】新增lock和unlock方法控制摄像机锁定对象。此外删除lockTargetOffset属性，该属性的功能需要使用锁定方法中的lockOffset参数代替。此外新增lookAt方法执行方便用户执行单次锁定。

• 删除摄像机聚焦方法：cameraFocusing。删除摄像机聚焦属性：cameraFocusEnable。聚焦动作可通过用户设置摄像机坐标或者使用switch静态方法实现。

• 删除原先透视开关fadeEffectEnable和透明度fadeEffectValue接口，使用fadeObstructionEnabled和fadeObstructionOpacity代替。此外删除enableFadeEffect废弃接口。

• 删除摄像机投影模式（后续只有透视模式）以及相关功能：cameraProjectionMode、orthoFarClipPlane、orthoNearClipPlane、orthoWidth。如果需要使用正交模式(例如制作固定视角休闲游戏),推荐使用视场=35度(或更小)，并同时调大摄像机距离等参数来模拟正交模式。

• 删除摄像机移动碰撞检测相关接口：enableMovementCollisionDetection、movementCollisionDuration、movementCollisionMinLocationDelta。

• 删除遮挡检测接口：occlusionDetectionEnable。

• 删除摄像机跟随接口：followTargetEnable、followTargetInterpSpeed、cancelCameraFollowTarget、setCameraFollowTarget，后续摄像机通过使用【Gaemobject】的parent属性去挂载/卸载其他对象来实现跟随。

• 删除摄像机抬高接口：raiseCameraEnable和raiseCameraHeight，后续摄像机开启弹簧臂碰撞时会伸缩，而关闭弹簧臂碰撞时可以选择透视。

• 删除摄像机模拟真实晃动开关属性realEffectEnable。

• 删除摄像机整体参数设置接口：applySettings和getCurrentSettings。

• 删除摄像机覆盖控制器旋转接口：setOverrideCameraRotation和resetOverrideCameraRotation。玩家控制器旋转由【Player】新增的setControllerRotation和getControllerRotation替换。

• 删除摄像机位置模式cameraLocationMode，替换为positionMode。此外原先设置为”固定”模式时，摄像机弹簧臂会采用相对坐标作为自己的世界位置。而027版本设置为fixed模式会沿用世界位置。所以027如果希望还原026效果，需在替换接口前加上下列代码：

  typescript

  // 拿到摄像机
  let camera = Camera.currentCamera;
  // 先在切换位置模式前拿到摄像机对象相对挂载对象的相对偏移
  let tempOffset = camera.springArm.localTransform.position;
  // 切换模式，摄像机不再挂载父节点
  camera.positionMode = CameraPositionMode.PositionFixed;
  // 将相对偏移值设置为世界坐标
  camera.springArm.worldTransform.position = tempOffset;
  // 执行下列操作

  // 拿到摄像机
  let camera = Camera.currentCamera;
  // 先在切换位置模式前拿到摄像机对象相对挂载对象的相对偏移
  let tempOffset = camera.springArm.localTransform.position;
  // 切换模式，摄像机不再挂载父节点
  camera.positionMode = CameraPositionMode.PositionFixed;
  // 将相对偏移值设置为世界坐标
  camera.springArm.worldTransform.position = tempOffset;
  // 执行下列操作

• 删除摄像机旋转模式cameraRotationMode，替换为rotationMode。此外原先设置为”固定”模式时，摄像机弹簧臂会采用（0，0，0）作为自己的世界旋转。而027版本设置为fixed模式会沿用上一帧控制器旋转值（摄像机相对于挂载对象的旋转）。所以027如果希望还原026效果，需在替换接口前加上下列代码：

  typescript

  // 拿到摄像机
  let camera = Camera.currentCamera;
  // 切换模式，摄像机不再受控制器旋转影响
  camera.rotationMode = CameraRotationMode.RotationFixed;
  // 将弹簧臂世界旋转设置为(0,0,0)
  camera.springArm.worldTransform.rotation = Rotation.zero;
  // 执行下列操作

  // 拿到摄像机
  let camera = Camera.currentCamera;
  // 切换模式，摄像机不再受控制器旋转影响
  camera.rotationMode = CameraRotationMode.RotationFixed;
  // 将弹簧臂世界旋转设置为(0,0,0)
  camera.springArm.worldTransform.rotation = Rotation.zero;
  // 执行下列操作

[修改]<类>Character 角色 ​

• 为消除角色对象之间的区别，统一使用【Character】类代表场景中的角色对象，将原先【CharacterBase】的基础能力进行抽象并封装进【Character】。
• 删除原先【Character】中的技能接口：onSkillTriggered等。使用【InputUtil】代替。
• 删除属性cameraSystem，将摄像机与玩家角色解耦并继承【GameObject】成为游戏对象。

[删除]<类>CharacterBase 角色基类 ​

• 为消除角色对象之间的区别，统一使用【Character】类代表场景中的角色对象，将原先【CharacterBase】代表角色基础能力的接口迁移进【Character】。
• 删除空中灵活度控制接口：airControlBoostMultiplier和airControlBoostVelocityThreshold，同时空中灵活度接口airControl替换为driftControl；空中减速接口brakingDecelerationFalling替换为horizontalBrakingDecelerationFalling。减低理解难度。
• 删除角色动画模式animationMode，用户不再需要手动切换。动画模式会根据角色类型：人形->Auto（自带动画状态机），四足：Custom（手动播动画），由编辑器自动切换。
• 删除动画姿态（二级姿态）属性animationStance，动画姿态（二级姿态）从角色中提出，采用【SubStance】对象承接原来的接口。animationStance替换为currentSubStance.assetId。原先角色修改动画姿态ID会使角色播放该姿态，替换为currentSubStance.play和currentSubStance.play。原先角色修改动画姿态ID为空会停止播放姿态，替换为currentSubStance.stop。删除加载动画姿态（二级姿态）方法loadStance，替换为loadSubStance。删除停止当前动画姿态（二级姿态）方法stopStance，替换为currentSubStance.stop。
• 删除基础姿态属性basicStance，基础姿态从角色中提出，采用【Stance】对象承接原来的接口。basicStance替换为currentStance.assetId。原先角色修改基础姿态ID会使角色播放该姿态，替换为currentStance.play和currentStance.play。原先角色修改基础姿态ID为空会停止播放姿态，替换为currentStance.stop。

• 删除角色外观对象属性appearance，替换为角色描述description。角色外观由原来的层级对象修改为配置表形式，统一使用【CharacterDescription】描述。设置/获取外观方法getAppearance和setAppearance替换为getDescription和setDescription。清空角色外观方法clearAppearance替换为clearDescription，其中参数设置为appearance: true。此外删除角色外观设置权限属性canSetAppearanceData。

  

• 删除清空角色挂件方法clearDecorations，替换为clearDescription，其中参数设置为slotAndDecoration: true。删除清空单个挂件方法clearOneDecoration、删除获取角色挂件对象列表方法getDecorations，两者都需要使用【CharacterDescription】中的挂件配置项，去访问具体插槽挂件数组description.advance.slotAndDecoration.slot["SlotName"].decoration，前者可以调用delete方法删除挂件，后者可以访问数组中的元素。删除加载插槽数据方法loadSlotAndEditorDataByGuid替换为setDescription。此外删除加载挂件方法loadDecoration和loadSlotAndEditorDataByPath。
• 删除角色外观分类属性appearanceType，替换为角色类型characterType。
• 删除角色阴影控制属性：baseShadowLocationOffset、baseShadowMaxVisibleHeight和baseShadowScale。后续角色阴影由编辑器底层控制。
• 删除角色碰撞相关接口：capsuleRadius和capsuleHalfHeight。由于后续角色碰撞体支持多种形状，碰撞范围接口替换为collisionExtent。删除角色碰撞开关collisionEnable，替换为setCollision和getCollision方法。此外collisionWithOtherCharacterEnable替换为collisionWithOtherCharacterEnabled。删除角色胶囊体矫正属性usedCapsuleCorrection，替换为capsuleCorrectionEnabled。
• 角色头顶显示名称characterName替换为displayName。头顶UI获取方法getHeadUIWidget替换为只读属性overheadUI。此外原先成员属性headUIVisible和headUIVisibleRange由于功能是作用于场景中全部对象，所以删除后替换为静态属性nameVisible和nameDisplayDistance。
• 角色是否可被站立属性canStepUpOn替换为canStandOn。
• 角色下蹲能力开关crouchEnable替换为crouchEnabled；角色移动能力开关moveEnable替换为moveEnabled;角色跳跃能力开关jumpEnable替换为jumpEnabled;角色跳跃出水能力开关jumpingOutOfWaterEnable替换为canJumpOutOfWater；角色布娃娃开关ragdollEnable替换为ragdollEnabled。角色摩擦单独生效属性separateBrakingFrictionEnable，替换为groundFrictionEnabled，此处需注意原先属性值false对应新属性值true，原先属性值true对应新属性值false。
• 删除角色本地可见性属性locallyVisible，后续在客户端使用setVisibility和getVisibility替换。删除角色同步可见性属性visible，后续在服务端使用setVisibility和getVisibility替换。删除角色本地可见性接口setLocallyVisibility，在客户端使用setVisibility替换。
• 角色移动模式属性movementState替换为movementMode，同时移动模式变化委托onMovementStateChanged替换为onMovementModeChange。
• 角色大小属性scale替换为角色持有的【worldTransform】中scale属性。
• 删除角色换装完成委托onLoadAppearanceDataAllCompleted、onLoadDecorationsAllCompleted、onSetAppearanceDataCompleted。三者合并为角色描述加载完成委托onDescriptionComplete。删除角色外观变化委托onMeshChanged、onTextureChanged。两者合并为角色描述变化完成委托onDescriptionChange，其中传出操作码标识发生变化的属性。此外角色外观异步等待函数`appearanceReady直接删除。

• 【Character】对象继承【Pawn】对象新增player属性，玩家角色player为控制玩家，NPCplayer为空。
• 删除增加角色移动输入方法addMoveInput，替换为addMovement。
• 删除角色attach方法，将对象插入角色插槽使用attachToSlot替换。同时新增detachFromSlot和detachAllFromSlot方法卸载角色插槽挂载的对象。
• 删除获取玩家控制器旋转方法getControlRotator，替换为【Player】对象中的静态方法getControllerRotation。同时新增setControllerRotation方法搭配使用。
• 删除获取角色插槽名称方法getSlotName，通过TS语法可以直接在枚举名称和值之间转化。
• 删除角色播放动画方法playAnimation和playAnimationLocally，替换为loadAnimation().play()分别在服务端调用和客户端调用。删除角色判断动画播放状态接口isPlayingAnimation，替换为currentAnimation.isPlaying。删除角色停止动画接口stopAnimation，替换为currentAnimation.stop。
• 删除角色上浮/下潜接口swimmingDown和swimmingUp，分别替换为swimDown和swimUp。

接口名称（老）	属类（老）	接口类型（老）	接口名称（新）	属类（新）	修改方案
airControl	CharacterBase	GetAccessor	driftControl	Character
airControlBoostMultiplier	CharacterBase	GetAccessor	-
airControlBoostVelocityThreshold	CharacterBase	GetAccessor	-
animationMode	CharacterBase	GetAccessor	-
animationStance	CharacterBase	GetAccessor	currentSubStance.assetId	SubStance
appearance	CharacterBase	GetAccessor	description	Character
appearanceType	CharacterBase	GetAccessor	characterType	Character
baseShadowLocationOffset	CharacterBase	GetAccessor	-
baseShadowMaxVisibleHeight	CharacterBase	GetAccessor	-
baseShadowScale	CharacterBase	GetAccessor	-
basicStance	CharacterBase	GetAccessor	currentStance.assetId	Stance
basicStanceAimOffsetEnable	CharacterBase	GetAccessor	currentStance.aimOffsetEnabled	Stance
brakingDecelerationFalling	CharacterBase	GetAccessor	horizontalBrakingDecelerationFalling	Character
canSetAppearanceData	CharacterBase	GetAccessor	-
canStepUpOn	CharacterBase	GetAccessor	canStandOn	Character
capsuleHalfHeight	CharacterBase	GetAccessor	collisionExtent.z	Vector
capsuleRadius	CharacterBase	GetAccessor	Max(collisionExtent.x, collisionExtent.y)	Vector
characterName	CharacterBase	GetAccessor	displayName	Character
collisionEnable	CharacterBase	GetAccessor	setCollision	Character
collisionWithOtherCharacterEnable	CharacterBase	GetAccessor	collisionWithOtherCharacterEnabled	Character
crouchEnable	CharacterBase	GetAccessor	crouchEnabled	Character
headUIVisible	CharacterBase	GetAccessor	nameVisible	Character
headUIVisibleRange	CharacterBase	GetAccessor	nameDisplayDistance	Character
jumpEnable	CharacterBase	GetAccessor	jumpEnabled	Character
jumpingOutOfWaterEnable	CharacterBase	GetAccessor	canJumpOutOfWater	Character
locallyVisible	CharacterBase	GetAccessor	setVisibility	GameObject
moveEnable	CharacterBase	GetAccessor	movementEnabled	Character
movementState	CharacterBase	GetAccessor	movementMode	Character
outOfWaterZ	CharacterBase	GetAccessor	outOfWaterVerticalSpeed	Character
ragdollEnable	CharacterBase	GetAccessor	ragdollEnabled	Character
scale	CharacterBase	GetAccessor	worldTransform.scale	Transform
separateBrakingFrictionEnable	CharacterBase	GetAccessor	groundFrictionEnabled	Character
usedCapsuleCorrection	CharacterBase	GetAccessor	capsuleCorrectionEnabled	Character
visible	CharacterBase	GetAccessor	getVisibility	GameObject
airControl	CharacterBase	SetAccessor	driftControl	Character
airControlBoostMultiplier	CharacterBase	SetAccessor	-
airControlBoostVelocityThreshold	CharacterBase	SetAccessor	-
animationMode	CharacterBase	SetAccessor	-
animationStance	CharacterBase	SetAccessor	currentSubStance.assetId	SubStance
appearanceType	CharacterBase	SetAccessor	characterType	Character
baseShadowLocationOffset	CharacterBase	SetAccessor	-
baseShadowMaxVisibleHeight	CharacterBase	SetAccessor	-
baseShadowScale	CharacterBase	SetAccessor	-
basicStance	CharacterBase	SetAccessor	currentStance.assetId	Stance
basicStanceAimOffsetEnable	CharacterBase	SetAccessor	currentStance.aimOffsetEnabled	Stance
brakingDecelerationFalling	CharacterBase	SetAccessor	horizontalBrakingDecelerationFalling	Character
canStepUpOn	CharacterBase	SetAccessor	canStandOn	Character
capsuleHalfHeight	CharacterBase	SetAccessor	collisionExtent.z	Vector
capsuleRadius	CharacterBase	SetAccessor	Max(collisionExtent.x, collisionExtent.y)	Vector
characterName	CharacterBase	SetAccessor	displayName	Character
collisionEnable	CharacterBase	SetAccessor	setCollision	Character
collisionWithOtherCharacterEnable	CharacterBase	SetAccessor	collisionWithOtherCharacterEnabled	Character
crouchEnable	CharacterBase	SetAccessor	crouchEnabled	Character
headUIVisible	CharacterBase	SetAccessor	nameVisible	Character
headUIVisibleRange	CharacterBase	SetAccessor	nameDisplayDistance	Character
jumpEnable	CharacterBase	SetAccessor	jumpEnabled	Character
jumpingOutOfWaterEnable	CharacterBase	SetAccessor	canJumpOutOfWater	Character
locallyVisible	CharacterBase	SetAccessor	setVisibility	GameObject
moveEnable	CharacterBase	SetAccessor	movementEnabled	Character
outOfWaterZ	CharacterBase	SetAccessor	outOfWaterVerticalSpeed	Character
ragdollEnable	CharacterBase	SetAccessor	ragdollEnabled	Character
scale	CharacterBase	SetAccessor	worldTransform.scale	Transform
separateBrakingFrictionEnable	CharacterBase	SetAccessor	groundFrictionEnabled	Character
usedCapsuleCorrection	CharacterBase	SetAccessor	capsuleCorrectionEnabled	Character
visible	CharacterBase	SetAccessor	getVisibility	GameObject
onLoadAppearanceDataAllCompleted	CharacterBase	PropertyDeclaration	onDescriptionComplete	Character
onLoadDecorationsAllCompleted	CharacterBase	PropertyDeclaration	onDescriptionComplete	Character
onMeshChanged	CharacterBase	PropertyDeclaration	onDescriptionChange	Character
onMovementStateChanged	CharacterBase	PropertyDeclaration	onMovementModeChange	Character
onSetAppearanceDataCompleted	CharacterBase	PropertyDeclaration	onDescriptionComplete	Character
onTextureChanged	CharacterBase	PropertyDeclaration	onDescriptionChange	Character
player	CharacterBase	PropertyDeclaration	player	Pawn
addMoveInput	CharacterBase	MethodDeclaration	addMovement	Character
appearanceReady	CharacterBase	MethodDeclaration	-	GameObject
attach	CharacterBase	MethodDeclaration	attachToSlot	Character
clearAppearance	CharacterBase	MethodDeclaration	clearDescription	Character
clearDecorations	CharacterBase	MethodDeclaration	clearDescription	Character
clearOneDecoration	CharacterBase	MethodDeclaration	description.advance.slotAndDecoration.slot["SlotName"].decoration.delete()	Character
detachFromGameObject	CharacterBase	MethodDeclaration	parent	GameObject
getAppearance	CharacterBase	MethodDeclaration	getDescription	Character
getControlRotator	CharacterBase	MethodDeclaration	getControllerRotation	Player
getDecorations	CharacterBase	MethodDeclaration	-
getHeadUIWidget	CharacterBase	MethodDeclaration	overheadUI	Character
getSlotName	CharacterBase	MethodDeclaration	-
isPlayingAnimation	CharacterBase	MethodDeclaration	currentAnimation.isPlaying	Animation
loadDecoration	CharacterBase	MethodDeclaration	setDescription	Character
loadSlotAndEditorDataByGuid	CharacterBase	MethodDeclaration	setDescription	Character
loadSlotAndEditorDataByPath	CharacterBase	MethodDeclaration	-
loadStance	CharacterBase	MethodDeclaration	loadSubStance	Character
playAnimation	CharacterBase	MethodDeclaration	loadAnimation().play()	Animation
playAnimationLocally	CharacterBase	MethodDeclaration	loadAnimation().play()	Animation
setAppearance	CharacterBase	MethodDeclaration	setDescription	Character
setLocallyVisibility	CharacterBase	MethodDeclaration	setVisibility	GameObject
stopAnimation	CharacterBase	MethodDeclaration	currentAnimation.stop()	Animation
stopStance	CharacterBase	MethodDeclaration	currentSubStance.stop()	SubStance
swimmingDown	CharacterBase	MethodDeclaration	swimDown	Character
swimmingUp	CharacterBase	MethodDeclaration	swimUp	Character

[修改]<类>ChatService 聊天服务 ​

• 删除getInstance()，支持类名+方法名的调用方式，缩短调用链。

[修改]<namespace>Core 函数 ​

027上Core相关命名空间已经被删除，027相关接口如有替换则需要修改，否则直接删除Core即可，如下所示：

[修改]<namespace>DataStorage 数据存储 ​

• 命名空间【DataStorage】改为类【DataStorage】。
• 数据存储统一使用一套接口，不再区分玩家数据和自定义数据。之前使用含player的玩家数据接口，key值统一为Player的userId。027版本使用新接口，传入userId作为key的参数即可获取之前的数据。

asyncGetPlayerData和asyncGetCustomData合并，->asyncGetData。

027版本Get方法返回类型修改为【DataStorageResult】结构和替换方案如下图所示：

asyncSetPlayerData和asyncSetCustomData合并，->asyncSetData。

asyncRemoveCustomData和asyncRemovePlayerData合并，->asyncRemoveData。

[修改]<类>DataCenterC 数据中心客户端 ​

• 去除getInstance，缩短调用链。

[修改]<类>DataCenterS 数据中心服务端 ​

• 去除getInstance，缩短调用链。
• onPlayerJoined和onPlayerLeft事件委托替换为onPlayerJoin和onPlayerLeave，去除时态。

[修改]<类>DebugService 聊天服务 ​

• 删除getInstance()，支持类名+方法名的调用方式，缩短调用链。

[删除]<类>Decoration 挂件数据 ​

• 删除【Decoration】挂件数据类，后续统一使用【CharacterDescription】挂件数据对象。

[删除]<类>DirectionalLight 平行光 ​

• 删除【DirectionalLight】平行光，接口修改为静态调用形式迁移至新增对象【Lighting】。
• 删除继承自【GameObject】的接口，【Lighting】不继承【GameObject】。
• 删除光强intensity，替换为brightness。
• 删除无效属性baseShadowEnable。
• 删除阴影投影castShadowsEnable，替换为castShadowsEnabled。
• 删除色温temperature，替换为temperatureEnabled。

[删除]<类>EffectLogical 区域效果 ​

• 删除低频使用对象【EffectLogical】

[修改]<类>EffectService 特效服务 ​

• 删除getInstance()，支持类名+方法名的调用方式，缩短调用链。成员函数全部封装成静态方法。
• 删除clearAll()方法，屏蔽用户对内部对象池的操作带来的风险。
• 新增playOnGameObject方法，参数使用联合类型来实现playEffectOnPlayer和playEffectOnGameObject两个方法的功能。

[删除]<类>Equipment 装备 ​

• 删除低频使用对象【Equipment】

[修改]<命名空间>Events 函数 ​

• 新增【Event】类，静态封装命名空间【Events】中与事件相关的方法。
• dispatchLocal方法替换为dispatchToLocal，其余事件通信接口addClientListener、addLocalListener、addServerListener、dispatchToAllClient、dispatchToClient和dispatchToServer封装为类静态方法。
• 删除应用状态监听方法：addOnResumeListener、addOnPauseListener和addExitListener。在【SystemUtil】类中新增onResume、onPause和onExit事件委托进行替换，回调方法统一采用委托对象绑定函数的形式。
• 删除聚焦状态监听方法：addFocusListener和addUnfocusedListener。在【WindowUtil】类中新增onFocus和onDefocus事件委托进行替换，回调方法统一采用委托对象绑定函数的形式。
• 删除玩家进入/离开游戏监听方法：addPlayerJoinedListener和addPlayerLeftListener。在【Player】类中新增onPlayerJoin和onPlayerLeave事件委托进行替换，回调方法统一采用委托对象绑定函数的形式。

[删除]<类>ExponentialHeightFog 环境雾 ​

• 删除【ExponentialHeightFog】环境雾，接口修改为静态调用形式迁移至新增对象【Fog】。因为环境雾并不支持叠加使用，场景中有且仅有一份生效，故027版本将其放置到世界对象以默认配置存在。
• 删除继承自【GameObject】的接口，【Fog】不继承【GameObject】。
• 删除属性中的fog前缀：fogDensity-> density；fogEnable-> enabled；fogHeight-> height；fogHeightFalloff-> heightFalloff；fogInscatteringColor-> inscatteringColor；fogMaxOpacity-> maxOpacity；
• 删除设置雾气预设方法setPresetByIndex，替换为setPreset。

[修改]<类>Extension命名空间 ​

• Extension修改为mwext

• saveProperty修改为persistence

[删除]<类>FourFootStandard 四足外观 ​

• 删除【SomatotypeBase】四足角色外观对象。统一使用【CharacterDescription】角色外观描述对象中的base对象进行四足角色的外观操作。
• 删除设置/获取四足体型方法getSomatotype和changeSomatotype，后续四足外观只支持设置全身模型。

[修改]<类>GameObject 游戏对象 ​

• 统一使用世界变换worldTransform和本地变换localTransform承载原先对象内Transform相关的属性和方法。每个【GameObject】持有worldTransform和localTransform。两个transform对象保存了【GameObject】的引用，所有针对worldTransform和localTransform的修改都会反应到对象身上。

// a是一个GameObject对象
a: GameObject;

// worldTransform引用了对象a，对worldTransform的操作会反应在对象a上。
let transform = a.worldTransform；
transform.position = new Vector(100, 0, 0);

// position没有保存对象的引用，对position 的操作并不会影响对象a。
let position = a.worldTransform.position；

// a是一个GameObject对象
a: GameObject;

// worldTransform引用了对象a，对worldTransform的操作会反应在对象a上。
let transform = a.worldTransform；
transform.position = new Vector(100, 0, 0);

// position没有保存对象的引用，对position 的操作并不会影响对象a。
let position = a.worldTransform.position；

• 删除无效属性：staticStatus、lockStatus。

• 删除内部方法：attachComponent和detachComponent。

• 对象生成接口spawn和asyncSpawn方法将assetId作为必填参数放在首位，即spawn时第一个参数必须传入对象的资源ID。而其他对象生成所需用到的属性，则统一通过GameObjectInfo对象作为可选参数进行设置。此外删除废弃方法：asyncSpawnGameObject和spawnGameObject。

  

  

• 新增isReady属性标明对象的准备状态。原先的ready方法改为asyncReady。

• 删除visible属性，统一使用getVisibility方法替换。

• 删除内部私有接口：scriptNumberPropPathMap和 scriptPropPathNumberMap。

• 删除addDestroyCallback和deleteDestroyCallback方法，使用onDestroyDelegate委托替换，回调方法统一采用委托对象绑定函数的形式。

• 删除内部方法：attachComponent和detachComponent。

• 删除对象挂载/卸载方法：attachToGameObject和detachFromGameObject，使用parent属性来控制对象的挂载和卸载，便于统一维护挂载和父子两对关系。

• find方法改名为findGameObjectById，强调通过gameObjectId查找对象。

• 查询方法返回的是对象数组（复数），findGameObjectByTag替换为findGameObjectsByTag。

• 空间大小统一使用extent命名，getBoundingBoxSize替换为getBoundingBoxExtent。

• 将“碰撞”属性从【GameObject】迁移，废弃原有碰撞相关方法getCollision和setCollision，配合碰撞枚举中“跟随父节点”的去除，以简化世界中的碰撞机制。目前游戏对象中仅【Model】和【Character】保留碰撞接口。

接口名称（老）	属类（老）	接口类型（老）	接口名称（新）	属类（新）	修改方案
forwardVector	GameObject	GetAccessor	worldTransform.forwardVector	GameObject
lockStatus	GameObject	GetAccessor	-
relativeLocation	GameObject	GetAccessor	localTransform.positon	GameObject
relativeRotation	GameObject	GetAccessor	localTransform.rotation	GameObject
relativeScale	GameObject	GetAccessor	localTransform.scale	GameObject
rightVector	GameObject	GetAccessor	worldTransform.rightVector	GameObject
staticStatus	GameObject	GetAccessor	-
transform	GameObject	GetAccessor	worldTransform	GameObject
upVector	GameObject	GetAccessor	worldTransform.upVector	GameObject
useUpdate	GameObject	GetAccessor	-
visible	GameObject	GetAccessor	getVisibility	GameObject
worldLocation	GameObject	GetAccessor	worldTransform.positon	GameObject
worldRotation	GameObject	GetAccessor	worldTransform.rotation	GameObject
worldScale	GameObject	GetAccessor	worldTransform.scale	GameObject
lockStatus	GameObject	SetAccessor	-		删除
relativeLocation	GameObject	SetAccessor	localTransform.position	GameObject
relativeRotation	GameObject	SetAccessor	localTransform.rotation	GameObject
relativeScale	GameObject	SetAccessor	localTransform.scale	GameObject
transform	GameObject	SetAccessor	worldTransform	GameObject
useUpdate	GameObject	SetAccessor	-
worldLocation	GameObject	SetAccessor	worldTransform.position	GameObject
worldRotation	GameObject	SetAccessor	worldTransform.rotation	GameObject
worldScale	GameObject	SetAccessor	worldTransform.scale	GameObject
scriptNumberPropPathMap	GameObject	PropertyDeclaration	-
scriptPropPathNumberMap	GameObject	PropertyDeclaration	-
addDestroyCallback	GameObject	MethodDeclaration	onDestroyDelegate	GameObject
asyncFind	GameObject	MethodDeclaration	asyncFindGameObjectById	GameObject
asyncGetScriptByName	GameObject	MethodDeclaration	getScriptByName	GameObject
asyncSpawn	GameObject	MethodDeclaration	asyncSpawn	GameObject
asyncSpawnGameObject	GameObject	MethodDeclaration	asyncSpawn	GameObject
attachComponent	GameObject	MethodDeclaration	-
attachToGameObject	GameObject	MethodDeclaration	parent	GameObject
deleteDestroyCallback	GameObject	MethodDeclaration	onDestroyDelegate.remove	GameObject
detachComponent	GameObject	MethodDeclaration	-
detachFromGameObject	GameObject	MethodDeclaration	parent	GameObject
find	GameObject	MethodDeclaration	findGameObjectById	GameObject
findGameObjectByTag	GameObject	MethodDeclaration	findGameObjectsByTag	GameObject
getBoundingBoxSize	GameObject	MethodDeclaration	getBoundingBoxExtent	GameObject
getChildByGuid	GameObject	MethodDeclaration	getChildByGameObjectId	GameObject
getChildrenBoxCenter	GameObject	MethodDeclaration	getChildrenBoundingBoxCenter	GameObject
getCollision	GameObject	MethodDeclaration	-
getForwardVector	GameObject	MethodDeclaration	worldTransform.getForwardVector	GameObject
getGameObjectByName	GameObject	MethodDeclaration	findGameObjectByName	GameObject
getGameObjectsByName	GameObject	MethodDeclaration	findGameObjectsByName	GameObject
getRelativeLocation	GameObject	MethodDeclaration	localTransform.position	GameObject
getRelativeRotation	GameObject	MethodDeclaration	localTransform.rotation	GameObject
getRelativeScale	GameObject	MethodDeclaration	localTransform.scale	GameObject
getRightVector	GameObject	MethodDeclaration	worldTransform.getRightVector	GameObject
getScriptByGuid	GameObject	MethodDeclaration	getScript	GameObject
getSourceAssetGuid	GameObject	MethodDeclaration	assetId	GameObject
getTransform	GameObject	MethodDeclaration	worldTransform	GameObject
getUpVector	GameObject	MethodDeclaration	worldTransform.getUpVector	GameObject
getVisibility	GameObject	MethodDeclaration	getVisibility	GameObject
getWorldLocation	GameObject	MethodDeclaration	worldTransform.position	GameObject
getWorldRotation	GameObject	MethodDeclaration	worldTransform.rotation	GameObject
getWorldScale	GameObject	MethodDeclaration	worldTransform.scale	GameObject
ready	GameObject	MethodDeclaration	asyncReady	GameObject
setCollision	GameObject	MethodDeclaration	-
setLocationAndRotation	GameObject	MethodDeclaration	- 拆分为2个接口
setRelativeLocation	GameObject	MethodDeclaration	localTransform.position	GameObject
setRelativeRotation	GameObject	MethodDeclaration	localTransform.rotation	GameObject
setRelativeScale	GameObject	MethodDeclaration	localTransform.scale	GameObject
setTransform	GameObject	MethodDeclaration	worldTransform	GameObject
setWorldLocation	GameObject	MethodDeclaration	worldTransform.position	GameObject
setWorldRotation	GameObject	MethodDeclaration	worldTransform.rotation	GameObject
setWorldScale	GameObject	MethodDeclaration	worldTransform.scale	GameObject
spawn	GameObject	MethodDeclaration	spawn	GameObject
spawnGameObject	GameObject	MethodDeclaration	spawn	GameObject

[修改]<命名空间>Gameplay函数 ​

[修改]<类>GameObjPool 游戏对象池 ​

• 删除getInstance，缩短调用链。
• 删除获取对象池中对象方法find

[删除]<类>Group 缓动组 ​

• 删除【Group】对象，替换为【TweenGroup】。

[修改]<类>HitResult 击中结果 ​

• 删除对象击中位置属性location，替换为position。

[修改]<类>HotWeapon 热武器 ​

• 合并委托接口，接口名称不再区分C/S端，根据调用端自动绑定。删除老委托接口，替换为新接口。

onEquippedClient` & `onEquippedServer` -> `onEquip
onUnequippedClient` & `onUnequippedServer` -> `onUnequip

onEquippedClient` & `onEquippedServer` -> `onEquip
onUnequippedClient` & `onUnequippedServer` -> `onUnequip

• 删除原先Enable属性，替换为Enabled。
• 删除失效方法getTransformForFire。
• 删除设置发射模式方法setCurrentFireModel，替换为发射组件fireComponent中fireMode属性。
• 删除装备/卸载武器方法：equipment和unequipHotWeapon，替换为equip和unequip。

[修改]<类>HotWeaponAccuracyOfFireComponent 热武器瞄准组件 ​

• 删除无效方法bindOpenAccuracyOfFireComponentDelegates，后续使用委托无需绑定。
• 删除散射值变化委托onCurrentDispersionChangedClient，替换为onCurrentDispersionChange。

[修改]<类>HotWeaponAimComponent 热武器瞄准组件 ​

• 删除失效属性瞄准镜UI种类scopeTypeIndex。
• 合并委托接口，接口名称不再区分C/S端，根据调用端自动绑定。删除老委托接口，替换为新接口。

onAimStartClient` & `onAimStartServer` -> `onStartAim
onAimEndClient` & `onAimEndServer` -> `onEndAim

onAimStartClient` & `onAimStartServer` -> `onStartAim
onAimEndClient` & `onAimEndServer` -> `onEndAim

[修改]<类>HotWeaponFireComponent 热武器发射组件 ​

• Guid后续统一区分为对象ID：gameobjectId；资源ID：assetId；删除animationGuid，替换为animationAssetId。
• 删除原属性current前缀，替换为新属性：currentBulletSize -> currentBullet；currentClipSize -> clipSize；currentFireInterval -> fireInterval；currentFireModel -> fireMode；currentMultipleShot -> multipleShot。
• 删除判断全自动模式接口isFullAutoMode，替换为发射模式属性fireMode完成判断。
• 删除组件内动画ID判断方法hadAnimationGuid。
• 合并委托接口，接口名称不再区分C/S端，根据调用端自动绑定。删除老委托接口，替换为新接口。

onEndContinuousFireServer` -> `onEndContinuousFire
onEndFireClient` & `onEndFireServer` -> `onEndFire
onStartFireClient` & `onStartFireServer `-> `onStartFire

onEndContinuousFireServer` -> `onEndContinuousFire
onEndFireClient` & `onEndFireServer` -> `onEndFire
onStartFireClient` & `onStartFireServer `-> `onStartFire

[修改]<类>HotWeaponLoadComponent 热武器上膛组件 ​

• Guid后续统一区分为对象ID：gameobjectId；资源ID：assetId；删除animationGuid，替换为animationAssetId。
• 删除发射后上膛属性loadAfterFireEnable，替换为loadAfterFireEnabled。
• 删除组件内动画ID判断方法hadAnimationGuid。
• 合并委托接口，接口名称不再区分C/S端，根据调用端自动绑定。删除老委托接口，替换为新接口。

onEndLoadClient` & `onEndLoadServer` -> `onEndLoad
onStartLoadClient` & `onStartLoadServer` -> `onStartLoad

onEndLoadClient` & `onEndLoadServer` -> `onEndLoad
onStartLoadClient` & `onStartLoadServer` -> `onStartLoad

[修改]<类>HotWeaponRecoilForceComponent 热武器后坐力组件 ​

• 合并委托接口，接口名称不再区分C/S端，根据调用端自动绑定。删除老委托接口，替换为新接口。

onStartRecoilForceClient` & `onStartRecoilForceServer` -> `onStartRecoil

onStartRecoilForceClient` & `onStartRecoilForceServer` -> `onStartRecoil

[修改]<类>HotWeaponReloadComponent 热武器换弹组件 ​

• Guid后续统一区分为对象ID：gameobjectId；资源ID：assetId；删除animationGuid，替换为animationAssetId。
• 删除组件内动画ID判断方法hadAnimationGuid。
• 合并委托接口，接口名称不再区分C/S端，根据调用端自动绑定。删除老委托接口，替换为新接口。

onEndReloadClient` & `onEndReloadServer` -> `onEndReload
onStartReloadClient` & `onStartReloadServer` -> `onStartReload

onEndReloadClient` & `onEndReloadServer` -> `onEndReload
onStartReloadClient` & `onStartReloadServer` -> `onStartReload

[删除]<类>Humanoid 非玩家角色 ​

• 删除【Humanoid】类，统一使用【Character】类代表角色对象，消除角色对象之间的区别。
• 删除serverCalculateEnable方法和serverMovementEnable属性，替换为【Character】类中新增属性complexMovementEnabled。complexMovementEnabled默认为true，开启移动组件计算。complexMovementEnabled为false，关闭移动组件计算。

[删除]<类>HumanoidV1 V1外观 ​

• 删除【HumanoidV1】等相关的V1角色外观对象。统一使用【CharacterDescription】角色外观描述对象中的base对象进行V1角色的外观操作。
• 删除设置姿态方法changeSomatotype和getSomatotype，后续V1外观只支持设置全身模型。
• 删除V1外观的组成face、hair、trunk，后续V1外观只支持设置全身模型。

[删除]<类>HumanoidV1Part V1外观基类 ​

• 删除V1外观的所有类【HumanoidV1Part】【 HumanoidV1Hair】【HumanoidV1Trunk】【HumanoidV1Face】，后续V1外观只支持设置全身模型。

[删除]<类>HumanoidV1Hair V1头发 ​

同HumanoidV1Part V1外观基类

[删除]<类>HumanoidV1Trunk V1躯干 ​

同HumanoidV1Part V1外观基类

[删除]<类>HumanoidV1Face V1脸 ​

同HumanoidV1Part V1外观基类

[删除]<类>HumanoidV2 V2外观 ​

• 删除【HumanoidV2】等相关的V2角色外观对象。统一使用【CharacterDescription】角色外观描述对象中的advance对象进行V2角色的外观操作。

[删除]<类>HumanoidV2HairPart V2头发基类 ​

• 删除继承自【HumanoidV2HairPart】的相关的V2角色发型外观对象。统一使用【CharacterDescription】角色外观描述对象中的frontHair和backHair对象操作V2角色的发型。下表以frontHair为例：

【HumanoidV2FrontHairPart】 -> advance.hair.frontHair

【HumanoidV2BehindHairPart 】 -> advance.hair.backHair

[删除]<类>HumanoidV2FrontHairPart V2前发 ​

• 见HumanoidV2HairPart

[删除]<类>HumanoidV2BehindHairPart V2后发 ​

• 见HumanoidV2HairPart

[删除]<类>HumanoidV2ClothPart V2服装基类 ​

• 删除继承自【HumanoidV2ClothPart】的相关的V2角色服饰对象。统一使用【CharacterDescription】角色外观描述对象中的upperCloth、lowerCloth、gloves和shoes对象操作V2角色的服饰。下表以upperCloth为例：

【HumanoidV2UpperClothPart】 -> advance.clothing.upperCloth

【HumanoidV2LowerClothPart】 -> advance.clothing.lowerCloth

【HumanoidV2GlovesPart】 -> advance.clothing.gloves

【HumanoidV2ShoePart】 -> advance.clothing.shoes

[删除]<类>HumanoidV2UpperClothPart V2上装 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2LowerClothPart V2 下装 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2GlovesPart V2手套 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2ShoePart V2鞋子 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2HeadPart V2头部 ​

• 删除继承自【HumanoidV2HeadPart】的相关的V2角色头部外观对象。统一使用【CharacterDescription】角色外观描述对象中的妆容makeup和头部特征headFeatures对象操作V2角色的头部特征。

[删除]<类>HumanoidV2UpperClothPart V2上装 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2LowerClothPart V2 下装 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2GlovesPart V2手套 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2ShoePart V2鞋子 ​

• 见HumanoidV2ClothPart

[删除]<类>HumanoidV2HeadPart V2头部 ​

• 删除继承自【HumanoidV2HeadPart】的相关的V2角色头部外观对象。统一使用【CharacterDescription】角色外观描述对象中的妆容makeup和头部特征headFeatures对象操作V2角色的头部特征。

[删除]<类>HumanoidV2Shape V2 体型 ​

• 删除继承自【HumanoidV2Shape】的相关的V2角色身体外观对象。统一使用【CharacterDescription】角色外观描述对象中的bodyFeatures对象操作V2角色的身体特征。