碰撞检测

collision（碰撞）

对于常规碰撞检测，您应该监听名为 `“collision”`（参考） 的事件。`“collision”` 事件包含 `“began”`（开始）和 `“ended”`（结束）两个阶段，分别表示初始接触和接触断开的时刻。如果您没有实现 `“collision”` 监听器，则此事件不会触发。

preCollision（碰撞前）

`“preCollision”` 事件（参考）在对象开始交互之前立即触发。此事件通常与下文所述的 physicsContact（物理接触） 结合使用。

请注意，preCollision 事件非常“嘈杂”，每次接触可能会报告多次，从而可能影响性能。因此，只有在您真正需要碰撞前检测时，才应该监听这些事件。我们还建议您在感兴趣的对象上使用局部监听器，而不是全局监听物理世界中的所有 `“preCollision”` 事件。

postCollision（碰撞后）

`“postCollision”` 事件（参考）在对象交互之后立即触发。这是唯一报告碰撞力和摩擦力的事件。有关此主题的更多信息，请参阅下面的 碰撞力和摩擦力 部分。如果您没有实现 `“postCollision”` 监听器，则此事件不会触发。

与 `“preCollision”` 事件一样，postCollision 事件非常“嘈杂”，每次接触可能会报告多次，从而可能影响性能。因此，只有在您真正需要碰撞后检测时，才应该监听这些事件。我们还建议您在感兴趣的对象上使用局部监听器，而不是全局监听物理世界中的所有 `“postCollision”` 事件。

局部碰撞处理

局部碰撞处理最适合用于一对多碰撞场景，例如一个玩家对象可能与多个敌人碰撞，道具等。对于局部碰撞处理，每个碰撞事件都包含一个 `self` 表 ID，表示对象本身，以及 `event.other`，其中包含参与碰撞的另一个 Corona 显示对象的表 ID。由于 Corona 显示对象的行为类似于 Lua 表，您可以随意将任意数据添加到这些表中，例如名称、类别指示符、点值，甚至存储的函数，然后在碰撞时检索这些数据。例如，您可能希望以易于访问的字符串格式存储对象名称。

local crate1 = display.newImage( "crate.png" )
physics.addBody( crate1, { density=3.0, friction=0.5, bounce=0.3 } )
crate1.myName = "first crate"
 
local crate2 = display.newImage( "crate.png" )
physics.addBody( crate2, { density=3.0, friction=0.5, bounce=0.3 } )
crate2.myName = "second crate"
 
local function onLocalCollision( self, event )

    if ( event.phase == "began" ) then
        print( self.myName .. ": collision began with " .. event.other.myName )

    elseif ( event.phase == "ended" ) then
        print( self.myName .. ": collision ended with " .. event.other.myName )
    end
end

crate1.collision = onLocalCollision
crate1:addEventListener( "collision" )

crate2.collision = onLocalCollision
crate2:addEventListener( "collision" )

全局碰撞处理

全局碰撞处理最适合用于多对多碰撞场景，例如多个英雄角色可能与多个敌人碰撞。对于全局碰撞处理，每个碰撞事件都包含 `event.object1` 和 `event.object2`，它们指示对参与碰撞的两个对象的引用。同样，您可能希望以字符串格式存储每个对象的名称，并在碰撞事件期间检索它。

local crate1 = display.newImage( "crate.png", 100, 200 )
physics.addBody( crate1, { density = 1.0, friction = 0.3, bounce = 0.2 } )
crate1.myName = "first crate"

local crate2 = display.newImage( "crate.png", 100, 120 )
physics.addBody( crate2, { density = 1.0, friction = 0.3, bounce = 0.2 } )
crate2.myName = "second crate"

local function onGlobalCollision( event )

    if ( event.phase == "began" ) then
        print( "began: " .. event.object1.myName .. " and " .. event.object2.myName )

    elseif ( event.phase == "ended" ) then
        print( "ended: " .. event.object1.myName .. " and " .. event.object2.myName )
    end
end

Runtime:addEventListener( "collision", onGlobalCollision )

categoryBits/maskBits（类别位/掩码位）

此方法涉及通过“碰撞过滤器”定义将 categoryBits 和 maskBits 分配给您的对象，这是一个在 body 构造期间分配给 filter 键的可选表。一个对象仅在其 categoryBits 属于其分配的 maskBits 中时才会与其他对象发生碰撞。通常，一个对象只分配一个类别位，但可能有一个或多个掩码位，具体取决于它应该与哪些其他事物发生碰撞。

在下面的示例中，redCollisionFilter 的 maskBits 值为 3。此过滤器应用于 redSquare 对象，因此 redSquare 将仅与类别位为 1 或 2 的对象发生碰撞 — 在这种情况下，包括其他红色方块 (categoryBits=2) 和地板 (categoryBits=1)。同时，它将穿过任何蓝色方块 (categoryBits=4)，因为位 4 不包含在其 maskBits 值中。

local floorCollisionFilter = { categoryBits=1, maskBits=6 }  -- Floor collides only with 2 and 4
local redCollisionFilter = { categoryBits=2, maskBits=3 }    -- Red collides only with 1 and 2
local blueCollisionFilter = { categoryBits=4, maskBits=5 }   -- Blue collides only with 1 and 4

local floor = display.newRect( 0, 0, 320, 80 )
physics.addBody( floor, "static", { bounce=0.8, filter=floorCollisionFilter } )

local redSquare = display.newRect( 0, 80, 40, 40 )
redSquare:setFillColor( 1, 0, 0 )
physics.addBody( redSquare, { friction=0, filter=redCollisionFilter } )
 
local blueSquare = display.newRect( 80, 80, 40, 40 )
blueSquare:setFillColor( 0, 0, 1 )
physics.addBody( blueSquare, { friction=0, filter=blueCollisionFilter } )

碰撞过滤器工作表

可以使用简单的交叉参考工作表来计算碰撞过滤器值。考虑以下基于经典街机游戏“小行星”的示例，该游戏有四种基本对象类型可能会发生碰撞：玩家、小行星、外星人和玩家发射的子弹。

1. 观察最上一行的数字：以二进制递增的 1 到 512。这些“位”值是确定碰撞过滤器值的关键方面。对于复杂的游戏，您可以继续超过 512 — 必要时最多可达 32768（16 列） — 但对于大多数游戏来说，10 列就足够了。

2. 现在观察每种对象类型的行。由于每种对象类型必须有两个碰撞过滤器的值（categoryBits 和 maskBits），因此每行细分为类别和碰撞对象。

3. 对于游戏中的每种对象类型，从最上一行中选择一个位数，并在其关联的类别子行中标记一个带圆圈的 ⊗。此数字对于每种对象类型都应该是唯一的 — 请勿对多种对象类型使用相同的类别编号。

4. 接下来，确定每种对象类型是否可以与相同类型的其他对象发生碰撞。如果为 true，则在碰撞对象子行中标记一个带圆圈的 ⊗。在本例中，请注意小行星应与其他小行星碰撞，外星人应与其他外星人碰撞，但子弹不应与其他子弹碰撞。

5. 接下来，对于每种对象类型，检查其行上方和下方的所有其他对象类型。如果该对象类型应与任何其他对象类型发生碰撞，请在其他类型的碰撞对象子行中标记一个 x。记住将每个 x 保留在与您为对象类型选择的类别位值 (⊗) 相同的列中。

6. 请注意，碰撞过滤器以“反射”方式工作，您必须考虑所有关联的碰撞对象类型。例如，小行星和外星人应该与子弹碰撞，因此可能很容易在子弹碰撞对象行中为每个标记一个 x，然后停止该过程。但是，您还必须在小行星和外星人的子弹位数列中标记一个 x。如果您未能考虑这种关联中的对象类型，则碰撞过滤器将无法正常工作！

7. 当所有对象类型都完成后，逐行处理图表以确定总和列值。对于每个子行，将所有标记的总位值相加（求和）。例如，玩家碰撞对象子行在位列 2 和 4 中有一个 x，因此正确的总和值为 6。

8. 计算所有总和值后，只需将碰撞过滤器的 categoryBits 值设置为类别总和。同样，将过滤器的 maskBits 值设置为碰撞对象总和。例如，总和为 1 和 6 的玩家对象过滤器可以配置如下

local playerCollisionFilter = { categoryBits=1, maskBits=6 }

groupIndex（组索引）

另一种碰撞过滤方法是为每个对象分配一个 groupIndex。此值可以是正整数或负整数，它可能是指定碰撞规则的更简单方法。具有相同正 groupIndex 值的对象将始终相互碰撞，而具有相同负 groupIndex 值的对象将永远不会相互碰撞。

local greenCollisionFilter = { groupIndex = -2 }