title: Defold 中的碰撞消息

brief: 当两个对象碰撞时，引擎将调用事件回调或广播消息。

碰撞消息

当两个对象碰撞时，引擎将向事件回调发送事件或向两个对象广播消息。

事件过滤

可以使用每个对象的标志来控制生成的事件类型：

"生成碰撞事件"
"生成接触事件"
"生成触发器事件"

这些默认情况下都为 true。当两个碰撞对象交互时，我们会根据这些复选框检查是否应该向用户发送消息。

例如，给定"生成接触事件"复选框：

当使用 physics.set_listener() 时：

组件 A	组件 B	发送消息
✅︎	✅︎	是
❌	✅︎	是
✅︎	❌	是
❌	❌	否

当使用默认消息处理程序时：

组件 A	组件 B	发送消息
✅︎	✅︎	是 (A,B) + (B,A)
❌	✅︎	是 (B,A)
✅︎	❌	是 (A,B)
❌	❌	否

碰撞响应

当碰撞对象之一是"动态"、"运动学"或"静态"类型时，将发送 "collision_response" 消息。它设置了以下字段：

other_id : 碰撞对象碰撞到的实例的ID（hash）

other_position : 碰撞对象碰撞到的实例的世界位置（vector3）

other_group : 另一个碰撞对象的碰撞组（hash）

own_group : 碰撞对象的碰撞组（hash）

碰撞响应消息仅适用于您不需要对象实际相交细节的碰撞情况，例如，如果您想检测子弹是否击中敌人。对于任何碰撞对象对，每帧只发送一条这样的消息。

function on_message(self, message_id, message, sender)
    -- 检查消息
    if message_id == hash("collision_response") then
        -- 采取行动
        print("I collided with", message.other_id)
    end
end

接触点响应

当碰撞对象之一是"动态"或"运动学"类型，而另一个是"动态"、"运动学"或"静态"类型时，将发送 "contact_point_response" 消息。它设置了以下字段：

position : 接触点的世界位置（vector3）。

normal : 接触点在世界空间中的法线，从另一个对象指向当前对象（vector3）。

relative_velocity : 从另一个对象观察到的碰撞对象的相对速度（vector3）。

distance : 对象之间的穿透距离——非负数（number）。

applied_impulse : 接触产生的冲量（number）。

life_time : （*目前未使用！*）接触的生命周期（number）。

mass : 当前碰撞对象的质量，以千克为单位（number）。

other_mass : 另一个碰撞对象的质量，以千克为单位（number）。

other_id : 碰撞对象接触到的实例的ID（hash）。

other_position : 另一个碰撞对象的世界位置（vector3）。

other_group : 另一个碰撞对象的碰撞组（hash）。

own_group : 碰撞对象的碰撞组（hash）。

对于需要完美分离对象的游戏或应用程序，"contact_point_response" 消息为您提供了您需要的所有信息。但是，请注意，对于任何给定的碰撞对，每帧可能会收到多个 "contact_point_response" 消息，这取决于碰撞的性质。有关更多信息，请参阅解决碰撞。

function on_message(self, message_id, message, sender)
    -- 检查消息
    if message_id == hash("contact_point_response") then
        -- 采取行动
        if message.other_mass > 10 then
            print("I collided with something weighing more than 10 kilos!")
        end
    end
end

触发器响应

当碰撞对象之一是"触发器"类型时，将发送 "trigger_response" 消息。当首次检测到碰撞时将发送一次消息，然后当对象不再碰撞时再发送一次。它具有以下字段：

other_id : 碰撞对象碰撞到的实例的ID（hash）。

enter : 如果交互是进入触发器则为 true，如果是退出则为 false。（boolean）。