Version: 2020.3

CharacterController

class in UnityEngine

/

继承自:Collider

切换到手册

描述

CharacterController 可使您轻松进行受碰撞约束的移动,同时不必处理刚体。

CharacterController 不受力影响,仅在您调用 Move 函数时才会移动。 然后它执行移动,但受碰撞约束。

另请参阅:角色控制器 (Character Controller) 组件角色动画示例

变量

center该角色的胶囊体中心(相对于变换组件的位置)。
collisionFlags在上次 CharacterController.Move 调用期间,该胶囊体的哪个部分与环境发生了碰撞。
detectCollisions确定其他刚体或角色控制器是否与该角色控制器碰撞(默认情况下始终启用它)。
enableOverlapRecovery启用或禁用重叠恢复。 启用或禁用重叠恢复。用于在检测到重叠时取消角色控制器从静态对象的穿透。
height该角色胶囊体的高度。
isGrounded在上次移动期间 CharacterController 是否接触地面?
minMoveDistance获取或设置此角色控制器的最小移动距离。
radius该角色胶囊体的半径。
skinWidth该角色的碰撞皮肤宽度。
slopeLimit这些角色控制器的坡度限制(单位为度)。
stepOffset这些角色控制器的台阶偏移量(单位为米)。
velocity该角色的当前相对速度(请参阅注释)。

公共函数

Move为 GameObject 的移动提供附加的 CharacterController 组件。
SimpleMove以 speed 移动该角色。

消息

OnControllerColliderHit当该控制器在执行 Move 时撞到碰撞体时调用 OnControllerColliderHit。

继承的成员

变量

attachedArticulationBodyThe articulation body the collider is attached to.
attachedRigidbody碰撞体附加到的刚体。
bounds碰撞体的世界空间包围体积(只读)。
contactOffset该碰撞体的接触偏移值。
enabled启用的 Collider 将与其他 Collider 碰撞,禁用的 Collider 不会这样。
isTrigger碰撞体是不是触发器?
material碰撞体使用的材质。
sharedMaterial该碰撞体的共享物理材质。
gameObject此组件附加到的游戏对象。始终将组件附加到游戏对象。
tag此游戏对象的标签。
transform附加到此 GameObject 的 Transform。

公共函数

ClosestPoint返回碰撞体上最接近给定位置的一个点。
ClosestPointOnBounds与附加碰撞体的包围盒最接近的点。
Raycast投射除这一个外忽略其他所有 Colliders 的 Ray。
BroadcastMessage调用此游戏对象或其任何子项中的每个 MonoBehaviour 上名为 methodName 的方法。
CompareTag此游戏对象是否使用 tag 进行了标记?
GetComponentReturns the component of Type type if the GameObject has one attached, null if it doesn't. Will also return disabled components.
GetComponentInChildren使用深度首次搜索返回 GameObject 或其任何子项中类型为 type 的组件。
GetComponentInParent返回 GameObject 或其任何父项中类型为 type 的组件。
GetComponents返回 GameObject 中类型为 type 的所有组件。
GetComponentsInChildrenReturns all components of Type type in the GameObject or any of its children. Works recursively.
GetComponentsInParent返回 GameObject 或其任何父项中类型为 type 的所有组件。
SendMessage调用此游戏对象中的每个 MonoBehaviour 上名为 methodName 的方法。
SendMessageUpwards调用此游戏对象中的每个 MonoBehaviour 上或此行为的每个父级上名为 methodName 的方法。
TryGetComponent获取指定类型的组件(如果存在)。

消息

OnCollisionEnter当该碰撞体/刚体已开始接触另一个刚体/碰撞体时,调用 OnCollisionEnter。
OnCollisionExit当该碰撞体/刚体已停止接触另一个刚体/碰撞体时,调用 OnCollisionExit。
OnCollisionStay对应正在接触刚体/碰撞体的每一个碰撞体/刚体,每帧调用一次 OnCollisionStay。
OnTriggerEnter GameObject 与另一个 GameObject 碰撞时,Unity 会调用 OnTriggerEnter。
OnTriggerExit当 Collider other 已停止接触该触发器时调用 OnTriggerExit。
OnTriggerStay对于正在接触该触发器的每个其他 Collider,“几乎”所有帧都调用 OnTriggerStay。此函数位于物理计时器上,因此它不必运行每个帧。