Trouble Shooting

자주 발생하는 빌드·런처·렌더링 오류와 해결 방법.

VIVEN SDK 사용 중 자주 마주치는 오류와 해결책입니다.

빌드 시 오류가 생깁니다

대부분의 빌드 오류는 Addressables 설정 이 원인입니다.

1. Window → Asset Management → Addressables → Settings 로 이동합니다.
2. Catalog → Build & Load Paths 가 Remote 로 설정되어 있는지 확인합니다.
3. Catalog → Enable Json Catalog 체크박스를 비활성화했다가 다시 활성화합니다.
4. 다시 빌드를 시도합니다.

그래도 실패하면 개발환경 구축 에서 Addressables 2.3.16 · OpenXR 1.14.0+ 버전이 맞는지 확인하세요.

배치한 광원(Light)이 보이지 않습니다

• URP 기본 설정 으로 씬을 생성했는지 확인하세요. VIVEN 은 Universal Render Pipeline 전용입니다.
• Light 컴포넌트의 Mode 가 Baked 일 경우 라이트 매핑이 필요합니다. Realtime 또는 Mixed 로 변경하거나, Window → Rendering → Lighting → Generate Lighting 을 실행합니다.

Material 이 깨집니다 (분홍색으로 보입니다)

분홍색 Material 은 Unity 가 셰이더를 찾지 못했을 때 표시됩니다.

• 프로젝트가 URP 로 세팅되어 있는지 확인
• Material 의 Shader 를 Universal Render Pipeline/Lit 등 URP 호환 셰이더로 변경
• Shader 가 없다면 Edit → Render Pipeline → Universal Render Pipeline → Upgrade Project Materials to URP Materials 실행

Launcher 설치 문제 해결

기존 설치가 남아있는 경우

이전 버전이 이미 설치되어 있어 오류가 발생하는 경우:

1. 시작 → 설정 → 앱 → 앱 및 기능 으로 이동합니다.
2. 목록에서 Viven 앱을 찾아 제거 를 선택합니다.
3. 그래도 해결되지 않으면 C:\Users\{사용자}\AppData\Local\Twentyoz 폴더의 내용을 전부 삭제합니다.

.NET Core 7.0 설치

VIVEN Launcher 실행에 .NET Core 7.0 런타임이 필요합니다. 설치되어 있지 않다면 Microsoft 공식 다운로드 페이지 에서 받아 설치하세요.

드라이버 다운로드

VR 기기를 사용하는 경우 최신 드라이버가 필요합니다:

• NVIDIA 드라이버
• AMD 드라이버
• Intel 드라이버

Launcher Patch 오류 문제

런처가 패치가 있음에도 최신 버전으로 인식하지 않는 문제입니다.

해결 방법

1. VIVEN Launcher 의 톱니바퀴 버튼 을 클릭합니다.

2. 복구 버튼을 누릅니다.
3. 패치가 완료되면 시작하기 를 누릅니다.

해결되지 않는 문제

위 방법으로 해결되지 않는 경우 viven@twentyoz.kr 로 문의해주세요. 가능하면 다음 정보를 포함해주세요:

• 사용 중인 SDK 버전 (예: v2.1.21)
• Unity 버전
• 에러 메시지 전체 (콘솔 로그 포함)
• 재현 단계