Skip to content

BallSocketConstraint

球窝约束。需先通过 PrefabService:CreatePrefab("BallSocketConstraint") 创建预设,再通过 World:CreateAsset(预设ID) 创建单位,字段属性可直接读写。

概览

BallSocketConstraint 描述两个 Attachment 实例之间的球形关节;当前公开契约可通过 Attachment0/Attachment1 直接引用端点。

继承自 Unit;需通过预设资产与 World:CreateAsset(...) 创建,不能使用 BallSocketConstraint.New()

属性

名称类型默认值说明
EnabledBool-该属性控制球窝约束是否启用,关闭后约束将不参与物理计算。
Attachment0IdInt-该属性表示球窝约束的一端所关联的附件标识编号,用于在约束体系中标识连接对象。
Attachment1IdInt-该属性表示球窝约束的另一端所关联的附件标识编号,与一端标识共同确定约束的连接范围。
LimitsEnabledBool-该属性控制是否启用摆动角度限制,启用后约束的摆动范围将受角度上限约束。
UpperAngleFloat-该属性表示约束允许的最大摆动角度,单位为度,用于限制球窝连接的摆动范围。
TwistLimitsEnabledBool-该属性控制是否启用扭转角度限制,启用后约束的扭转范围将受最小和最大扭转角约束。
TwistLowerAngleFloat-该属性表示允许的最小扭转角度,单位为度,定义了扭转范围的下边界。
TwistUpperAngleFloat-该属性表示允许的最大扭转角度,单位为度,定义了扭转范围的上边界。
RestitutionFloat-该属性表示约束的弹性系数,取值范围为0到1,用于描述角度限制接触时的回弹特性。
MaxFrictionTorqueFloat-该属性用于保存最大摩擦扭矩数值,当前版本仅作为存储用途,不参与实际物理模拟。
RadiusFloat-该属性定义球窝约束的可视化半径,用于在编辑器中表示约束球体的大小。