说明

碰撞检测，用来检查两个精灵是否接触。

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 方法需要两个参数：

示例：

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 方法创建碰撞反应。

参数：

注意：
如果你希望参数中第一个精灵碰撞到第二个精灵时反弹，那第一个精灵必须有速度属性，也就是 vx 和 vy 属性。

查看示例

movingCircleCollision

movingCircleCollision 方法可以让两个移动的圆形精灵在碰撞时弹开，它们会以一种非常逼真的方式将速度传递给对方，从而使它们弹开。

参数：

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 方法使矩形精灵表现得好像它们有质量。它可以防止参数中的两个矩形精灵重叠。

参数：

返回值：

如果精灵碰撞到了，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 方法可以检查圆形和矩形精灵之间的碰撞。

参数：

返回值：

如果精灵碰撞到了，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 方法让一个圆形精灵从矩形精灵的侧面或角反弹。

参数：

示例：

b.circleRectangleCollision(circle, rectangle, true);

查看示例

contain

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 — 补间动画

下一篇 学习 PixiJS — 交互工具