PhysicsService

设置两个群组之间的碰撞状态。如果群组之一未注册，该方法将抛出错误，因此建议您在调用此方法之前确认每个群组的注册通过 PhysicsService:IsCollisionGroupRegistered() 。

参数

返回

返回两个指定碰撞组是否会碰撞。该方法还会返回真值，如果任何组未注册，默认碰撞面罩与所有组碰撞。

参数

返回

返回引擎支持的最大碰撞组数。目前值为 32。

返回

返回包含所有场景点碰撞组的表，每个值在返回的表中都是一个表，包含两个成员：

<th>类型</th>

    <th>描述</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td>面具</td>

    <td>整数</td>

    <td>碰撞群组的面具；仅供内部使用。</td>
  </tr>

  <tr>
    <td>名称</td>

    <td>字符串</td>

    <td>碰撞群组的名称。</td>
  </tr>
</tbody>

返回

检查是否注册了碰撞组。建议您在调用可能抛出错误的注册未注册碰撞组方法之前调用此方法，例如 PhysicsService:CollisionGroupSetCollidable() 。

参数

返回

注册一个新的碰撞组件与给定的名称。名称不能是 "Default" 。

请注意，该方法基于工作区中的 BaseParts 数量有轻微的性能提升，因此建议您在编辑时通过 Studio 编辑器 注册所有碰撞组，并尽可能少地调用 UnregisterCollisionGroup() 和 RenameCollisionGroup() 以实现最佳性能。

参数

返回

local PhysicsService = game:GetService("PhysicsService")

local collisionGroupBall = "CollisionGroupBall"
local collisionGroupDoor = "CollisionGroupDoor"

-- Register collision groups
PhysicsService:RegisterCollisionGroup(collisionGroupBall)
PhysicsService:RegisterCollisionGroup(collisionGroupDoor)

-- Assign parts to collision groups
script.Parent.BallPart.CollisionGroup = collisionGroupBall
script.Parent.DoorPart.CollisionGroup = collisionGroupDoor

-- Set groups as non-collidable with each other and check the result
PhysicsService:CollisionGroupSetCollidable(collisionGroupBall, collisionGroupDoor, false)
print(PhysicsService:CollisionGroupsAreCollidable(collisionGroupBall, collisionGroupDoor)) --> false

重命名指定的注册碰撞集团，但不会重命名使用该集团的零件的 属性 。该方法的第一个参数是要重命名的组的名称，第二个参数是组的新名称。如果指定的组不存在，该方法将无所作为。新名称的命名规则与如果群组使用 RegisterCollisionGroup() 被创建时相同。

在以下情况下，该方法将在运行时发生错误：

• 为任何参数提供的名称无效或为空。
• 方法从客户端调用。

请注意，该方法基于工作区中的 BaseParts 数量有轻微的性能提升，因此建议您在编辑时通过 Studio 编辑器 注册所有碰撞组，并尽可能多地重命名它们。

参数

返回

为给定名称注册冲突组时，具有以下行为：

• 如果提供了无效名称，方法将无所作为。
• 如果保留名称 "Default" 被提供 或 如果方法从客户端调用，它将抛出错误。
• 如果在移除碰撞组时，其中的任何部分仍保留相同的碰撞组名称，那些部分仍将保留相同的碰撞组名称。移除组中零件的物理行为未定义，因此建议将移除组中的任何零件移至另一个群组，例如 "Default" 群组。

请注意，该方法基于工作区中的 BaseParts 数量有轻微的性能提升，因此建议您在编辑时通过 Studio 编辑器 注册所有碰撞组，并尽可能少地调用此方法。

参数

返回