Skip to content

TriggerCallbackInfo ​

概览 ​

字段值
KindData · 数据 Data
Realmcommon

TriggerCallbackInfo 是 TriggerUnit 本地触发事件传入的回调数据,公开提供 OtherUnit,用于标识进入或离开触发区域的另一方单位。该类型不可直接构造。

适用场景 ​

监听 TriggerUnit 的 OnLocalTriggerEnter、OnLocalTriggerExit 时,从 info.OtherUnit 读取触发交互的另一方,并据此执行本地表现或判定逻辑。

使用要点 ​

在 OnLocalTriggerEnter/OnLocalTriggerExit 的回调中接收 info 并读取 info.OtherUnit。若后续逻辑需要名称等信息,应在对象仍可安全访问时缓存;退出事件可能因另一方提前销毁而补发。

注意事项 ​

该类型只能由 TriggerUnit 的本地触发事件提供,不能主动创建。公开契约未声明 OtherUnit 可空;不要自行扩写可空语义。OnLocalTriggerExit 在另一方提前销毁时也可能补发,因此回调中不要假定对方对象仍可执行依赖存活状态的操作。

属性 (1) ​

Name类型默认值说明
OtherUnitUnit-OtherUnit 是 TriggerCallbackInfo 上的一个属性,类型为 Unit,表示本次触发事件中与触发体发生交互的另一方单位。当 TriggerUnit 的触发事件被触发时,回调会提供 TriggerCallbackInfo,通过读取该属性即可拿到对方单位对象。