碰撞系统脚本控制

Cocos Creator 中内置了一个简单易用的碰撞检测系统,他会根据添加的碰撞组件进行碰撞检测。当一个碰撞组件被启用时,这个碰撞组件会被自动添加到碰撞检测系统中,并搜索能够与他进行碰撞的其他已添加的碰撞组件来生成一个碰撞对。需要注意的是,一个节点上的碰撞组件,无论如何都是不会相互进行碰撞检测的。

碰撞检测系统的使用

碰撞系统接口

获取碰撞检测系统

1. var manager = cc.director.getCollisionManager();

默认碰撞检测系统是禁用的,如果需要使用则需要以下方法开启碰撞检测系统

1. manager.enabled = true;

默认碰撞检测系统的 debug 绘制是禁用的,如果需要使用则需要以下方法开启 debug 绘制:

1. manager.enabledDebugDraw = true;

开启后在运行时可显示 碰撞组件 的 碰撞检测范围,如下图:

碰撞系统脚本控制 - 图1

如果还希望显示碰撞组件的包围盒,那么可以通过以下接口来进行设置:

1. manager.enabledDrawBoundingBox = true;

结果如下图所示:

碰撞系统脚本控制 - 图2

碰撞系统回调

当碰撞系统检测到有碰撞产生时,将会以回调的方式通知使用者,如果产生碰撞的碰撞组件依附的节点下挂的脚本中有实现以下函数,则会自动调用以下函数,并传入相关的参数。

1. /**
2. * 当碰撞产生的时候调用
3. * @param  {Collider} other 产生碰撞的另一个碰撞组件
4. * @param  {Collider} self  产生碰撞的自身的碰撞组件
5. */
6. onCollisionEnter: function (other, self) {
7. console.log('on collision enter');

9. // 碰撞系统会计算出碰撞组件在世界坐标系下的相关的值,并放到 world 这个属性里面
10. var world = self.world;

12. // 碰撞组件的 aabb 碰撞框
13. var aabb = world.aabb;

15. // 节点碰撞前上一帧 aabb 碰撞框的位置
16. var preAabb = world.preAabb;

18. // 碰撞框的世界矩阵
19. var t = world.transform;

21. // 以下属性为圆形碰撞组件特有属性
22. var r = world.radius;
23. var p = world.position;

25. // 以下属性为 矩形 和 多边形 碰撞组件特有属性
26. var ps = world.points;
27. },
1. /**
2. * 当碰撞产生后,碰撞结束前的情况下,每次计算碰撞结果后调用
3. * @param  {Collider} other 产生碰撞的另一个碰撞组件
4. * @param  {Collider} self  产生碰撞的自身的碰撞组件
5. */
6. onCollisionStay: function (other, self) {
7. console.log('on collision stay');
8. },
1. /**
2. * 当碰撞结束后调用
3. * @param  {Collider} other 产生碰撞的另一个碰撞组件
4. * @param  {Collider} self  产生碰撞的自身的碰撞组件
5. */
6. onCollisionExit: function (other, self) {
7. console.log('on collision exit');
8. }

点击测试

1. properties: {
2. collider: cc.BoxCollider
3. },

5. start () {
6. // 开启碰撞检测系统,未开启时无法检测
7. cc.director.getCollisionManager().enabled = true;
8. // cc.director.getCollisionManager().enabledDebugDraw = true;

10. this.collider.node.on(cc.Node.EventType.TOUCH_START, function (touch, event) {
11. // 返回世界坐标
12. let touchLoc = touch.getLocation();
13. // https://docs.cocos.com/creator/api/zh/classes/Intersection.html 检测辅助类
14. if (cc.Intersection.pointInPolygon(touchLoc, this.collider.world.points)) {
15. console.log("Hit!");
16. }
17. else {
18. console.log("No hit");
19. }
20. }, this);
21. }

更多的范例可以到 github 上查看。