Timeline: struggling with nuances of custom script clips

Timelines are an amazing tool, with lots of nuances to using them. I am trying to write a custom BasicPlayableBehaviour to animate scrolling numbers in a text field, and while for the most part it's working, I am struggling with some nuances. Would appreciate your help.

Here is the code:

Code (CSharp):

1. public class ScrollNumbersPlayable : BasicPlayableBehaviour {
2.   public ExposedReference<UnityEngine.UI.Text> text;
3.   public int startingNumber;
4.   public int endingNumber;
5.   private UnityEngine.UI.Text _text;
6.  
7.   public override void OnGraphStart(Playable playable) {
8.     _text = text.Resolve(playable.GetGraph().GetResolver());
9.   }            
10.  
11.   public override void ProcessFrame(Playable playable, FrameData info, object playerData) {
12.     if (playable.GetTime() < 0) {
13.       return;
14.     }
15.     double time = (playable.GetTime() / playable.GetDuration());
16.     double value = startingNumber * (1 - time) + endingNumber * time;
17.     _text.text = Math.Round(value).ToString();
18.   }
19. }

The problems:

1. The value of the text field on the last frame of the clip is wrong, because playable.GetTime() is always less than playable.GetDuration() even on the last frame. Somehow I need to know that the last frame is reached. How?
2. In the editor, whenever the playhead is positioned before the clip starts, I want the text field value to be set to startingNumber. And whenever the playhead is positioned after the clip ends, I want it to be set to endingNumber. How do I do this?

 

When I pause the timeline halfway the playable clip it is also in playback mode.
From what I see now there is no clear way to see if the clip has actually ended.
Why is there no onBehaviourStart amd onBehaviourEnd functions?

 

This is pretty annoying actually, either IsDone on the Playable should tell if the Playable is done playing or give us some sort of normalized time to tell if a Playable is finished playing. Throwing a mixer into things doesn't simplify the use of playables as it was originally meant to be.

I spent more than enough time today figuring out that double time = (playable.GetTime() / playable.GetDuration()); never gets to 1 or GetTime() never matches the GetDuration(). The simplest way would just to have a bool that tells us the Playable is done playing if it is not looping.

 

It seems that OnBehaviourPause gets called with different meanings, which is confusing:

• When the Timeline starts playing.
• When the Timeline is paused
• When the Playable ended.

Another option would be to implement an OnBehaviourEnd.

 

I am not even using a PlayableBehavior just a plain Playable, it should be a part of it really. If I can play an AnimationClip through a Playable and am able to set a time on a Playable I should be able to get some direct value from it to see where exactly it is playing from easily. Either stick with the convention of a normalizedTime like we have with the animation state, or GetTime() should be in compared with GetDuration() and should match when it is done playing.

This should all be as easy as it was originally touted a couple of years ago:

Code (CSharp):

1.  
2. PlayableGraph playableGraph;
3.  
4. myAnimationClipPlayable = Playables.AnimationPlayableUtilities.PlayClip(myAnimator, clip, out playableGraph);
5.  
6. myAnimationClipPlayable.SetSpeed(2f);
7.  
8. myAnimationClipPlayable.SetTime(0.5f);
9.  
10. var time = myAnimationClipPlayable.GetTime();
11.  
12. var normalizedTime = time / myAnimationClipPlayable.GetDuration();
13.  
14. if (normalizedTime >= 1f || time >= myAnimationClipPlayable.GetDuration() || myAnimationClipPlayable.IsDone()) {
15.     Debug.Log("Playable is finished playing.");
16. }

Also the Unity docs are really lagging behind, I am getting a lot of 404's as I go through to try to see what the API is for Playables and their tie ins with the Animator.

 

Hmm does GetDuration() calculate it differently? I will check that out and get back to you right away. I tried adding a deltaTime value to it, but then the animations after get messed up with part positioning.

 

Looks like it is better but my animations seem to not sync properly and some of the positions of are off and some game objects in the heirarchy are disabled when they should be enabled in the animations, is this because Playables do not benefit from the write default values of the State Machine?

Should probably update the Unity docs for the GetDuration() function and point it to the clip.length instead to get a proper value when playing from an animation clip. Why is it different from the clip anyway if I am only playing one at a time?

 

Thanks for the info, looks like I am stuck with mecanim for now, unless I want to key everything that needs to be enabled/disabled in every animation.

 

this was never made easier to deal with or at least the information is not easily accessible

 

Yes. I am running into the same problem. will this ever get fixed?

 

More than three years have passed, are there any results?
I don’t understand why Unity often spends several years unable to implement a simple small function?

 

To add a requirement on this thread (just noticed it). I would like to know its the last frame in processFrame() so I can render a progress bar at 100%. Not sure a separate "onBehaviorEnd()" would solve that or not. (I am going to cheat and subtract a small value from the duration as a workaround.). I freezeframe the last frame, so it's really obvious when the last frame still shows the progress bar at 99.8% but it's actually finished.

 

"OnBehaviourPause" works for me. But this is too ugly。