PhysicsService

方法

CollisionGroupSetCollidable(name1 : string,name2 : string,collidable : bool):void
2つのグループ間の衝突ステータスを設定します。
CollisionGroupsAreCollidable(name1 : string,name2 : string):bool
2つのグループが衝突するかどうかを返します。
GetMaxCollisionGroups():number
最大のコリジョングループを返します。
GetRegisteredCollisionGroups():Array
すべての場プレースの衝突グループに関する情報を含むテーブルを返します。
IsCollisionGroupRegistered(name : string):bool
衝突グループが登録されているかどうかをチェックします。
RegisterCollisionGroup(name : string):void
指定された名前で新しい衝突グループを登録します。
RenameCollisionGroup(from : string,to : string):void
指定された衝突グループを名前変更します。
UnregisterCollisionGroup(name : string):void
指定された名前の衝突グループを登録解除します。

イベント

プロパティ

方法

CollisionGroupSetCollidable

void

2つのグループ間の衝突ステータスを設定します。このメソッドは、グループの 1つが登録されていない場合にエラーが発生するため、PhysicsService:IsCollisionGroupRegistered() を通じて、各グループの登録を確認することをお勧めします。

パラメータ

name1: string

name2: string

collidable: bool

戻り値

void

CollisionGroupsAreCollidable

2つの指定された衝突グループが衝突するかどうかを返します。このメソッドは、デフォルトの衝突マスクがすべてのグループに対応するため、注册されていない場合も true を返します。

パラメータ

name1: string

name2: string

戻り値

GetMaxCollisionGroups

number

エンジンがサポートする最大のコリジョングループを返します。この値は現在 32 です。

戻り値

number

GetRegisteredCollisionGroups

Array

すべての場プレースのコリジョングループに関する情報を含むテーブルを返します。返されたテーブルの各値は、自体がテーブルであり、2つのメンバーを含しています：


<tbody>
  <tr>
    <td>マスク</td>
    <td>整数</td>
    <td>衝突グループのマスク; 内部のみ使用。</td>
  </tr>

  <tr>
    <td>名前</td>
    <td>文字列</td>
    <td>衝突グループの名前。</td>
  </tr>
</tbody>

メンバー	タイプ	説明

戻り値

Array

IsCollisionGroupRegistered

衝突グループが登録されているかどうかをチェックします。このメソッドを呼び出す前に、未登録の衝突グループに対するメソッドを呼び出すことをお勧めします、例えば PhysicsService:CollisionGroupSetCollidable() 。

パラメータ

戻り値

RegisterCollisionGroup

void

新しい衝突グループを登録します。名前は "Default" ではできません。

このメソッドは、ワークスペースの BaseParts の数に基づく軽微なパフォーマンスオーバーヘッドを持つため、Class.PhysicsService:UnregisterCollisionGroup()|UnregisterCollisionGroup() を通じてすべての衝突グルー

パラメータ

戻り値

void

コードサンプル

This example demonstrates one basic use of collision groups. It assigns BallPart to "CollisionGroupBall" and DoorPart to "CollisionGroupDoor", then makes the two groups non-collidable using PhysicsService:CollisionGroupSetCollidable().

PhysicsService:RegisterCollisionGroup

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

RenameCollisionGroup

void

指定された衝突グループを名前変更しますが、Class.BasePart.CollisionGroup|CollisionGroup のパーツの名前を変更しません。このメソッドの第1引数は、グループを名前変更するグループの

このメソッドは、次の場合にランタイムエラーをスローします:

どちらの引数にも無効な名前を提供しました。
メソッドはクライアントから呼び出されます。

このメソッドは、ワークスペースの BaseParts の数に基づく軽微なパフォーマンスオーバーヘッドを持つため、スタジオ編集器を介してすべてのコリジョングループを登録し、できるだけ頻繁に名前を変更することをお勧めします。

パラメータ

from: string

to: string

戻り値

void

UnregisterCollisionGroup

void

次の動作で、与えられた名前の衝突グループを登録解除します。

無効な名前が提供された場合、メソッドは何もしません。
予約名 "Default" が提供されている場合、またはメソッドがクライアントから呼び出されると、エラーが発生します。
コリジョングループに入っているパーツが削除されると、そのパーツはまだ同じコリジョングループ名を持ち続けます。物理的な動作は、"Default" など、パーツが削除されたグループに置くことを推奨します。グループを参照してください。

このメソッドは、ワークスペースの BaseParts の数に基づく軽微なパフォーマンスオーバーヘッドを持つため、スタジオ編集器を介してすべてのコリジョングループを登録することをお勧めします。このメソッドをできるだけ頻繁に呼び出すために Studio のエディタを通じてすべて

パラメータ

戻り値

void

イベント