SDK를 프로젝트에 도입

업데이트： 2024/09/05

Cubism Editor에서 내보낸 임베디드용 모델 파일을 Unreal Engine 프로젝트에 도입하여 모델을 뷰포트에 표시하기까지의 튜토리얼입니다.

전제

Cubism SDK for Unreal Engine을 사용하려면 Unreal Engine 5.3 계열과 Cubism SDK for Unreal Engine을 설치해야 합니다.
Unreal Engine 설치에 대해서는 여기를 참조하십시오.
Cubism SDK for Unreal Engine 다운로드는 여기에서 가능합니다.
Cubism SDK for Unreal Engine은 Unreal Engine 플러그인 형태로 배포됩니다.
플러그인의 구조에 대해서는 Unreal Engine 공식 문서를 참조하십시오.

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

플러그인을 프로젝트 파일에 추가

아래에서는 CubismSDKForUE라는 UE 프로젝트를 만들었다고 가정합니다.
프로젝트를 만들 때는 프로젝트 생성 시 설정에서 C++를 선택하는 것이 좋습니다.
생성한 프로젝트의 디렉토리는 대체로 다음과 같이 되므로, 루트 디렉토리에 Plugins 폴더를 작성해 그 아래에 플러그인을 배치합니다.

CubismSDKForUE
├── Binaries
├── Config
├── Content
│   └── ...
├── Plugins <- ディレクトリを追加
│   └── CubismUnrealEngineComponents <- プラグインをここに配置する
│       └── ...
├── Source
└── CubismSDKForUE.uproject

텍스트 에디터 등으로 CubismSDKForUE.uproject 파일을 열고 Plugins 프로퍼티에 Live2DCubismSDK를 추가하고 Enabled에 true를 설정합니다.
추가한 후 파일을 덮어쓰기 저장합니다.

{
	"FileVersion": 3,
	"EngineAssociation": "5.2",
	"Category": "",
	"Description": "",
	"Modules": [
		{
			"Name": "CubismSDKForUE",
			"Type": "Runtime",
			"LoadingPhase": "Default"
		}
	],
	"Plugins": [
		{
			"Name": "ModelingToolsEditorMode",
			"Enabled": true,
			"TargetAllowList": [
				"Editor"
			]
		},
		{
			"Name": "Live2DCubismSDK",
			"Enabled": true
		}
	]
}

그런 다음 저장된 .uproject 파일을 더블 클릭하여 프로젝트를 시작하고 빌드가 완료되면 SDK 도입이 완료됩니다.

모델을 프로젝트로 가져오기

Cubism Editor에서 내보낸 임베디드용 모델 데이터 세트를 Unreal Editor의 콘텐츠 브라우저에 폴더째로 드래그 앤 드롭합니다.

성공적으로 가져오기가 완료되면 모든 임베디드용 모델 파일이 Unreal Engine용 에셋 파일 uasset으로 변환됩니다.
각 에셋은 더블 클릭하여 Unreal Editor에서 내용을 확인할 수 있습니다.

변환된 에셋 중 model3.json에 대응하는 CubismModelJson 에셋을 Unreal Editor의 뷰포트에 드래그 앤 드롭하면 CubismModel 액터가 스폰됩니다.