Play Character One Shot Overlay Animation
캐릭터에 한 번만 재생되는 동작 애니메이션을 덧입혀 재생합니다. 가중치·속도·전환 시간을 정하고, 특정 신체 부위만(Masked) 또는 가산(Additive)으로 적용할 수 있으며, 끝나면 On Animation End가 실행됩니다.
노드 정보
- 카테고리: Characters
- 한국어 에디터 표시명: 캐릭터 원샷 오버레이 애니메이션 재생
- 종류: 실행 노드 — 실행 흐름(▶)을 받아 동작을 수행한 뒤, 다음 노드로 흐름을 넘깁니다.
개요
캐릭터에 한 번만 재생되는 동작을 덧입혀 재생합니다(손 흔들기, 절하기 등). 기본 Idle 위에 잠깐 얹혔다가 끝나면 사라지므로, 채팅·후원 반응 같은 단발 제스처에 가장 적합합니다. 가중치·속도·전환 시간을 정할 수 있습니다.
계속 반복되는 기본 동작은 Play Character Idle Animation, 레이어를 유지하며 섞으려면 겹침 애니메이션을 쓰세요.
노드 미리보기
Play Character One Shot Overlay Animation
▶Enter
Character
선택...▾
Animation
선택...▾
Transition Time
Weight
Speed
Masked
NoYes
Masked Body Parts
선택...▾
Additive Animation
NoYes
▶Exit
▶On Animation End
▶ 초록 = 실행(플로우) 포트 · ● 흰색 = 데이터 포트. 왼쪽이 입력, 오른쪽이 출력입니다.
입력
| 포트 | 종류 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| Enter | ▶ 실행 | - | - | 이 노드의 동작을 시작합니다. |
| Character | ● 데이터 | CharacterAsset | - | 대상 캐릭터(아바타) |
| Animation | ● 데이터 | String | - | 대상 애니메이션. 자동완성 지원 |
| Transition Time | ● 데이터 | Float | 1.2 | 전환에 걸리는 시간(초). 0이면 즉시. 범위 0 ~ 2 (step 0.01) |
| Weight | ● 데이터 | Float | 1 | 적용 가중치(0~1). 범위 0 ~ 1 (step 0.01) |
| Speed | ● 데이터 | Float | 1 | 속도. 범위 0 ~ 2 (step 0.01) |
| Masked | ● 데이터 | Boolean | - | 특정 부위만 적용(마스크) |
| Masked Body Parts | ● 데이터 | CharacterAsset.AnimationMaskedBodyPart[] | - | 마스크할 신체 부위 |
| Additive Animation | ● 데이터 | Boolean | - | Additive Animation Description |
출력
| 포트 | 종류 | 타입 | 설명 |
|---|---|---|---|
| Exit | ▶ 실행 | - | 동작이 끝난 뒤 이어서 실행됩니다. |
| On Animation End | ▶ 실행 | - | 애니메이션이 끝나면 실행됩니다. |
트리거
이 노드는 에디터에서 직접 누를 수 있는 버튼(트리거)을 제공합니다.
| 트리거 | 설명 |
|---|---|
| Mask Upper Body | 상체만 적용하도록 마스크를 설정합니다. |
| Mask Lower Body | 하체만 적용하도록 마스크를 설정합니다. |
사용 예시
특정 순간에 동작(춤·인사 등)을 한 번 재생할 때 씁니다.
예) 채팅 명령 !춤에 맞춰 춤 애니메이션을 재생하고, 끝나면 On Animation End로 다른 동작을 이어갈 수 있습니다. Masked로 상체만 움직이게 할 수도 있습니다.
함께 보면 좋은 노드
- Play Character Idle Animation
- Get Character Animation Pipeline Data
- Load Character Animation Profile
- Set Character Overlapping Animation Source
- Set Character Overlapping Animation Speed
- Set Character Overlapping Animation Weight
비공식 커뮤니티 문서입니다. 학습 목적으로 노드의 메타데이터를 정리한 것으로, 실제 동작은 Warudo 버전에 따라 다를 수 있습니다.