physics.removeBody()

类型 函数
库 physics.*
返回值 布尔值
修订 版本 2024.3703
关键词 physics, 物体, 物理体
另请参阅 physics.addBody()

概述

从显示对象中移除物理体，而不销毁整个对象。这将移除使用 physics.addBody() 创建的物体。

此 API 仅从 显示对象 中移除物理体 — 它不会移除显示对象本身。

如果物体被移除，此函数返回 true；如果调用失败，则返回 false。如果在任何碰撞事件侦听器中调用，API 将失败。

注意事项

此调用不能在碰撞事件中使用。但是，您的碰撞处理程序可以设置一个标志或通过 timer.performWithDelay() 包含一个时间延迟，以便该操作可以在下一个应用程序周期或之后发生。有关受此规则约束的 API 和方法的完整列表，请参阅 碰撞检测 指南。

语法

physics.removeBody( object )
object （必填）

显示对象。 要移除其物理体的对象。

示例

if not ( physics.removeBody( object ) ) then

    print( "Could not remove physics body" )

end