Physics3DManager 类型

模块: cc 父模块: cc

物理系统管理器。

索引

属性（properties）

• enabled boolean 是否启用物理系统，默认不启用。
• allowSleep boolean 物理系统是否允许自动休眠，默认为 true。
• maxSubStep number 物理每帧模拟的最大子步数，默认为 2。
• deltaTime number 物理每步模拟消耗的固定时间，默认为 1/60 秒。
• useFixedTime boolean 是否使用固定的时间步长。
• gravity Vec3 物理世界的重力数值，默认为 (0, -10, 0)。
• defaultMaterial PhysicsMaterial | null 获取全局的默认物理材质，注意：builtin 时为 null。

方法

• update 执行一次物理系统的模拟，目前将在每帧自动执行一次。
• raycast 检测所有的碰撞盒，并返回所有被检测到的结果，若没有检测到，则返回空值。
• raycastClosest 检测所有的碰撞盒，并返回射线距离最短的检测结果，若没有，则返回空值。

Details

属性（properties）

enabled

是否启用物理系统，默认不启用。

allowSleep

物理系统是否允许自动休眠，默认为 true。

maxSubStep

物理每帧模拟的最大子步数，默认为 2。

deltaTime

物理每步模拟消耗的固定时间，默认为 1/60 秒。

useFixedTime

是否使用固定的时间步长。

gravity

物理世界的重力数值，默认为 (0, -10, 0)。

defaultMaterial

获取全局的默认物理材质，注意：builtin 时为 null。

方法

update

执行一次物理系统的模拟，目前将在每帧自动执行一次。

参数列表

• deltaTime number The time difference from the last execution is currently elapsed per frame

raycast

检测所有的碰撞盒，并返回所有被检测到的结果，若没有检测到，则返回空值。注意返回值是从对象池中取的，所以请不要保存结果引用或者修改结果。

参数列表

• worldRay Ray A ray in world space
• groupIndexOrName number | string Collision group index or group name
• maxDistance number Maximum detection distance
• queryTrigger boolean Detect trigger or not

raycastClosest

检测所有的碰撞盒，并返回射线距离最短的检测结果，若没有，则返回空值。注意返回值是从对象池中取的，所以请不要保存结果引用或者修改结果。

参数列表

• worldRay Ray A ray in world space
• groupIndexOrName number | string Collision group index or group name
• maxDistance number Maximum detection distance
• queryTrigger boolean Detect trigger or not