컴포넌트
Framework는 아바타 빌드 시 Addon의 컴포넌트 설정을 적용합니다. 일반적인 설치는 Installer에서 진행하며, 구성이나 설정을 직접 확인하려면 이 페이지를 참고하세요.
아래는 Salt에 설치한 뒤의 Hierarchy입니다. 오브젝트 오른쪽의 컴포넌트 이름을 선택하면 해당 설명으로 이동합니다.
Avatars
Salt
Armature
Body
Kemono_Ear
Face Tracking편집 전 백업
Addon 프리팹을 직접 편집한 값은 업그레이드 시 교체될 수 있습니다. 유지할 항목과 값을 기록해 두세요.
Face Tracking Settings
제공된 프리팹에서는 아바타의 Face Tracking을 펼쳐 Face Tracking Settings를 선택하면 Inspector에서 눈, 입, Reset 설정을 조정할 수 있습니다.
| 조정할 효과 | Inspector 설정 |
|---|---|
| 눈 추적 강도 | Eye Weight. 미리보기에서 눈 모양을 비교합니다. |
| 턱이 내려가는 정도 | Jaw Strength. |
| 움직일 때 남는 커스텀 얼굴 모양 | 해당 Reset 그룹을 조정합니다. 눈을 감을 때 메시가 겹치면 감은 눈을 미리 봅니다. 그룹은 Addon마다 다릅니다. |
VRC Face Tracking Installer
VRChat 네이티브 얼굴 추적 설정을 VRC Avatar Descriptor에 추가합니다. Addon 프리팹에서 다음 항목을 지정합니다.
- 추적에 사용할 메시
- 시선, 눈꺼풀, 음성 입 모양 등 활성화할 기능
- 추가할 Blendshape Set 및 Parameter Behavior
빌드할 때 Framework가 이 설정을 Descriptor에 병합합니다.
Installer 열기
이 컴포넌트는 빌드 시 작동합니다. Addon 설치는 Unity의 TriturboFT › Face Tracking Installer에서 진행하세요.
Face Tracking Blend Set
얼굴 추적용 Blendshape Set 하나를 Descriptor에 추가합니다. VRC Face Tracking Installer에서도 Set을 제공할 수 있습니다. 눈꺼풀처럼 자식 프리팹에서 자체 Set을 관리할 때 다음을 지정합니다.
- Set 이름
- 추적 입력과 Blendshape의 매핑
- 기본 가중치
조건에 따라 가중치를 바꾸려면 제어 가중치를 켜고 상태를 설정합니다. 가중치 출력 파라미터를 지정하면 다른 애니메이션에서도 같은 값을 Float로 읽을 수 있습니다.
Face Tracking Toggle
조건에 따라 가중치를 전환하는 Animator 제어를 생성합니다. 각 상태에는 조건과 0에서 1 사이의 가중치가 있습니다. 목록에서 조건이 처음으로 충족되는 상태가 적용됩니다.
가중치는 다음 대상에 사용할 수 있습니다.
| 대상 | 설정 | 일치하는 상태가 없을 때 |
|---|---|---|
| Blendshape Set | Set을 선택하면 상태 가중치가 적용됩니다. 가중치 출력 파라미터에 같은 Float를 쓸 수도 있습니다. | Set의 기본 가중치 사용 |
| Float를 읽는 Blend Tree 또는 컴포넌트 | Set을 비워 두고 블렌드 파라미터에 대상 Float를 지정합니다. | Toggle의 기본 가중치 출력 |
예를 들어 귀가 표정을 따르는 정도를 Float로 제어한다면 Blend Parameter만 지정하고 기본값을 1로 설정합니다. 수동 모드일 때 가중치가 0인 상태를 추가하면 수동 모드에서는 귀가 표정을 따라가지 않습니다.
Tracking State Router
눈과 입을 추적 또는 애니메이션 중 어느 쪽이 제어할지 통합 관리합니다. 여러 레이어의 VRC Animator Tracking Control을 처리하기 위해 빌드 시 다음 작업을 수행합니다.
- 각 Playable Layer의 상태와 상태 머신에서 VRC Animator Tracking Control을 찾습니다.
- 눈과 입의 Tracking/Animation 지시를 요청으로 바꾸고 원래 필드를 No Change로 설정합니다. 다른 부위의 설정은 유지됩니다.
- FX에 Tracking State Router 레이어를 추가해 요청에 따라 눈과 입의 상태를 따로 결정합니다.
승인이 필요한 상태에서 검사할 레이어를 선택하고 눈과 입의 애니메이션 허용 조건를 따로 설정합니다. 선택한 레이어의 Animation 요청은 해당 부위의 조건을 검사하며 다른 레이어의 요청은 바로 적용됩니다.
부위별 트래킹 출력 파라미터로 판정 결과를 다른 컴포넌트에 전달할 수 있습니다. Tracking이면 1, Animation이면 0입니다.
제공된 프리팹 설정 예시
제공된 Face Tracking Settings 프리팹은 정수 FT/ExpressionMode에 메뉴의 표정 모드를 저장하고 승인 대상을 FX로 지정합니다. 이름과 모드 값은 이 프리팹이 정의합니다. 직접 구성할 때는 조건에 원하는 Animator 파라미터를 사용할 수 있습니다.
이 프리팹은 눈 추적이 꺼져 있거나 FT/ExpressionMode가 2(Expression Priority)일 때 FX 애니메이션이 눈을 제어하도록 허용합니다. 입도 자체 추적 스위치로 같은 규칙을 적용하며 Gesture에서 직접 오는 요청은 바로 적용됩니다.
VRChat SDK의 Animator Tracking Control 설명
Face Tracking Merge Motion
Animation Clip 또는 Blend Tree를 Playable Layer에 추가합니다. Unity에서는 둘 다 Motion이라고 부릅니다. Clip 경로를 아바타 루트 또는 지정한 루트 기준으로 설정해 다른 위치의 프리팹에도 같은 애니메이션을 쓸 수 있습니다.
Motion 변형 활성화를 켜면 조건별로 전환됩니다. 목록에서 처음 일치하는 변형을 사용하고 없으면 원래 Motion을 재생합니다.
| 변형 모드 | 조건이 충족될 때 |
|---|---|
| Override Motion | 원래 Motion의 Clip 또는 Blend Tree 입력을 바꿉니다. 예를 들어 TongueX를 수동 조작 Float로 바꾸거나 0으로 고정해 혀를 중앙에 둡니다. |
| New Motion | 별도로 만든 수동 제어 트리 등 다른 Clip이나 Blend Tree를 재생합니다. |
Face Tracking Forward Parameters
SDK 추적 입력을 Animator가 읽을 수 있는 Float로 변환합니다. 입력 Tracking Key, 계산 방식, 출력 이름을 지정하면 빌드 시 Forward to Animator 파라미터 동작을 생성합니다.
예를 들어 EyeClosedLeft와 EyeClosedRight에 Max를 적용하면 두 눈의 감김 정도 중 큰 값을 출력합니다. Min, Add, Multiply 및 사용자 정의 식도 사용할 수 있습니다.
Blend Tree가 이 Float를 읽으면 선택한 Tracking Key에 따라 애니메이션을 구동합니다. 귀의 움직임이나 얼굴 추적 Blendshape의 가중치 등 무엇을 제어할지는 애니메이션이 정합니다.
동일한 계산은 출력을 공유합니다. 서로 다른 계산이 같은 이름을 사용하면 범위에 따라 구분하고 같은 범위 안에서 규칙이 충돌하면 오류가 발생합니다. 계층 밖에서도 같은 이름을 읽어야 한다면 계층 외부 동명 허용을 켭니다.
Component Property Overrides
빌드용 아바타 복사본에서 프로퍼티를 교체합니다. 각 항목에 대상 컴포넌트, 직렬화된 프로퍼티 경로 및 교체할 값을 지정합니다. 씬 오브젝트의 값은 유지됩니다.
예를 들어 Installer는 Face Tracking Meshes에 메시 재정의를 기록해 빌드 시 대상 Skinned Mesh Renderer가 추적용 Blendshape를 포함한 메시를 사용하게 합니다. Renderer 교체 또는 프리팹 업데이트 후에는 대상 컴포넌트와 프로퍼티가 여전히 존재하는지 확인하세요.
Hierarchy


All