乐趣区

学习 PixiJS — 碰撞检测

说明
碰撞检测,用来检查两个精灵是否接触。
Pixi 没有内置的碰撞检测系统,所以这里我们使用一个名为 Bump 的库,Bump 是一个易于使用的 2D 碰撞方法的轻量级库,可与 Pixi 渲染引擎一起使用。它提供了制作大多数 2D 动作游戏所需的所有碰撞工具。
使用 Bump 库
要开始使用 Bump,首先直接用 script 标签,引入 js 文件
<script src=”https://www.kkkk1000.com/js/bump.js”></script>
然后创建它的实例
let b = new Bump(PIXI);
变量 b 现在代表 Bump 实例。可以使用它来访问 Bump 的所有碰撞方法。
使用 Bump 的碰撞方法
hit
hit 方法是一种通用碰撞检测功能。它会自动检测碰撞中使用的精灵种类,并选择适当的碰撞方法。这意味着你不必记住要使用 Bump 库中的许多碰撞方法的哪一个,你只需要记住一个 hit。但是为了避免 hit 方法最后产生的效果和你想象的不一样,最好还是要了解一下 Bump 库中其他的方法。
以下是 hit 方法最简单的使用形式:
b.hit(sprite1, sprite2);
如果两个精灵碰撞到了,就返回 true,没有碰撞到,则返回 false。
查看示例
在碰撞检测时,Bump 的方法默认精灵是矩形的,使用矩形碰撞检测的算法,如果你想让方法把一个精灵当做圆形,使用圆形碰撞检测的算法,需要将精灵的 circular 属性设置为 true。
anySprite.circular = true;
如果你使用 hit 方法检测两个圆形精灵是否碰撞,你还需要将两个精灵的 diameter 属性设置为 true。
查看示例
如果你希望精灵对碰撞作出反应,使它们不重叠,请将第三个参数设置为 true。
b.hit(sprite1, sprite2, true);
这个防止重叠的功能,对于制作墙壁,地板或任何其他类型的边界非常有用。
查看示例
如果你想让精灵碰撞后反弹,请将第四个参数设置为 true。
b.hit(sprite1, sprite2, true, true);
注意:如果需要精灵反弹,精灵还必须有速度属性,也就是 vx 和 vy 属性。
查看示例
设置第五个参数为 true 使 hit 方法使用精灵的全局坐标。在检测不同父容器的精灵之间的碰撞时,这很有用。
b.hit(sprite1, sprite2, true, true, true);
精灵的全局坐标是相对于画布左上角的位置。精灵的局部坐标是相对于其父容器的左上角的位置。
如果要检查点对象是否与精灵碰撞,将点对象作为第一个参数,如下所示:
b.hit({x: 200, y:120}, sprite);
点对象是一个具有 x 和 y 两个属性的对象,x 和 y 表示了画布中一个点的坐标。
查看示例
hit 方法还允许你检查精灵和精灵组之间的碰撞。只需将精灵组作为第二个参数即可。在此示例中,精灵组是 spriteArray。
b.hit(sprite, spriteArray, true, true, true);
你将看到 hit 方法自动遍历精灵组中的所有精灵,并根据参数中的第一个精灵检测它们。这意味着你不必自己编写 for 循环或 forEach 循环。
查看示例
你还可以使用回调函数作为第六个参数。这对于检查单个精灵和精灵组之间的碰撞特别有用。如果发生碰撞,回调函数将运行,你可以访问碰撞返回值和碰撞中涉及的精灵。下面是如何使用这个特性来检测一个名为 sprite 的精灵和一个名为 spriteArray 的精灵组之间的碰撞。
b.hit(
sprite,
spriteArray,
true, true, true,
function (collision, platform) {
//collision 表示 sprite 的哪一边发生碰撞
//platform 表示 sprite 正在碰撞的精灵组中的精灵
console.log(collision);
console.log(platform);
}
);
这是一种执行复杂碰撞检测的简洁方式,可以为你提供大量信息和低级控制,但不必手动遍历数组中的所有精灵。
查看示例
hit 方法的返回值会与你正在检查的精灵的种类相匹配。例如,如果两个精灵都是矩形,并且 hit 方法的第三个参数是 true,碰撞后,返回值表示参数中第一个矩形发生碰撞的一侧,如果没有发生碰撞,返回值就是 undefined。
示例:
let collision = b.hit(rectangleOne, rectangleTwo, true);
message.text = “ 参数中第一个矩形的碰撞侧是: ” + collision;
查看示例
hit 方法只是 Bump 的许多低级碰撞方法的高级包装器。如果你更喜欢使用较低级别的方法,接下来会列出所有的这些方法。
hitTestPoint
最基本的碰撞检测是检查点对象是否与精灵碰撞。hitTestPoint 方法将帮助你解决这个问题。hitTestPoint 方法需要两个参数:

名称
描述

point
具有 x 和 y 属性的点对象,x 和 y 表示了画布中一个点的坐标

sprite
精灵

示例:
let collision = b.hitTestPoint(
{x: 180, y: 128}, // 具有 x 和 y 属性的点对象
sprite // 需要检测的精灵
)
如果点对象与精灵碰撞,hitTestPoint 方法返回 true,否则返回 false。
查看示例
上面示例中的精灵被当作是矩形的,但 hitTestPoint 方法同样适用于圆形精灵。如果精灵具有 radius 属性,则 hitTestPoint 方法假定精灵是圆形的并且对它应用圆形碰撞检测算法。如果精灵没有 radius 属性,则该方法假定它是矩形。你可以给任何精灵一个 radius 属性。而一个更简单的方法是给精灵一个 circular 属性并将其设置为 true。
anySprite.circular = true;
这样精灵就会应用圆形碰撞检测算法,并具有一个 radius 属性,该属性的值等于精灵宽度的一半。
查看示例
hitTestCircle
hitTestCircle 方法用来检测两个圆形精灵之间的碰撞。
b.hitTestCircle(sprite1,sprite2)
作为参数传入 hitTestCircle 方法的精灵需要有 radius 属性,如果精灵碰撞则返回 true,因此你可以将其与 if 语句一起使用来检测碰撞,如下所示:
if(b.hitTestCircle(sprite1,sprite2)){
message.text = “ 碰撞到了!”;
// 碰撞到后,将 vx 设置为 0,停止移动
sprite1.vx=0;
}
查看示例
circleCollision
当移动的圆形精灵碰到没有移动的圆形精灵时,你可以使用 circleCollision 方法创建碰撞反应。
参数:

名称
默认值
描述

circle1

移动的圆形精灵

circle2

没有移动的圆形精灵

bounce
false
用于确定第一个精灵碰撞到第二个精灵时是否应该反弹

global
false
是否使用精灵的全局坐标。如果要检测具有不同父容器的精灵之间的碰撞,这很有用

注意:如果你希望参数中第一个精灵碰撞到第二个精灵时反弹,那第一个精灵必须有速度属性,也就是 vx 和 vy 属性。
查看示例
movingCircleCollision
movingCircleCollision 方法可以让两个移动的圆形精灵在碰撞时弹开,它们会以一种非常逼真的方式将速度传递给对方,从而使它们弹开。
参数:

名称
默认值
描述

circle1

移动的圆形精灵

circle2

移动的圆形精灵

global
false
是否使用精灵的全局坐标。如果要检测具有不同父容器的精灵之间的碰撞,

b.movingCircleCollision(circle1, circle2)
如果圆形精灵具有 mass 属性,则该值将用于帮助确定圆形精灵应该相互反弹的力。
查看示例
如果你有一堆移动的圆形精灵,你希望这些精灵都在碰撞后进行反弹,这个时候你需要把这些精灵进行两两检查,判断它们是否碰撞,这需要把这些精灵放在一个数组中,使用两层 for 循环,并且内层 for 循环的计数器比外层的 for 循环大 1,这样就可以检测所有圆形精灵的碰撞情况。
for (let i = 0; i < container.children.length; i++) {
// 碰撞检查中使用的第一个圆形精灵
var c1 = container.children[i];
for (let j = i + 1; j < container.children.length; j++) {
// 碰撞检查中使用的第二个圆形精灵
let c2 = container.children[j];
// 检查碰撞情况,如果精灵发生碰撞,将精灵弹开
b.movingCircleCollision(c1, c2);
}
}
你可以看到内层 for 循环的计数器开始就是一个大于外层 for 循环的数字:
let j = i + 1
这可以防止对任何一对精灵进行多次碰撞检测。
Bump 库还有一个方便的方法 multipleCircleCollision,使用这个方法可以替代 for 循环的方式。这个方法会对每对精灵自动调用 movingCircleCollision,使它们互相反弹。你可以在游戏循环中使用它来检查数组中的所有精灵,但是要注意数组中的精灵是不能重复的。
示例:
b.multipleCircleCollision(container.children);
查看示例
hitTestRectangle
要确定两个矩形精灵是否碰撞,请使用 hitTestRectangle 方法:
b.hitTestRectangle(rectangle1, rectangle2)
如果矩形精灵碰撞,hitTestRectangletrue 方法返回 true,没有碰撞则返回 false。
示例:
if(b.hitTestRectangle(sprite1,sprite2)){
message.text = “ 碰撞到了!”;
}else{
message.text = “ 没有碰到 ”;
}
查看示例
rectangleCollision
rectangleCollision 方法使矩形精灵表现得好像它们有质量。它可以防止参数中的两个矩形精灵重叠。
参数:

名称
默认值
描述

rectangle1

矩形精灵

rectangle2

矩形精灵

bounce
false
用于确定第一个精灵是否应该从第二个精灵反弹

global
true
是否使用精灵的全局坐标

返回值:
如果精灵碰撞到了,rectangleCollision 方法返回一个字符串值,告诉你第一个矩形精灵的哪一侧碰到了第二个矩形精灵。其值可能是 left,right,top 或 bottom。如果没有碰撞到返回值就是 undefined。
示例:
let collision = b.rectangleCollision(sprite2, sprite1);

// 碰撞发生在矩形 1(第一个参数)的哪一侧
switch (collision) {
case “left”:
message.text = “ 参数中的第一个精灵的 左侧 发生碰撞 ”;
break;
case “right”:
message.text = “ 参数中的第一个精灵的 右侧 发生碰撞 ”;
break;
case “top”:
message.text = “ 参数中的第一个精灵的 上方 发生碰撞 ”;
break;
case “bottom”:
message.text = “ 参数中的第一个精灵的 下方 发生碰撞 ”;
break;
default:
message.text = “ 没有发生碰撞 ”;
}
此示例代码将阻止矩形重叠,并在名为 message 的文本精灵中显示碰撞侧。
rectangleCollision 方法具有非常有用的副作用。参数中的第二个精灵能够将第一个精灵推走。如果你需要类似于推箱子游戏中的那种功能,这会很有用。
查看示例
hitTestCircleRectangle
hitTestCircleRectangle 方法可以检查圆形和矩形精灵之间的碰撞。
参数:

名称
默认值
描述

circle

圆形精灵

rectangle

矩形精灵

global
false
是否使用精灵的全局坐标

返回值:
如果精灵碰撞到了,hitTestCircleRectangle 方法同样返回一个字符串值,告诉你圆形精灵在哪里碰到了矩形精灵。其值可能是 topLeft,topMiddle,topRight,leftMiddle,rightMiddle,bottomLeft,bottomMiddle 或 bottomRight。如果没有碰撞到返回值就是 undefined。
示例:
let collision = b.hitTestCircleRectangle(circle, rectangle);
if (collision) {
message.text = “ 圆形精灵的 ” + collision + ” 侧,发生碰撞 ”;
} else {
message.text = “ 没有发生碰撞 ”;
}
查看示例
circleRectangleCollision
使用 circleRectangleCollision 方法让一个圆形精灵从矩形精灵的侧面或角反弹。
参数:

名称
默认值
描述

circle

圆形精灵

rectangle

矩形精灵

bounce
false
是否使使精灵反弹

global
false
是否使用精灵的全局坐标

示例:
b.circleRectangleCollision(circle, rectangle, true);
查看示例
contain
contain 方法可以将精灵限制在一定矩形区域内。
参数:

名称
默认值
描述

sprite

精灵

container

容器,这是一个对象,具有 x、y、width 和 height 属性,表示一个矩形区域。

bounce
false
确定精灵在碰到容器边界时是否应该反弹。

callbackFunction

回调函数,当精灵碰撞到容器边界时会调用它,并且会将 contain 方法的返回值作为参数传入这个回调函数。

返回值:
如果精灵碰撞到容器边界,contain 方法将返回一个 Set 对象,告诉你精灵撞到了哪一侧,它的值可能有 left,right,top 或 bottom,如果精灵没有碰撞到容器边界,返回值就是 undefined。
示例:
let collision = b.contain(sprite, { x: 0, y: 0, width: 512, height: 512}, true, callbackFunction);

// 发生碰撞时的回调函数
function callbackFunction(collision) {
console.log(“collision”, collision);
}

// 如果发生碰撞,显示哪边的边界发生碰撞
if (collision) {
if (collision.has(“left”)) {
message.text = “ 边界 左侧 发生碰撞 ”;
};
if (collision.has(“right”)) {
message.text = “ 边界 右侧 发生碰撞 ”;
};
if (collision.has(“top”)) {
message.text = “ 边界 上方 发生碰撞 ”;
};
if (collision.has(“bottom”)) {
message.text = “ 边界 下方 发生碰撞 ”;
};
}
上面的代码会将精灵限制在对象定义的 512 x 512 像素区域内。如果精灵碰撞到容器的边界,它将会反弹,并且显示碰到了哪边的边界,callbackFunction(第四个参数)也将运行。
查看示例
contain 方法的另一个特点是,如果精灵具有 mass 属性,该值将用于以非常自然的方式抑制精灵的反弹。
注意:
使用 Bump 库时,最好给精灵设置上速度属性(vx,vy),因为 Bump 库中许多方法实现效果时,都需要用到这个两个属性。
上一篇 学习 PixiJS — 补间动画

退出移动版