UE4 ACharacter::PlayAnimMontage 반환값이 실제 재생시간과 다른 이유

내부에서는 기본 반환 형식을 사용한다#

당시 구현은 UAnimInstance::Montage_Play를 아래와 같이 호출했다.

1
float ACharacter::PlayAnimMontage(
2
    UAnimMontage* AnimMontage,
3
    float InPlayRate,
4
    FName StartSectionName)
5
{
6
    UAnimInstance* AnimInstance = Mesh ? Mesh->GetAnimInstance() : nullptr;
7

8
    if (AnimMontage && AnimInstance)
9
    {
10
        const float Duration = AnimInstance->Montage_Play(
11
            AnimMontage,
12
            InPlayRate);
13

14
        if (Duration > 0.f)
15
        {
16
            if (StartSectionName != NAME_None)
17
            {
18
                AnimInstance->Montage_JumpToSection(
19
                    StartSectionName,
20
                    AnimMontage);
21
            }
22

23
            return Duration;
24
        }
25
    }
26

27
    return 0.f;
28
}

Montage_Play의 세 번째 인자는 아래 enum이며, 기본값은 MontageLength였다.

1
enum class EMontagePlayReturnType : uint8
2
{
3
    MontageLength,
4
    Duration,
5
};

ACharacter::PlayAnimMontage는 이 기본값을 그대로 사용해 MontageToPlay->SequenceLength를 반환한다. 재생 속도를 바꾸더라도 반환값은 원본 전체 길이다.

1
// UE 4.27.2의 Montage_Play 반환 부분을 단순화한 형태
2
return ReturnValueType == EMontagePlayReturnType::MontageLength
3
    ? MontageLength
4
    : MontageLength / (InPlayRate * MontageToPlay->RateScale);

StartSectionName도 반환값을 계산한 뒤 Montage_JumpToSection으로 적용되므로, 특정 Section에서 시작해도 반환값은 전체 Montage 길이 그대로다.

속도가 반영된 전체 길이가 필요할 때#

Character wrapper 대신 Anim Instance의 함수를 직접 호출하고 반환 형식을 Duration으로 지정할 수 있다.

1
UAnimInstance* AnimInstance = GetMesh()->GetAnimInstance();
2
if (!AnimInstance || !AnimMontage)
3
{
4
    return 0.f;
5
}
6

7
const float Duration = AnimInstance->Montage_Play(
8
    AnimMontage,
9
    InPlayRate,
10
    EMontagePlayReturnType::Duration);
11

12
if (Duration > 0.f && StartSectionName != NAME_None)
13
{
14
    AnimInstance->Montage_JumpToSection(
15
        StartSectionName,
16
        AnimMontage);
17
}

이때 얻는 Duration도 전체 Montage를 처음부터 재생한다고 가정한 속도 보정 길이다. 시작 Section, Section 연결 관계, 반복 Section, runtime의 Montage_SetNextSection, blend out과 interruption까지 포함한 실제 종료 시점은 표현하지 못한다.

원문의 수식은 제한적으로만 맞는다#

원문에서는 다음 계산을 제안했다.

1
const float Duration =
2
    PlayAnimMontage(AnimMontage, InPlayRate) /
3
    (InPlayRate * AnimMontage->RateScale);

UE 4.26의 Montage_Play(..., EMontagePlayReturnType::Duration) 내부 계산과 같은 형태이므로, 전체 Montage가 순서대로 한 번 재생되는 단순한 경우에는 맞는다. 다만 아래 상황에서는 실제 종료시간이 아니다.

• StartSectionName으로 중간에서 시작한다.
• Section이 반복되거나 runtime에 다음 Section을 바꾼다.
• 다른 Montage가 재생을 중단한다.
• blend out이나 notify 시점을 기다리는 것이 목적이다.
• 0 또는 비정상적인 Play Rate를 전달한다.

게임플레이 로직을 정확한 종료 시점에 연결하려면 float 길이로 timer를 예약하기보다 Montage 종료 delegate, Blueprint의 On Completed·On Blend Out·On Interrupted, Anim Notify를 사용한다. 길이 반환값은 재생 성공 여부와 단순한 예상 시간을 얻는 용도로만 쓰는 편이 안전하다.

참고 자료#

• Epic Games: Using Animation Montages — UE 4.27
• Epic Games: Editing an Animation Montage — UE 4.27