Tween cancellation using CancellationToken?

[Karabaev]

I would like to cancel Tween/Sequence using CancellationToken. Is there any way to do that?

[KyryloKuzyk]

Hey! There is currently no CancellationToken support in PrimeTween. Instead, PrimeTween offers a simple tween/sequence.Stop() method that can cancel animations, including those awaited with 'await'.

Can you please provide an example in which use cases you would like to use CancellationToken together with PrimeTween?

Similar threads:
#54
#46

[Karabaev]

Sorry for late reply.

I have a class AnimatedObject, which is attached to an animated element. It has one public method StartAnimationAsync, which starts the animation.

Also there is a class AnimatedObjectSpawner, which gets an instance of the AnimatedObject class (from a pool), and calls its StartAnimationAsync method. It waits for the completion and returns the instance to the pool. The AnimatedObjectSpawner class subscribes to a certain external event.
When this event occurs, it is necessary to interrupt the animation and return the object with the AnimatedObject class to the pool.

Example methods in AnimatedObjectSpawner:

void OnSomeEventRaised()
{
    _cts.Cancel();    
}

async UniTask SpawnAnimatedObject()
{
    AnimatedObject instance = pool.Get();
    await instance.StartAnimationAsync(_cts.Token);
    pool.Return(instance);
}

It would be possible to add an AnimatedObject.Interrupt method, which would wrap Tween.Stop. However, to call AnimatedObject.Interrupt, a reference to AnimatedObject would need to be stored in a field.

However, by code design, it would be better to pass a CancellationToken, as in the example above.

Hope I managed to provide you a clear example :)

[KyryloKuzyk]

Great example, thank you!

If the only async operation that happens inside SpawnAnimatedObject() is animation, then it should be possible to do something like this. Or do you want to combine multiple async operations under one CancellationTokenSource?

Tween/Sequence _animation;

void OnSomeEventRaised()
{
    _animation.Stop();
}

async UniTask SpawnAnimatedObject()
{
    AnimatedObject instance = pool.Get();
    _animation = instance.StartAnimation();
    await _animation;
    pool.Return(instance);
}