장면에서 사용（Unity）

업데이트： 2023/11/14

이 페이지에는 베타 버전에 관한 설명이 포함되어 있습니다.

Cubism SDK MotionSync Plugin for Unity를 사용하여 Cubism 모델에 연결된 모션 싱크를 이용하는 방법입니다.

모델 준비

.motionsync3.json 및 .motionsync3.json 참조가 포함된 .model3.json이 있는 모델을 준비합니다.
Cubism 4.2 이전 모델을 대상으로 하는 경우는 「Cubism 4.2 이하용 모델에서 사용」을 참조하여 모델 데이터를 준비하십시오.

모델 데이터가 준비되면 모델을 Unity로 가져옵니다.
가져오기 절차는 Cubism SDK for Unity 튜토리얼 「SDK 가져오기」를 참조하십시오.

장면 설정

Cubism SDK MotionSync Plugin for Unity가 임포트되어 있고, 모션싱크 설정이 모델의 .motionsync3.json에 존재하는 경우, 모델의 루트 오브젝트에 CubismMotionSyncController 컴포넌트와 ICubismMotionSyncProcessor를 상속받은 컴포넌트가 모델의 루트 오브젝트에 부착됩니다.

이미지에서는 CubismMotionSyncController 컴포넌트와 CubismMotionSyncCriProcessor 컴포넌트가 부착되어 있습니다.
CubismMotionSyncCriProcessor 컴포넌트가 동작하기 위해서는 분석할 음성을 받기 위한 CubismMotionSyncCriAudioInput 컴포넌트가 필요합니다.

ICubismMotionSyncProcessor를 상속받은 컴포넌트는 .motionsync3.json에 기재된 설정 개수만큼 첨부된다.

분석 설정

음성을 분석하기 위해서는 모델의 루트 오브젝트 아래 임의의 오브젝트에 CubismMotionSyncCriAudioInput을 부착해야 합니다.

이 컴포넌트를 부착하면 AudioSource가 자동으로 부착됩니다.

CubismMotionSyncCriAudioInput 컴포넌트에는 다음과 같은 설정 항목이 있습니다.

• BufferLengthPerSecond
  • 분석에 사용할 음성 데이터에 대한 링 버퍼의 크기입니다. 기본값은 1.0입니다.
  • 1.0 미만의 값이 들어오면 1.0으로 고정됩니다.
• ListeningChannel
  • 분석에 사용할 음성 채널을 인덱스 번호로 설정합니다. 기본값은 0입니다.
  • 분석에는 지정한 채널의 음성 정보만 사용합니다.

오디오 파일 추가

여기서는 직접 음성 파일을 다루어 모델의 모션 싱크를 수행하는 방법을 설명합니다.
‘음성 재생 및 분석 설정’에서 첨부한 AudioSource 컴포넌트에 음성 파일을 첨부합니다.

재생·동작

이제 모델에 모션 싱크가 적용됩니다.