RaycastParams

射线与形状检测的过滤参数对象，它通过 FilterType 选择包含或排除策略，用 FilterDescendantsInstances 列出参与过滤的单位，还能借助 CollisionGroup 与 TargetCollisionGrou...

概览

射线与形状检测的过滤参数对象，它通过 FilterType 选择包含或排除策略，用 FilterDescendantsInstances 列出参与过滤的单位，还能借助 CollisionGroup 与 TargetCollisionGroupList 按碰撞组进一步收窄目标范围。

可通过 RaycastParams.New() 构造

代码示例

创建射线过滤参数

-- @runtime client
local params = RaycastParams.New()
params.FilterDescendantsInstances = {}
params.CollisionGroup = nil
print(params)

属性

名称	类型	默认值	说明
FilterType	Int	0	过滤模式：Exclude 排除列表中的实例，Include 仅检测列表中的实例。
FilterDescendantsInstances	Array	[]	RaycastParams 上用于保存参与过滤判定的 Unit 集合的属性，类型为 Array，默认值为空数组。该属性可编辑、非只读，作者可以读取当前列表，也可以整体替换为一个新的 Unit 数组。
CollisionGroup	String	-	用于按已配置碰撞关系过滤的碰撞组名称，不是只按 WorldUnit.CollisionGroup 字符串同名匹配；不设置（nil，Meta 默认值）表示不启用碰撞组过滤。
TargetCollisionGroupList	Array	[]	RaycastParams 的目标碰撞组列表属性，类型为 Array，默认值为空表，且可编辑。该属性用于在射线检测中指明所关注的目标碰撞组列表，是 RaycastParams 多项筛选配置之一。