---
title: SceneControlManager·UIManager 구현 및 씬 예제 검증
date: 2026-11-01T06:57:37.606Z
version: v1.0.0
status: 완료
state: complete
project: sampleprojectforunity
type: 작업 결과
report_kind: result
category: 작업 결과
summary: Addressables 기반 씬 전환·UI 수명 관리와 테스트 씬 2개, 로딩·화면·팝업 예제를 구현했습니다. 최종 Windows 플레이어 검사 57개와 실제 화면 검증을 통과했습니다.
format: tracefolio-v2
priority: normal
severity: normal
reporter: 미기록
assignee: 미지정
payload: ../assets/submissions/2026-11-01-result-20261101065737606-v1.0.0.json
---

## 작업 결과

구현·원본 반영·실제 Windows 플레이어 빌드 및 실행 검증을 완료했습니다. 요청하신 이름 SceneControlManager를 사용했습니다. Unity 6000.0.83f1, Addressables 2.9.1 기반입니다.

![Harbor 실제 실행 화면: 씬 이동·모달·실패 복구·중복 요청 버튼](../assets/scene-ui-20261101/scene-a.png)

![Observatory 실제 실행 화면: 두 번째 목적지와 기본 화면](../assets/scene-ui-20261101/scene-b.png)

## 변경 내용

### 적용 내용

SceneControlManager는 Additive 로드·준비·기본 화면 생성 후 이전 UI·씬을 정리하고 게임플레이를 시작합니다. 중복·동일·미등록 씬 요청을 거부하며 준비 또는 기본 화면 생성 실패 시 이전 활성 씬과 화면을 복원합니다.

UIManager는 Screen/Popup/Overlay 계층과 Scene/Global 수명을 구분합니다. 동시 열기는 하나의 인스턴스를 공유하고 닫기·씬 정리는 대기 로드 결과도 무효화합니다. InstantiateAsync/ReleaseInstance 수명을 관리하며 팝업과 전환의 입력 차단 소유권을 합칩니다. 프레임 끝 파괴 전에 먼저 비활성화하여 닫힌 UI가 클릭을 가로채지 않도록 했습니다.

SceneCatalog·UICatalog·SceneContent·UIView 계약을 추가했습니다. 기존 HUDManager와 게임 씬은 수정하지 않았습니다. Addressables 기존 그룹은 보존하고 SceneUI-Scenes·SceneUI-UI 전용 그룹을 추가했으며 Bootstrap 빌드 씬만 추가했습니다. 원본 Packages/manifest.json은 변경하지 않았습니다.

예제: Assets/Examples/SceneUI/Scenes/SceneUIBootstrap.unity에서 시작하여 ExampleA(Harbor)·ExampleB(Observatory)를 이동합니다. 씬 안의 화면 버튼으로 정상 이동, 모달, 의도된 준비 실패 복구, 동시 전환 요청을 시연합니다. 모달이 열리면 오브젝트 회전이 멈추며 Escape로 닫으면 재개합니다.

실행: Sample Project → Scene UI → Open Example Bootstrap → Play. Create or Refresh Examples 메뉴는 예제 에셋을 재생성하고 Build Verification Player는 콘텐츠와 Windows 실행 파일을 빌드합니다. 실행 파일은 프로젝트 Builds/SceneUIExample/SceneUIExample.exe에 보관했습니다.

API: await SceneControlManager.Instance.ChangeSceneAsync("ExampleB"); await UIManager.Instance.OpenAsync("ExamplePopup", "메시지"); UIManager.Instance.Close("ExamplePopup");

사용 문서: docs/documentation/26-developed-scene-ui.md. 씬 폴더에도 README를 추가했습니다.

![실제 Addressable 모달과 닫기 버튼](../assets/scene-ui-20261101/popup.png)

![실제 로딩 오버레이와 전환 단계 진행도](../assets/scene-ui-20261101/loading.png)

## 검증

최종 플레이어 결과: 57개 통과, 오류 0개. 실행 2026-11-01T15:55:14.3035899+09:00 → 2026-11-01T15:55:20.4027296+09:00. [실제 QA 결과 JSON](../assets/scene-ui-20261101/results.json). 정상 왕복과 6회 반복, 중복 요청 거부, 잘못된 ID, 모달 중첩·입력 정지·복원, 로드 도중 닫기, 씬 수명 정리, 준비 실패·기본 화면 누락·로딩 UI 누락 후 복구를 실행했습니다. 실제 EventSystem 레이캐스트로 버튼을 선택해 클릭 이벤트를 전달했고 InputSystem에 Escape 상태를 넣어 닫기를 검증했습니다.

반복 후 Bootstrap+목적지 씬 2개, 화면 인스턴스 1개, EventSystem 1개가 유지됐습니다. 이는 해당 시나리오의 개수 검사이며 전체 게임 메모리 누수 부재를 증명하지는 않습니다.

소스 16개 SHA-256과 예제 에셋·메타 24개를 검증 복사본과 원본에서 대조해 일치를 확인했습니다. [소스 대조](../assets/scene-ui-20261101/source-comparison.json), [에셋 대조](../assets/scene-ui-20261101/assets-comparison.json). 원본 에디터가 실행 중이어서 프로젝트 복사본에서 빌드했으며, 복사본의 MCP Git 재다운로드 대기는 설치된 동일 MCP 소스의 로컬 참조로 해결했습니다.

화면 5장은 직접 렌더 프레임을 캡처하고 모두 시각 검사했습니다. 1280×720, 34,359~104,187바이트의 원본 PNG이며 편집·리사이즈·별도 최적화 없이 200KB 목표를 충족합니다. [화면 크기·바이트·해시](../assets/scene-ui-20261101/visual-check.json).

초기 배치 캡처와 숨김 캡처는 검은 화면이라 각각 실패로 보존했습니다. 사용자 허용 후 실제 창을 표시하고 WaitForEndOfFrame 뒤 ScreenCapture로 캡처했으며 최종 QA는 검은 캡처도 거부합니다. [Unity 6 캡처 시점 문서](https://docs.unity3d.com/kr/6000.0/ScriptReference/WaitForEndOfFrame.html).

문서 27개·로컬 링크 908개 검증, 페이지 내부 이동·뒤로 가기·검색 검증, diff 공백 검사를 통과했습니다. 갱신 record 후 재빌드했으며 snapshotChanges는 0입니다.

![의도된 준비 실패 후 Observatory를 유지한 실제 복구 화면](../assets/scene-ui-20261101/recovery.png)

## 남은 사항

다른 플랫폼 실행, 원격 CDN·오프라인 재시도, 실제 게임 콘텐츠의 메모리 프로파일링은 미확인입니다. 기존 Pawn 입력은 자동 변경하지 않았으며 IsGameplayInputBlocked 또는 변경 이벤트에 연결할 수 있습니다. 기존 일반 빌드 설정의 누락된 SampleScene 경로는 보존했고 예제 전용 빌드 메뉴는 Bootstrap을 명시해 검증했습니다.

게임 프로젝트는 자동 커밋·푸시하지 않았습니다. 중앙 보고서와 첨부만 게시합니다.

교훈 검토: 변경 없음. 권한이 제한된 프로세스 조회의 빈 결과와 검은 캡처를 완료 근거로 삼지 않고 재검증했습니다. 기존 전역의 구체적 증거·실제 화면 검증 규칙에 포함되므로 중복 규칙은 추가하지 않았습니다.

## 작업 시간

- 제안 시간: 25~45분
- 실제로 완료된 시간: 시작 2026-11-01 15:30:16 KST. 최종 게임 실행 QA 완료 2026-11-01 15:55:20 KST(25분 4초). 보고서 작성 시점 2026-11-01 15:57:32 KST까지 1637초. 공개 배포 확인은 후속 메뉴얼과 최종 채팅에 기록합니다.
- XERJ: 미사용 — 제공된 XERJ MCP와 프로젝트 검색 스크립트가 없어 rg로 코드 검색을 수행했습니다.