1️⃣ You're browsing the documentation for version 1.X. If you want to check version 2.X instead, please go here. 1️⃣


Writing Custom Actions (C#)

You can create your own Custom Actions via script (C#).

(Do not forget to read here: Performing Actions while typing )


How to create custom actions

1. Registering custom action IDs

In order to tell TextAnimator which tags are custom actions, you need to add them in the “Custom Actions” array (located in the TextAnimator’s GlobalData Scriptable Object asset).

P.S. In case you don’t have a GlobalData Scriptable Object, please read here how to create it.

In this example, I’m setting “playAudio” as a custom action.

tanimator customaction example audio

2. Processing actions in a custom typewriter

Your Custom Actions can be performed by a custom typewriter:

  1. Create a new typewriter class (Read more here).
  2. Override the DoCustomAction method (do not invoke the base method).
  3. Perform specific actions based on the given “actionID” and use any parameter as you wish.
  4. Add your new custom typewriter near a TextAnimator component, instead of the default “TextAnimatorPlayer”.

Example script

using System.Collections;

//custom typewriter class
public class CustomTAnimPlayer : Febucci.UI.TextAnimatorPlayer
{
    protected override IEnumerator DoCustomAction(Febucci.UI.TypewriterAction action)
    {
        switch (action.actionID)
        {
            case "playAudio": //example: an action that plays given sounds
                for(int i = 0; i < action.parameters.Count; i++)
                {
                    AudioManager.PlaySoundFromID(action.parameters[i]);
                }
                yield return new WaitForSeconds(2); //holds the typewriter for 2 seconds
                break;
        }

    }
}

Done! With this simple procedure, you can add any Custom Action you want.

End of the page. Go back to the Documentation Index.