Skip to main content

选读:Parameter Driver 概述

该选读部分由 AI 于受监督的环境下协助完成

如欲了解更多,可参考 Animator Parameters | VRChat Creation

 

Parameter Driver 概述


Parameter Driver 是一种用于修改 Avatar 动画控制器中参数的行为。该行为可以在进入状态时对参数进行多种操作,并且这些操作按从上到下的顺序依次完成。需要注意的是,只有在 VRCExpressionParameter 对象中定义的参数才会在网络中同步。

 
参数操作类型

Avatar Parameter Driver 支持多种参数操作类型,包括 Set、Add、Random 和 Copy。以下是每种操作类型的详细说明:


Set

功能:将指定的值设置为目标参数。
用法:选择操作类型为 Set,指定目标参数和要设置的值。


Add

功能:将指定的值添加到目标参数。
用法:选择操作类型为 Add,指定目标参数和要添加的值。
注意:使用 Add 操作时,建议仅在本地运行,将参数设置为同步,以确保远端的结果一致。


Random

功能:将目标参数设置为介于最小值和最大值之间的随机数。
用法:选择操作类型为 Random,指定目标参数、最小值和最大值。
注意:使用 Random 操作时,建议仅在本地运行,并将参数设置为同步,以确保远端的结果一致。


Copy

功能:将源参数的值复制到目标参数。
用法:选择操作类型为 Copy,指定源参数和目标参数。

  • Source(源参数):这是要复制其值的参数。源参数可以是任何自行定义的参数,但 VRChat 的内置参数(如 GestureLeftWeight)不能作为源参数使用。
  • Destination(目标参数):这是将接收源参数值的参数。目标参数必须存在于VRC Expression Parameter列表中,以确保其能够在网络中同步。

尽管你不能直接 Copy VRChat的内置参数,但你依然可以使用例如 BlendTree 或准备一个 Parameter 映射层等办法驱动另一个参数,由此来间接得到 VRChat 的内置参数

尽管官方文档称必须存在于同步参数表中,但即便目标参数不存在于参数同步表中,你依然可以使用 Parameter Driver 来驱动它,只是该变化仅会在本地生效

 
参数范围限制

对于同步的参数,值会被限制在特定范围内:整数参数的范围为 [0, 255],浮点数参数的范围为 [-1, 1]。这些限制确保了参数在网络同步时的稳定性和一致性。

 
Local Only

启用 "Local Only" 选项将使驱动程序仅在本地操作,而不进行网络同步。这是一个快捷的方法,避免了使用 IsLocal 的繁琐步骤。

 
Debug String

每个 Avatar Parameter Driver 操作都可以包含一个调试字符串,当该行为运行时,该字符串将被打印到输出日志中,便于调试和问题排查。