PhysicsManager 类型

模块: cc 父模块: cc

物理系统将 box2d 作为内部物理系统，并且隐藏了大部分 box2d 实现细节（比如创建刚体，同步刚体信息到节点中等）。 你可以通过物理系统访问一些 box2d 常用的功能，比如点击测试，射线测试，设置测试信息等。 物理系统还管理碰撞信息的分发，她会在产生碰撞时，将碰撞信息分发到各个碰撞回调中。 注意：你需要先在刚体中开启碰撞接听才会产生相应的碰撞回调。

索引

属性（properties）

• DrawBits DrawBits 指定物理系统需要绘制哪些调试信息。
• PTM_RATIO Number 物理单位与像素单位互相转换的比率，一般是 32。
• VELOCITY_ITERATIONS Number 速度更新迭代数
• POSITION_ITERATIONS Number 位置迭代更新数
• FIXED_TIME_STEP Number 指定固定的物理更新间隔时间，需要开启 enabledAccumulator 才有效。
• MAX_ACCUMULATOR Number 每次可用于更新物理系统的最大时间，需要开启 enabledAccumulator 才有效。
• enabledAccumulator Boolean 如果开启此选项，那么将会以固定的间隔时间 FIXED_TIME_STEP 来更新物理引擎，如果一个 update 的间隔时间大于 FIXED_TIME_STEP，则会对物理引擎进行多次更新。
• enabled Boolean 指定是否启用物理系统？
• debugDrawFlags Number 设置调试绘制标志
• gravity Vec2 物理世界重力值

方法

• testPoint 获取包含给定世界坐标系点的碰撞体
• testAABB 获取与给定世界坐标系矩形相交的碰撞体
• rayCast 检测哪些碰撞体在给定射线的路径上，射线检测将忽略包含起始点的碰撞体。
• attachDebugDrawToCamera 将物理的调试绘制信息附加到指定摄像机上
• detachDebugDrawFromCamera 将物理的调试绘制信息从指定摄像机上移除
• on 注册事件目标的特定事件类型回调。
• off 删除之前用同类型，回调，目标或 useCapture 注册的事件监听器，如果只传递 type，将会删除 type 类型的所有事件监听器。
• targetOff 在当前 EventTarget 上删除指定目标（target 参数）注册的所有事件监听器。
• once 注册事件目标的特定事件类型回调，回调会在第一时间被触发后删除自身。
• dispatchEvent 分发事件到事件流中。
• emit 该对象直接发送事件， 这种方法不会对事件传播到任何其他对象。

Details

属性（properties）

DrawBits

指定物理系统需要绘制哪些调试信息。

示例

cc.director.getPhysicsManager().debugDrawFlags =
// cc.PhysicsManager.DrawBits.e_aabbBit |
// cc.PhysicsManager.DrawBits.e_pairBit |
// cc.PhysicsManager.DrawBits.e_centerOfMassBit |
cc.PhysicsManager.DrawBits.e_jointBit |
cc.PhysicsManager.DrawBits.e_shapeBit;

PTM_RATIO

物理单位与像素单位互相转换的比率，一般是 32。

VELOCITY_ITERATIONS

速度更新迭代数

POSITION_ITERATIONS

位置迭代更新数

FIXED_TIME_STEP

指定固定的物理更新间隔时间，需要开启 enabledAccumulator 才有效。

MAX_ACCUMULATOR

每次可用于更新物理系统的最大时间，需要开启 enabledAccumulator 才有效。

enabledAccumulator

如果开启此选项，那么将会以固定的间隔时间 FIXED_TIME_STEP 来更新物理引擎，如果一个 update 的间隔时间大于 FIXED_TIME_STEP，则会对物理引擎进行多次更新。 如果关闭此选项，那么将会根据设定的 frame rate 计算出一个间隔时间来更新物理引擎。

enabled

指定是否启用物理系统？

debugDrawFlags

设置调试绘制标志

示例

// enable all debug draw info
var Bits = cc.PhysicsManager.DrawBits;
cc.director.getPhysicsManager().debugDrawFlags = Bits.e_aabbBit |
Bits.e_pairBit |
Bits.e_centerOfMassBit |
Bits.e_jointBit |
Bits.e_shapeBit;

// disable debug draw info
cc.director.getPhysicsManager().debugDrawFlags = 0;

gravity

物理世界重力值

方法

testPoint

获取包含给定世界坐标系点的碰撞体

参数列表

• point Vec2 the world point

testAABB

获取与给定世界坐标系矩形相交的碰撞体

参数列表

• rect Rect the world rect

rayCast

检测哪些碰撞体在给定射线的路径上，射线检测将忽略包含起始点的碰撞体。

参数列表

• p1 Vec2 start point of the raycast
• p2 Vec2 end point of the raycast
• type RayCastType optional, default is RayCastType.Closest

attachDebugDrawToCamera

将物理的调试绘制信息附加到指定摄像机上

参数列表

• camera Camera

detachDebugDrawFromCamera

将物理的调试绘制信息从指定摄像机上移除

参数列表

• camera Camera

on

注册事件目标的特定事件类型回调。

参数列表

• type String A string representing the event type to listen for.
• callback Function The callback that will be invoked when the event is dispatched.

                         The callback is ignored if it is a duplicate (the callbacks are unique).
  

  • event Event event
• target Object The target (this object) to invoke the callback, can be null
• useCapture Boolean When set to true, the capture argument prevents callback

                         from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE.
                         When false, callback will NOT be invoked when event's eventPhase attribute value is CAPTURING_PHASE.
                         Either way, callback will be invoked when event's eventPhase attribute value is AT_TARGET.
  

示例

node.on(cc.Node.EventType.TOUCH_END, function (event) {
    cc.log("this is callback");
}, node);

off

删除之前用同类型，回调，目标或 useCapture 注册的事件监听器，如果只传递 type，将会删除 type 类型的所有事件监听器。

参数列表

• type String A string representing the event type being removed.
• callback Function The callback to remove.
• target Object The target (this object) to invoke the callback, if it's not given, only callback without target will be removed
• useCapture Boolean Specifies whether the callback being removed was registered as a capturing callback or not.

                         If not specified, useCapture defaults to false. If a callback was registered twice,
                         one with capture and one without, each must be removed separately. Removal of a capturing callback
                         does not affect a non-capturing version of the same listener, and vice versa.
  

示例

// register touchEnd eventListener
var touchEnd = node.on(cc.Node.EventType.TOUCH_END, function (event) {
    cc.log("this is callback");
}, node);
// remove touch end event listener
node.off(cc.Node.EventType.TOUCH_END, touchEnd, node);
// remove all touch end event listeners
node.off(cc.Node.EventType.TOUCH_END);

targetOff

在当前 EventTarget 上删除指定目标（target 参数）注册的所有事件监听器。 这个函数无法删除当前 EventTarget 的所有事件监听器，也无法删除 target 参数所注册的所有事件监听器。 这个函数只能删除 target 参数在当前 EventTarget 上注册的所有事件监听器。

参数列表

• target Object The target to be searched for all related listeners

once

注册事件目标的特定事件类型回调，回调会在第一时间被触发后删除自身。

参数列表

• type String A string representing the event type to listen for.
• callback Function The callback that will be invoked when the event is dispatched.

                         The callback is ignored if it is a duplicate (the callbacks are unique).
  

  • event Event event
• target Object The target (this object) to invoke the callback, can be null
• useCapture Boolean When set to true, the capture argument prevents callback

                         from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE.
                         When false, callback will NOT be invoked when event's eventPhase attribute value is CAPTURING_PHASE.
                         Either way, callback will be invoked when event's eventPhase attribute value is AT_TARGET.
  

示例

node.once(cc.Node.EventType.TOUCH_END, function (event) {
    cc.log("this is callback");
}, node);

dispatchEvent

分发事件到事件流中。

参数列表

• event Event The Event object that is dispatched into the event flow

emit

该对象直接发送事件， 这种方法不会对事件传播到任何其他对象。

参数列表

• message String the message to send
• detail Any whatever argument the message needs