Generate Lip Sync Animation
마이크(또는 시스템 오디오) 입력을 분석해 음소(입모양)에 맞는 블렌드셰이프를 만들어 입력 목록에 합쳐 출력합니다. Calibrate로 발음을 보정하고, 기존 입 블렌드셰이프 제거·이진화 등을 설정할 수 있습니다. (자동 립싱크)
노드 정보
- 카테고리: Procedural Animations
- 한국어 에디터 표시명: 립싱크 애니메이션 생성
- 종류: 이벤트 노드 — 특정 사건이 발생하면 스스로 실행 흐름(▶)을 시작합니다. 그래프의 시작점으로 사용합니다.
개요
마이크(또는 시스템 오디오) 입력을 분석해 음소(입모양)에 맞는 입 블렌드셰이프를 자동으로 만들어 출력합니다. 말하는 소리에 맞춰 입이 자연스럽게 움직이는 립싱크의 핵심입니다.
출력한 블렌드셰이프 목록을 Override Character BlendShapes에 연결해 적용합니다. 단순히 음량에 입을 여닫는 것은 음성 반응 워크플로가 더 간단합니다. Phonemes는 모델의 입모양 블렌드셰이프 표준을 고르는 값입니다 — VRM0X(VRM 0.x 표준)·VRM10(VRM 1.0 표준)·Custom(직접 지정). 캐릭터의 VRM 버전에 맞춰 선택하세요.
노드 미리보기
Generate Lip Sync Animation
BlendShape List
선택...▾
Enabled
NoYes
Weight
Microphone
"0"▾
Channel
Stereo▾
Volume Threshold
Calibration Profile
Default.json▾
Phonemes
VRM0X▾
Custom Phonemes
선택...▾
Phonemes
선택...▾
Phoneme
Profile Name
선택...▾
BlendShape
Max Weight
Smooth Time
Remove Input Mouth BlendShapes
NoYes
Binarize
NoYes
Output BlendShape List
▶ 초록 = 실행(플로우) 포트 · ● 흰색 = 데이터 포트. 왼쪽이 입력, 오른쪽이 출력입니다.
입력
| 포트 | 종류 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| BlendShape List | ● 데이터 | Dictionary<string, float> | - | 블렌드셰이프 목록(이름→값) |
| Enabled | ● 데이터 | Boolean | true | 켜기/끄기 |
| Weight | ● 데이터 | Float | 1 | 적용 가중치(0~1). 범위 0 ~ 2 (step 0.01) |
| Microphone | ● 데이터 | String | "0" | 입력 마이크. 자동완성 지원 |
| Channel | ● 데이터 | ChannelType | - | 오디오 채널 (스테레오/좌/우). 값: Stereo, Left, Right |
| Volume Threshold | ● 데이터 | Float | 25 | Lipsync Volume Threshold Description. 범위 0 ~ 100 (step 0.01) |
| Calibration Profile | ● 데이터 | String | Default.json | 캘리브레이션 프로파일. 자동완성 지원 |
| Phonemes | ● 데이터 | CalibrationPhonemeType | - | Phoneme Type Description. 값: VRM0X, VRM10, Custom |
| Custom Phonemes | ● 데이터 | String[] | - | 커스텀 음소 목록 |
| Phonemes | ● 데이터 | PhonemeData[] | - | 음소 목록 |
| Phoneme | ● 데이터 | String | - | 음소 |
| Profile Name | ● 데이터 | String | - | 프로파일 이름. 자동완성 지원 |
| BlendShape | ● 데이터 | String | - | 대상 블렌드셰이프 이름 |
| Max Weight | ● 데이터 | Float | 1 | 최대 가중치. 범위 0 ~ 1 (step 0.01) |
| Smooth Time | ● 데이터 | Float | 0.1 | 부드럽게 따라가는 시간(클수록 느림). 범위 0 ~ 0.3 (step 0.01) |
| Remove Input Mouth BlendShapes | ● 데이터 | Boolean | true | 입력의 입 블렌드셰이프 제거 여부 |
| Binarize | ● 데이터 | Boolean | - | 이진화 여부 |
출력
| 포트 | 종류 | 타입 | 설명 |
|---|---|---|---|
| Output BlendShape List | ● 데이터 | Dictionary<string, float> | 처리된 블렌드셰이프 목록 |
트리거
이 노드는 에디터에서 직접 누를 수 있는 버튼(트리거)을 제공합니다.
| 트리거 | 설명 |
|---|---|
| Calibrate | 현재 상태로 캘리브레이션(보정)합니다. |
| Start Calibration | 캘리브레이션을 시작합니다. |
| Stop Calibration | 캘리브레이션을 중지합니다. |
함께 보면 좋은 노드
비공식 커뮤니티 문서입니다. 학습 목적으로 노드의 메타데이터를 정리한 것으로, 실제 동작은 Warudo 버전에 따라 다를 수 있습니다.