Table of Contents

구성 Universal Render Pipeline(URP)

이 문서는 Universal Render Pipeline(URP) 프로젝트에 EasyAR 기능을 통합할 때의 구성 방법을 설명합니다.

시작하기 전에

Universal Render Pipeline 에셋 생성

참고

Unity 프로젝트가 URP 프로젝트 템플릿으로 생성되었거나 프로젝트에 이미 UniversalRenderPipelineAsset 및 Universal Renderer가 존재하는 경우, 프로젝트가 URP 렌더링 파이프라인으로 전환되었는지 확인으로 바로 건너뛸 수 있습니다.

Project 창에서 우클릭 메뉴 Create > Rendering > URP Asset(with Universal Renderer) 를 통해 필요한 에셋을 생성합니다:

Unity6.2_URP_Create_Asset

대상 플랫폼에서 사용하는 Universal Render Pipeline 에셋 찾기

  1. 메뉴 바에서 Edit > Project Settings > Graphics를 클릭합니다.

    상단의 Default Render Pipeline 슬롯에는 Universal Render Pipeline Asset이 할당되어 있어야 합니다.

    Unity6.2_URP_Graphics

    팁

    이 옵션은 이전 버전 Unity에서 Scriptable Render Pipeline Settings로 명명되었습니다.

  2. 메뉴 바에서 Project Settings > Quality를 클릭합니다.

    대상 플랫폼의 품질 수준을 선택하면, 하단의 Render Pipeline Asset이 해당 플랫폼에서 사용하는 Universal Render Pipeline 에셋입니다. 비어 있다면, 대상 플랫폼은 Graphics 창에서 구성된 에셋을 사용합니다.

    Unity6.2_URP_Quality

    팁

    Quality의 설정이 Graphics와 일치하지 않으면 시스템은 Quality의 Asset을 우선적으로 사용합니다.

Universal Render Pipeline 에셋 구성

중요

Unity 에디터와 Android/iOS 등 디바이스에서 사용하는 Universal Render Pipeline 에셋은 종종 다릅니다. 에디터에서 사용할 것과 디바이스에서 사용할 것을 각각 구성해야 합니다.

  1. 대상 플랫폼에서 사용하는 Universal Render Pipeline Asset을 선택한 후, 해당 에셋이 사용하는 Universal Renderer Data를 선택합니다.

    Unity6.2_URP_Renderer

    팁

    프로젝트에 여러 Renderer가 구성되어 있다면, AR 카메라가 사용 중인 렌더러를 선택했는지 확인하십시오. 씬 카메라의 Camera 컴포넌트 > Rendering > Renderer 옵션에서 현재 인덱스 값을 확인할 수 있습니다.

  2. Universal Renderer Data의 Inspector 패널 하단에서 Add Renderer Feature를 클릭하고, EasyARCameraImageRendererFeature를 추가합니다.

    Unity6.2_URP_Renderer_Add_Feature

EasyAR 샘플 사용 시 주의 사항

EasyAR Unity 플러그인에 포함된 샘플 씬은 기본적으로 Built-in 렌더링 파이프라인의 머티리얼과 셰이더를 사용합니다. Unity는 이러한 머티리얼과 셰이더를 URP 호환 버전으로 자동 변환하지만, 일부 리소스는 렌더링 오류가 발생할 수 있으므로 Render Pipeline Converter를 사용하여 에셋 변환을 참조하여 수동으로 변환해야 할 수 있습니다.

비 URP 렌더링 오류

메뉴 Window > Rendering > Render Pipeline Converter를 클릭하고, Built-in to URP를 선택하여 변환 창을 엽니다. Material Upgrade 및 Readonly Material Converter를 체크 > 하단의 Convert Assets를 클릭합니다.

Render Pipeline Converter

변환이 완료되면 샘플 머티리얼 표시가 정상으로 돌아옵니다.

자주 묻는 질문

올바르게 구성되지 않으면 런타임에 카메라 화면이 표시되지 않으며, 종종 검은 화면으로 나타납니다. 그러나 추적 대상에 콘텐츠를 추가하면 해당 콘텐츠는 정상적으로 표시됩니다.

4000 이상 버전에서는 session이 Broken 상태로 진입하며, 화면이나 로그에 BrokenReason이 URP RenderPipeLineAsset not properly setup으로 표시됩니다:

Session_Broken_Caused_By_URP

이 문제를 해결하려면 본 문서에 설명된 대로 Universal Render Pipeline Asset을 올바르게 구성해야 합니다.

관련 주제