URP용 프로젝트로 가져오기 및 설정

업데이트： 2026/01/08

여기에서는 Universal Render Pipeline(이하, URP) 프로젝트를 생성하여 Cubism 5 SDK for Unity R5 beta 3의 가져오기와 Cubism 모델을 활용하기 위한 설정을 구성하는 방법을 설명합니다.

사용법

Unity Hub의 새 프로젝트 만들기에서 템플릿을 Universal 2D 또는 Universal 3D로 선택합니다.

프로젝트가 생성되면 Project Settings을 엽니다.

먼저 왼쪽 목록에서 Quality를 클릭하여 개발할 예정인 플랫폼의 Render Pipeline 에셋을 확인합니다.

설정되어 있지 않으면 왼쪽 목록에서 Graphics을 클릭하여 Default Render Pipeline을 확인합니다.

패키지 가져오기 및 설정

Cubism 5 SDK for Unity R5 beta3을 다운로드 페이지에서 받아 Unity Editor로 가져옵니다.

가져오기가 완료되면 확인한 Universal Renderer Pipeline 에셋을 열고 Renderer List에 CubismURPRenderer.asset을 설정합니다. 다른 Universal Renderer Data 에셋이 필요하지 않은 경우 CubismURPRenderer.asset을 Default로 설정하고 목록에서 제거하십시오.

또한 여러 Universal Renderer Data 에셋이 등록되어 있는 경우 CubismURPRenderer.asset을 Default 로 설정하지 않으면 Scene 뷰에서 Cubism 모델을 그릴 수 없습니다.

주의사항

Universal Renderer Pipeline 에셋에 HDR이 설정되어 있으면 HDR Precision을 확인하십시오.
HDR Precision을 32bits로 설정하면 배경이 검은색으로 변하고 정상적으로 합성되지 않을 수 있습니다.
HDR을 이용하고 싶은 경우 HDR Precision을 64bits로 설정하면 정상적으로 그릴 수 있게 됩니다.

설정에 대해서는 Unity 공식 매뉴얼의 Manual: Universal Render Pipeline asset reference for URP 및 Manual: Display advanced properties in a URP Asset을 확인하십시오.

Cubism Editor와 동등한 표현을 하려면 HDR을 비활성화하고 Color Space를 Gamma로 설정해야 합니다.
Color Space는 왼쪽 목록에서 Player를 클릭하고 Other Settings에서 설정하십시오.

장면에서 사용

우선 카메라의 Renderer를 설정합니다.
CubismURPRenderer가 Default로 설정된 경우 따로 설정이 필요하지 않습니다.
Default로 설정되어 있지 않으면 그림과 같이 풀다운에서 CubismURPRenderer를 설정하십시오.

그런 다음 임의의 모델 Prefab을 장면에 배치하면 모델이 그려집니다.

빌드 정보

블렌드 모드를 사용하는 머티리얼을 Shader Variants에서 미리 생성하므로 사용하는 환경에 따라 빌드 시간이 이전에 비해 크게 증가할 수 있습니다.
명백히 사용하지 않는 머티리얼이나 블렌드 모드가 존재하는 경우 빌드 시에 불필요한 머티리얼을 Strip하도록 설정하는 것으로 빌드 시간을 억제할 수 있습니다.

기타 주의사항 등 자세한 내용은 「Built-in Render Pipeline에서 URP로 마이그레이션」 또는 「커스텀 렌더 패스를 이용한 그리기」를 확인하십시오.