UIEffect项目中PlayOnEnable反向播放失效问题解析

在UIEffect项目的5.5.1版本中，开发者发现了一个关于UIEffectTweener组件的重要功能缺陷。当PlayOnEnable属性启用且设置为反向播放(Reverse)模式，同时WarpMode设置为单次(Once)时，重新激活游戏对象后动画无法正常播放。

问题根源分析

经过深入代码审查，发现问题出在ResetTime方法的实现上。该方法原本只是简单地将时间设置为0，而没有考虑播放方向的因素。具体表现为：

public void ResetTime()
{
    SetTime(0); // 无论正向还是反向播放，都强制设置为0
}

这种实现方式导致了一个关键问题：当设置为反向播放时，动画的初始速率(rate)被错误地设置为0，而不是预期的1。这使得反向播放功能完全失效，因为动画系统无法正确初始化反向播放状态。

解决方案实现

正确的做法应该是在重置时间时考虑当前的播放方向。对于正向播放，时间应设为0；而对于反向播放，时间应设为1（或总时长）。修正后的代码如下：

public void ResetTime()
{
    SetTime(direction == Direction.Forward ? 0 : 1);
}

这个修改确保了无论正向还是反向播放，动画都能正确初始化其播放状态。对于反向播放，系统会从动画的结束位置开始播放，实现了真正的反向效果。

编辑器集成问题

在问题修复过程中，还发现了相关的编辑器工具问题。UIEffectTweenerEditor.cs中的"Reset Time"按钮也存在同样的逻辑缺陷。修正方案同样需要考虑播放方向：

private void DrawPlayer(UIEffectTweener tweener)
{
    // ...
    if (GUI.Button(rResetTimeButton, EditorGUIUtility.IconContent("animation.firstkey"), "IconButton"))
    {
        SetTime(tweener.direction == UIEffectTweener.Direction.Forward ? 0 : tweener.totalTime);
    }
    // ...
}

技术影响

这个修复对于依赖UIEffect动画系统的项目尤为重要，特别是那些需要精确控制动画播放方向的应用场景。在以下情况下特别关键：

1. 需要循环切换正反向播放的动画效果
2. 依赖于对象激活/禁用触发的动画序列
3. 需要精确控制动画初始状态的设计

该修复已在UIEffect 5.5.2版本中发布，确保了动画系统在各种播放模式下的行为一致性。开发者在使用反向播放功能时，现在可以预期获得稳定可靠的表现。