Skip to main content

Avatar 事件

这些事件允许 Udon 响应玩家 Avatar 的变化。

OnAvatarChanged​

返回引发事件的玩家的 VRCPlayerApi 对象。在玩家的 Avatar 加载完成时调用。

持久化眼睛高度​

玩家在 Avatar 加载后会同步其与预制体眼睛高度的任何差异，触发 OnAvatarEyeHeightChanged 事件。

如果 VRCPlayerApi 对象是针对本地玩家，在此事件期间获取其眼睛高度将返回预制体高度。

如果 VRCPlayerApi 对象是针对远程玩家，请注意远程玩家可能尚未同步其新的眼睛高度，在这种情况下您不应依赖返回的值。

OnAvatarEyeHeightChanged​

返回引发事件的玩家的 VRCPlayerApi 对象和一个 float，描述其之前或之前同步的眼睛高度（米）。当玩家通过切换到另一个 Avatar 或通过Avatar 缩放系统更改眼睛高度时调用。

首次 Avatar 加载​

当本地或远程用户加入世界时，收到的该用户的第一个先前眼睛高度值可能是 0。

Avatar 更改、远程玩家和事件顺序​

当本地用户更改其 Avatar 并应用持久化眼睛高度（如果保存了与预制体高度不同的值），此事件应仅针对其持久化高度执行。

当远程用户更改其 Avatar 并应用持久化眼睛高度（如果保存了与预制体眼睛高度不同的值），此事件可能执行多次。

对于远程玩家，每次远程玩家向您同步新的眼睛高度时，您都会收到此事件。这意味着您可能在 OnAvatarChanged 事件之前收到 OnAvatarEyeHeightChanged 事件，但您不应收到乱序的 OnAvatarEyeHeightChanged 事件。

More Info

有关此功能的更多信息，请参阅玩家 Avatar 缩放。