碰撞消息

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

事件过滤

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

• “生成碰撞事件”
• “生成接触事件”
• “生成触发器事件”

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

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

当使用 physics.set_listener() 时：

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

碰撞响应

当碰撞对象之一是”动态”、”运动学”或”静态”类型时，将发送 "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）。

other_group

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

own_group

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

function on_message(self, message_id, message, sender)
    -- 检查消息
    if message_id == hash("trigger_response") then
        if message.enter then
            -- 为进入采取行动
            print("I am now inside", message.other_id)
        else
            -- 为退出采取行动
            print("I am now outside", message.other_id)
        end
    end
end