Physics3DManager 类型

模块: cc 父模块: cc

物理系统管理器。

索引

属性（properties）

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

方法

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

Details

属性（properties）

enabled

获取或设置是否启用物理系统，默认不启用。

allowSleep

获取或设置物理系统是否允许自动休眠，默认为 true

maxSubStep

获取或设置每帧模拟的最大子步数。

deltaTime

获取或设置每步模拟消耗的固定时间。

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