Skip to main content

虚拟补间

虚拟补间随时间平滑动画化值（如浮点数或颜色），并将结果写入 UdonBehaviour 上的变量。每帧运行回调，以便您以任何方式应用更新的值。当内置补间类型（位置、旋转、缩放等）无法满足需求时使用虚拟补间。例如，动画化分数计数器、相机视野或动画器参数。

方法示例
TweenFloatVRCTween.TweenFloat(0f, 100f, 2f, this, nameof(myValue), nameof(OnUpdate), VRCTweenEase.Linear)
TweenIntVRCTween.TweenInt(0, 100, 5f, this, nameof(myValue), nameof(OnUpdate), VRCTweenEase.Linear)
TweenColorVRCTween.TweenColor(Color.red, Color.blue, 2f, this, nameof(myValue), nameof(OnUpdate), VRCTweenEase.Linear)
TweenVector3VRCTween.TweenVector3(Vector3.zero, Vector3.one, 2f, this, nameof(myValue), nameof(OnUpdate), VRCTweenEase.Linear)
DelayedCallVRCTween.DelayedCall(this, nameof(OnTimer), 5f)
DelayedSetActiveVRCTween.DelayedSetActive(myObject, false, 2f)

所有方法返回一个 VRCTweenHandle，你可以用它来控制补间。

TweenFloat​

动画化 float 值：

[System.NonSerialized] public float fovValue;

VRCTweenHandle tweenHandle = VRCTween.TweenFloat(60f, 90f, 2f, this, nameof(fovValue), nameof(OnFovUpdate), VRCTweenEase.OutQuad);

public void OnFovUpdate()
{
    myCamera.fieldOfView = fovValue;  // smoothly widens the camera's field of view
}

TweenInt​

动画化整数值。非常适合计数器和分数：

[System.NonSerialized] public int scoreValue;

VRCTweenHandle tweenHandle = VRCTween.TweenInt(0, 100, 5f, this, nameof(scoreValue), nameof(OnCountUpdate), VRCTweenEase.Linear);

public void OnCountUpdate()
{
    scoreText.text = scoreValue.ToString();  // updates scoreValue smoothly as it ticks up
}

TweenColor​

动画化 Color 值：

[System.NonSerialized] public Color lightColor;

VRCTweenHandle tweenHandle = VRCTween.TweenColor(Color.red, Color.blue, 2f, this, nameof(lightColor), nameof(OnColorUpdate), VRCTweenEase.Linear);

public void OnColorUpdate()
{
    myLight.color = lightColor;  // Value is stored in lightColor.
}

TweenVector3​

动画化 Vector3 值。这对于补间自定义位置、方向或任何三组件值作为单个单位很有用（缓动曲线应用于整个向量，而不是逐轴）：

[System.NonSerialized] public Vector3 targetPosition;

VRCTweenHandle tweenHandle = VRCTween.TweenVector3(Vector3.zero, new Vector3(5, 10, 0), 2f, this, nameof(targetPosition), nameof(OnPositionUpdate), VRCTweenEase.OutQuad);

public void OnPositionUpdate()
{
    // Use the interpolated value however you like.
    myParticleSystem.transform.position = targetPosition;
}
tip

变量必须声明为 public 才能与虚拟补间一起使用。使用 [System.NonSerialized] 防止 Unity 将临时补间值保存到场景中。你可以使用正确类型的变量（float、int、Color、Vector3），并通过使用不同的变量名称同时运行多个补间。

DelayedCall​

创建可取消的延迟事件。这是 SendCustomEventDelayedSeconds 的替代方案：

VRCTweenHandle timerHandle = VRCTween.DelayedCall(this, nameof(OnTimerFinished), 5.0f);

// Cancel the timer anytime.
timerHandle.Kill();

public void OnTimerFinished()
{
    Debug.Log("5 seconds elapsed!");
}

DelayedSetActive​

在延迟后启用或禁用 GameObject。这是使用 DelayedCall 并仅调用 SetActive 的回调的常见模式的简写。如果目标在延迟结束前被销毁，则该操作被静默跳过。

// Disable an object after 3 seconds.
VRCTweenHandle handle = VRCTween.DelayedSetActive(myObject, false, 3f);

// Cancel it if needed.
handle.Kill();