SDK 가져오기

업데이트： 2021/06/25

Cubism Editor에서 내보낸 임베디드용 모델 파일을 Unity 프로젝트로 가져와서 화면에 표시하기까지의 튜토리얼입니다.

준비할 것

Cubism 3 이상 버전의 Cubism SDK for Unity가 지원하는 Unity 버전은 2019.x입니다.
2018.3 미만인 경우 SDK의 자산(.mat 등)으로 직렬화된 정보가 파기됩니다.
Unity 설치에 대해서는 여기를 참조하십시오. 

또한 Cubism SDK for Unity 도 미리 다운로드하십시오.
이것은 unitypackage 형식의 패키지로 배포하고 있습니다.
SDK는 Github에서도 공개하고 있지만 여기에는 라이브러리가 포함되지 않으므로 모델을 임베디드할 때는 패키지를 사용하십시오.

SDK에서 Live2D 모델을 처리하는 경우 편집용 .cmo3 또는 .can3 대신 임베디드용 모델로 내보내야 합니다.
임베디드용 모델을 내보내는 방법은 「임베디드용 데이터」를 참조하십시오.
내보낼 데이터는 .moc3 파일, .model3.json 파일, 텍스쳐가 들어 있는 폴더입니다.
이들을 하나의 폴더에 정리해 주세요.

SDK를 프로젝트로 가져오기

2D 모드에서 Unity의 새 프로젝트를 만들고 Cubism SDK for Unity(.unitypackage 파일)를 Project 뷰로 드래그 앤 드롭하여 가져옵니다.

Unity의 새로운 프로젝트를 만드는 방법은 여기를 참조하십시오. 

가져오기가 완료되면 Unity를 닫고 프로젝트를 다시 열어야 합니다.

모델 가져오기

Cubism Editor에서 내보낸 임베디드용 모델 모음을 폴더째로 Project 뷰로 드래그 앤 드롭합니다.

성공적으로 가져오기가 완료되면 SDK에 포함된 Cubism의 Importer가 자동으로 Prefab을 생성합니다.
이 생성된 Prefab은 Live2D 모델을 Unity에서 처리할 수 있는 상태로 변환한 것입니다.
파라미터나 파츠의 표시는 이 단계에서 Hierarchy 뷰로 조작이 가능한 상태가 되어 있습니다.

생성된 Prefab을 Hierarchy 뷰 또는 Scene 뷰에 추가하여 장면을 실행하면 모델을 배치할 수 있습니다.

Original Workflow 방식에 대하여

[2019/01/31 추가]
R11부터 추가된 Original Workflow 방식으로 모델을 가져오려면 Project 창으로 드래그 앤 드롭하기 전에,
메뉴바에서 Live2D > Cubism > Original Workflow > Should Import As Original Workflow에 체크합니다.

[2021/01/12 추가]
Cubism 4 SDK for Unity R2부터는 기본적으로 Original Workflow 방법으로 가져오기가 활성화되어 있습니다.
기존 방식으로 모델을 가져오려면 메뉴바에서 Live2D > Cubism > Original Workflow > Should Import As Original Workflow의 체크를 해제합니다.

여기에 체크가 표시된 상태에서 가져오면 생성된 Prefab에 추가로 OW 방식의 컴포넌트가 연결됩니다.