Cubism 5 SDK R5 정식 버전 호환성 이해
업데이트： 2026/04/02
개요
여기에서는 Cubism 5 SDK R5 정식 버전의 호환성에 대해 다음 내용을 설명합니다.
- 기존의 SDK와의 호환성에 대해 어떤 주의점이나 변경점이 있는가?
명칭에 대해
- R5 베타 버전 SDK는 Cubism 5 SDK R5 정식 버전 이전의 SDK를 가리킵니다.
- R5 정식 버전 SDK는 Cubism 5 SDK R5 정식 버전 이후의 SDK를 가리킵니다.
호환성에 영향을 미치는 수정
- 모델 계산 순서 정렬 기능 및 순서 변경
- 곱하기 색·스크린색의 클래스 구조 변경 및 API명 변경
모델 계산 순서 정렬 기능 및 순서 변경
for Native 및 for Web에서 모델 계산 순서를 쉽게 변경할 수 있는 기능을 구현했습니다.
이 수정을 통해 모델의 파라미터 업데이트와 관련된 기능을 Sample에서 Framework로 이전했습니다.
Drag 조작에 의한 파라미터 업데이트 기능에 대해서는 Framework로 이전함에 있어서 CubismLook 클래스를 생성해 입력값 및 대상 파라미터를 설정하거나 취득, 파라미터를 업데이트할 수 있도록 변경했습니다.
구체적인 수정 내용은 「모델의 계산 순서 정렬 기능」에서 설명하고 있습니다.
또한 for Unity에서 for Native 및 for Web의 Original Workflow계 SDK와 처리 순서가 달랐기 때문에 계산 순서를 Original Workflow계 SDK와 동일하게 되도록 변경했습니다.
이 수정으로 인해 물리 연산과 관련된 파라미터 업데이트 결과가 R5 베타 버전 SDK와 다릅니다.
R5 베타 버전 SDK의 파라미터 업데이트 결과가 필요한 경우 수정 방법은 다음을 확인하십시오.
- GitHub의 CubismUnityComponents에 접속합니다.
- Cubism 5 SDK for Unity R5 beta3 이전의 Assets/Live2D/Cubism/Framework/CubismUpdateExecutionOrder.cs를 확인합니다.
- R5 정식 버전 CubismUpdateExecutionOrder.cs의 각 상수를 바꿉니다.
곱하기 색·스크린색의 클래스 구조 변경 및 API명 변경
for Native 및 for Web에서 CubismModel 클래스에서 곱하기 색·스크린색 덮어쓰기와 관련된 기능을 CubismModelMultiplyAndScreenColor 클래스로 이전했습니다.
이 수정으로 가독성이 향상되었습니다.
또한 for Native 및 for Web, for Unity에서 통일성이 없었던 API 이름을 변경했습니다.
for Native 및 for Web의 API 이름 변경에 대해서는 아래 표를 참조하십시오.
(※MultiplyColor 관련 API명만)
| 구분 | R5 베타 버전 SDK(변경 전) | R5 정식 버전 SDK(변경 후) |
| 색상 | SetMultiplyColor() | SetDrawableMultiplyColor() |
| GetMultiplyColor() | SetDrawableMultiplyColor() | |
| SetPartMultiplyColor() | SetPartMultiplyColor() | |
| GetPartMultiplyColor() | GetPartMultiplyColor() | |
| SetMultiplyColorOffscreen() | SetOffscreenMultiplyColor() | |
| GetMultiplyColorOffscreen() | GetOffscreenMultiplyColor() | |
| 덮어쓰기 플래그 | SetOverrideFlagForModelMultiplyColors() | SetMultiplyColorEnabled() |
| GetOverrideFlagForModelMultiplyColors() | GetMultiplyColorEnabled() | |
| SetOverrideColorForPartMultiplyColors() | SetPartMultiplyColorEnabled() | |
| GetOverrideColorForPartMultiplyColors() | GetPartMultiplyColorEnabled() | |
| SetOverrideFlagForDrawableMultiplyColors() | SetDrawableMultiplyColorEnabled() | |
| GetOverrideFlagForDrawableMultiplyColors() | GetDrawableMultiplyColorEnabled() | |
| SetOverrideFlagForOffscreenMultiplyColors() | SetOffscreenMultiplyColorEnabled() | |
| GetOverrideFlagForOffscreenMultiplyColors() | GetOffscreenMultiplyColorEnabled() |
for Unity의 API 이름 변경에 대해서는 아래 표를 참조하십시오.
| 구분 | R5 베타 버전 SDK(변경 전) | R5 정식 버전 SDK(변경 후) |
| 색상 | CubismRenderer.MultiplyColor | CubismRenderer.MultiplyColor |
| CubismPartColorsEditor.MultiplyColor | CubismPartColorsEditor.MultiplyColor | |
| 덮어쓰기 플래그 | CubismRenderController.OverrideFlagForModelMultiplyColors | CubismRenderController.MultiplyColorEnabled |
| CubismPartColorsEditor.OverrideColorForPartMultiplyColors | CubismPartColorsEditor.PartMultiplyColorEnabled | |
| CubismRenderer.OverrideFlagForDrawObjectMultiplyColors | CubismRenderer.DrawObjectMultiplyColorEnabled |
구체적인 수정 내용과 수정 후의 덮어쓰기 처리의 호출 방법은 「【Native】 곱하기 색·스크린색」 「【Web】 곱하기 색·스크린색」 「【Unity】 곱하기 색·스크린색」에서 설명하고 있습니다.