이전 버전의 프로젝트를 Cubism 5 SDK로 마이그레이션

업데이트： 2023/08/17

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

개요

이 페이지에서는 Cubism 5 SDK 공개에 있어서, 이전 버전에서 마이그레이션할 때의 장점, 단점, 간단한 플로우 이미지를 안내합니다.

설명에 앞서 Cubism 5 SDK 공개 이후의 Cubism 4.2 SDK, Cubism 4 SDK, Cubism 3 SDK, Cubism 2.1 SDK의 취급은 다음과 같습니다.

• 새 다운로드가 중지되고 향후 업데이트가 이루어지지 않음
• 향후 신기능 대응은 없음
• 버그는 개별을 대상으로 하고, 버그 보고가 있었을 경우만 수정이 이루어짐

3 SDK, 4 SDK, 4.2 SDK에서 5 SDK로 마이그레이션

Cubism 3 SDK, Cubism 4 SDK, Cubism 4.2 SDK를 사용하는 사용자가 Cubism 5 SDK로 마이그레이션할 때 다음과 같은 이점과 단점이 있습니다.

장점

• 새로운 기능을 사용할 수 있다(마스크 반전) ※프레임 스텝 기능, 확장 보간은 Cubism 3, Cubism 4, Cubism 4.2 상당에서 내보낸 임베디드용 데이터에서도 이용 가능합니다.
• Cubism 3 Editor, Cubism 4 Editor, Cubism 4.2 Editor로 만든 모델을 그대로 사용할 수 있습니다. (하위 호환)

단점

• 블렌드 셰이프 기능 확장에 따라 Cubism Core의 처리 속도가 Cubism 4.2보다 약간 느려집니다.
• Framework의 Rendering은 대규모 리팩토링이 이루어졌기 때문에 Cubism SDK를 커스터마이징하여 사용하는 경우 주의가 필요하다.

플로우 이미지

Cubism 5 SDK의 구조는 기본적으로 Cubism 3 SDK에서 변경되지 않습니다. SDK 마이그레이션 시에는 교체 후, 필요한 경우 재빌드로 이용할 수 있습니다.
SDK 마이그레이션 시 샘플 코드를 그대로 사용하여 동작을 확인하는 경우 샘플 코드에서 사용하는 서드파티제 라이브러리의 업데이트 및 디렉터리 구조가 변경되었을 수 있습니다.
자세한 내용은 Cubism 5 SDK 각 플랫폼의 README 및 CHANGELOG를 참조하십시오.

2.1 SDK에서 5 SDK로 마이그레이션

Cubism 2.1 SDK를 사용하는 사용자가 Cubism 5 SDK로 마이그레이션할 때 다음과 같은 장점과 단점이 있습니다.

장점

• SDK 소스 공개 범위 확대로 유지보수성 향상.
• 2.1에 구현되어 있지 않은 기능이 다수 구현되어 있기 때문에, 더욱 풍부한 표현이 가능해집니다.

• Core 이외의 부분이 오픈 소스로 되어 있기 때문에, 렌더러 부분을 포함한 거의 모든 커스터마이즈를 자유롭게 실시할 수 있습니다.
  ※이 경우 Live2D Opensoftware License에 대한 승낙이 필요하므로 주의해 주십시오.

단점

• 마이그레이션 비용이 높아집니다.
  • SDK 세트를 교체해야 합니다.

  • 모델의 임베디드용 데이터를 최신 형식으로 다시 내보내야 합니다.
    일부 모델에서는 임베디드용 데이터를 다시 내보내기 전에 수정하는 작업이 발생할 수 있습니다. 내용에 대해서는 플로우 이미지에서 열거합니다.

플로우 이미지

Cubism 2.1 SDK에서 Cubism 5 SDK로 마이그레이션 할 때는 반드시 Cubism 5 Editor에서 .cmox 또는 .canx를 불러와 Cubism 5 SDK 임베디드용 데이터로 내보내십시오.

또 SDK나 모델 데이터의 교체 이외에도 형상이나 동작을 호환시키는 작업이 발생하는 경우가 있습니다.
다음은 예상되는 작업 내용과 대응 방법에 대해 설명합니다.

마이그레이션한 모델의 변형·묘화 결과가 다른 경우

모델 조정이 필요합니다.
Cubism 5 Editor에서 마이그레이션할 .cmox를 불러와 변형 결과를 조정합니다.
조정이 완료되면 .moc3 파일을 내보내 Cubism 5 SDK를 탑재한 실제 기기에서 표시 확인을 부탁드립니다.

Cubism 2.1 SDK에서 이용하신 mtn 파일(모션 파일)에 대해

Cubism 5 SDK는 .mtn을 지원하지 않습니다.  그러나 Cubism 5 Editor는 .canx 파일을 불러올 수 있으므로 불러온 .canx를 motion3.json로 내보내는 것으로 대응이 가능합니다.
단, 모션의 커브는 완전히 재현할 수 없고 타임라인상의 값의 변화는 근사치로 커브를 만드는 처리를 하고 있습니다.

물리 연산의 대응에 대해

Cubism 2.1에서 이용하신 물리 연산은 Cubism 5 SDK에서 그대로 사용할 수 없습니다.
Cubism 2.1 작성 물리 연산을 사용하고 있는 모델에 대해서는, Editor상에서 다시 물리 연산의 설정을 부탁드립니다.

파라미터 ID 정보

Cubism SDK에서 지정하는 호흡이나 시선 추종 등으로 지정하는 파라미터의 ID는 Cubism 5의 사양으로 변경되었습니다.
Cubism 2.1에서 이용하신 모델을 마이그레이션할 때, 내보낼 때 Cubism 5의 사양에 맞춰 변환해 주십시오.