Text Animator for Unity를 이용한 타자기 출력

유니티 버전 - 6000.0.49f1

에셋 버전 - 2.3.1

 

 

 

 

목차

---

• 에셋 설명
• 컴포넌트 설정
• 스크립트

 

 

 

 

 

에셋 설명

---

https://assetstore.unity.com/packages/tools/gui/text-animator-for-unity-254677?srsltid=AfmBOooCsS2udUlvAMfx7vJf2IoYJKvl0pieJqR4DD0XP7sRG98q-cYp

Text Animator for Unity | GUI 도구 | Unity Asset Store

 

Text Animator for Unity는 몇 가지 간단한 단계만으로 텍스트에 생명력을 불어넣는 강력하고 유연한 도구입니다.

 

 

 

 

 

컴포넌트 설정

---

텍스트가 출력될 TextMeshPro - Text (UI)와 같은 컴포넌트에 Text Animator - Text Mesh Pro와 Typewriter - By Character를 위치시킵니다

 

 

 

Text Animator의 Typewriter Starts Automatic을 활성화합니다

 

 

 

Typewriter의 Start Typewriter Mode를 From Script Only로 설정합니다

 

 

 

 

 

스크립트

---

변수를 선언합니다

[SerializeField] private TypewriterByCharacter typewriter;
// 실제 대사가 출력될 TMP와 같은 컴포넌트의 Typewriter

[SerializeField] private TextMeshProUGUI dialogueText;
// 실제 대사가 출력될 TMP

private int _currentLine;
// 대사 이벤트가 어디가지 진행됬는지 추적

private bool _isAnimating;
// 현재 출력중인지 추적

 

 

AddListener를 이용하여 텍스트 출력이 완료될때 더이상 출력중이지 않은 상태로 만들어줍니다, 만약, 텍스트를 출력하는 동안 한번더 사용자의 인풋이 있으면 대화를 즉시 모두 출력하고 대기하기위하여 사용됩니다

public override void Init()
{
    base.Init();
        
    typewriter.onTextDisappeared.AddListener(OnIsEndedAnimating); // 이 부분
}


private void OnIsEndedAnimating() 
{
    _isAnimating = false;
}

 

 

현재 _isAnimating 따라 동작을 다르게 해줍니다, 만약 출력중이라면 모두 출력하고 아니라면 다음 텍스트를 출력합니다

private void OnNextDialogue()
{
    if (_isAnimating)
    {
        typewriter.SkipTypewriter(); // 스킵 메서드
            
        _isAnimating = false;
    }
    else
    {
        _currentLine++;
            
        ShowLine(_currentLine); // 다음줄을 출력하기위한 메서드
    }
}

 

 

실제 텍스트를 출력하는 ShowLine 메서드입니다

private void ShowLine(int index)
{
    if (index >= texts.Length) // 만약 이미 전부 출력하였다면 DialoguePopup을 닫음
    {
        Managers.UI.ClosePopup();
        return;
    }
        
    _isAnimating = true;
        
    typewriter.ShowText(texts[index]); // 실제 실행 메서드, texts[index]는 출력할 대사가 담겨있음
    typewriter.StartShowingText(true); // 만약 ShowText() 만 이용했을때 출력이 제대로 안될경우 사용
}

 

 

 

실행 결과입니다

 

 

 

메뉴얼

https://docs.febucci.com/text-animator-unity

Text Animator for Unity | Text Animator for Unity

 

 

 

스크립팅 API

https://www.api.febucci.com/tools/text-animator-unity/api/Febucci.UI.html

Namespace Febucci.UI | Text Animator for Unity