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 실행

해결되지 않는 문제

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

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