object.isBodyActive

类型 布尔值
对象 Body
physics.*
版本 版本 2024.3703
关键词 body, isBodyActive
另请参阅 object.isAwake

概述

用于设置或获取 body 的当前活动状态。非活动 body 不会被销毁,但会从物理模拟中移除,并停止与其他 body 的交互。

注意事项

如果此属性在当前与另一个对象处于碰撞状态的活动对象上设置为 false,则会立即触发阶段为 "ended" 的碰撞。同样,如果此属性在当前与另一个对象处于碰撞状态的非活动对象上设置为 true,则会立即触发阶段为 "began" 的碰撞。

示例

-- Create a rectangle
local myRect = display.newRect( 0, 0, 100, 100 )

-- Add a body to the rectangle
physics.addBody( myRect, "dynamic" )

-- Set the rectangle's active state
myRect.isBodyActive = false