fix(live): 라이브룸 전역 표시를 보정한다

2026-07-14 17:42:05 +09:00
parent dec6fb6fb8
commit 1b26bc28dd
6 changed files with 295 additions and 63 deletions
--- a/docs/20260714_라이브룸_전역_표시와_키보드_레이아웃_수정/plan-task.md
+++ b/docs/20260714_라이브룸_전역_표시와_키보드_레이아웃_수정/plan-task.md
@@ -0,0 +1,140 @@
+# 라이브룸 전역 표시와 키보드 레이아웃 수정 계획
+
+## 기준 문서
+
+- PRD: `docs/20260714_라이브룸_전역_표시와_키보드_레이아웃_수정/prd.md`
+- 코드 스타일: `docs/agent-guides/code-style.md`
+- 빌드/검증: `docs/agent-guides/build-test-verification.md`
+- 기존 외부 이동 확인 기록: `docs/plan-task/20260306_라이브룸외부이동확인다이얼로그.md`
+
+## 구현 원칙
+
+- `enterRoom` API와 성공 처리 대신 라이브룸의 렌더링 계층을 수정한다.
+- 전역 라이브룸은 한 곳에서만 생성한다.
+- 표시 계층 이동으로 가려질 수 있는 기존 외부 이동 확인 다이얼로그도 같은 최상위 계층으로 옮긴다.
+- 키보드 처리 방식은 새로 만들지 않고, 현재 수동 offset과 충돌하는 safe area 적용 위치만 바로잡는다.
+
+### Phase 1: 라이브룸 전역 표시
+
+- [x] **Task 1.1: 라이브룸 표시 지점을 앱 최상위로 이동**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/ContentView.swift`
+    - 수정: `SodaLive/Sources/V2/Main/MainView.swift`
+  - 작업 내용:
+    - `ContentView`의 `NavigationStack` 최상위에 전역 `ZStack` overlay를 구성한다.
+    - `AppState.shared.isShowPlayer`가 `true`이면 `NavigationStack` 위에 `LiveRoomViewV2`를 표시한다.
+    - `MainView` 내부의 기존 `LiveRoomViewV2` 표시 분기를 제거해 중복 생성을 방지한다.
+  - 검증 기준:
+    - 실행 명령: `rg -n "LiveRoomViewV2\\(" SodaLive/Sources/ContentView.swift SodaLive/Sources/V2/Main/MainView.swift`
+    - 기대 결과: 실제 표시 지점은 `ContentView` 한 곳에서만 확인된다.
+
+- [x] **Task 1.2: 외부 이동 확인 상태와 다이얼로그를 전역 계층으로 이동**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/App/AppState.swift`
+    - 수정: `SodaLive/Sources/ContentView.swift`
+    - 수정: `SodaLive/Sources/V2/Main/MainView.swift`
+  - 작업 내용:
+    - pending navigation action과 cancel action, 다이얼로그 표시 상태를 `AppState`에서 관리한다.
+    - `MainView`의 외부 이동 요청은 `AppState`에 위임한다.
+    - `ContentView`에서 기존 문구와 `SodaV2ActionModal`을 사용해 라이브룸 위에 확인 다이얼로그를 표시한다.
+    - 라이브 종료 후 pending action 실행 및 취소 시 상태 정리 의미를 유지한다.
+  - 검증 기준:
+    - 실행 명령: `rg -n "isShowLeaveLiveNavigationDialog|requestExternalNavigation|confirmExternalNavigation|cancelExternalNavigation|requestLiveRoomQuitForExternalNavigation" SodaLive/Sources/App/AppState.swift SodaLive/Sources/ContentView.swift SodaLive/Sources/V2/Main/MainView.swift`
+    - 기대 결과: 상태/처리는 `AppState`, 표시는 `ContentView`, 요청 위임은 `MainView`에서 확인된다.
+
+### Phase 2: 라이브 채팅 키보드 레이아웃 수정
+
+- [x] **Task 2.1: 키보드 safe area 무시 위치 보정 (초기 보정, Phase 4에서 대체)**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
+  - 작업 내용:
+    - 내부 hosted content에 적용된 `.ignoresSafeArea(.keyboard)`를 제거한다.
+    - `ScreenCaptureSecureContainer` 바깥에 `.ignoresSafeArea(.keyboard)`를 적용한다.
+    - 기존 `appliedKeyboardHeight`와 채팅 입력 offset은 유지한다.
+  - 검증 기준:
+    - 실행 명령: `rg -n "ScreenCaptureSecureContainer|ignoresSafeArea\\(\\.keyboard\\)|offset\\(y: -appliedKeyboardHeight\\)" SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
+    - 기대 결과: outer container가 키보드 safe area를 무시하고 수동 offset은 한 번만 적용된다.
+
+### Phase 3: 검증
+
+- [x] **Task 3.1: 변경 범위 및 정적 검증**
+  - 대상 파일:
+    - 확인: `SodaLive/Sources/ContentView.swift`
+    - 확인: `SodaLive/Sources/V2/Main/MainView.swift`
+    - 확인: `SodaLive/Sources/App/AppState.swift`
+    - 확인: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
+  - 작업 내용:
+    - 라이브룸 단일 표시, 외부 이동 확인 흐름, 키보드 modifier 위치를 검색한다.
+    - `git diff --check`로 whitespace 오류를 확인한다.
+  - 검증 기준:
+    - 기대 결과: PRD 범위를 벗어난 소스 변경이 없고 정적 검사 오류가 없다.
+
+- [x] **Task 3.2: Debug 빌드 검증**
+  - 대상 파일:
+    - 확인: `SodaLive.xcworkspace`
+  - 작업 내용:
+    - `xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build`를 실행한다.
+  - 검증 기준:
+    - 기대 결과: `** BUILD SUCCEEDED **`.
+
+- [ ] **Task 3.3: 수동 동작 검증**
+  - 대상 화면:
+    - 크리에이터 채널의 즉시 라이브 생성 화면
+    - 라이브룸 채팅 화면
+    - 라이브 중 푸시/딥링크 외부 이동 확인 화면
+  - 작업 내용:
+    - 즉시 라이브 생성 후 현재 화면 위에 라이브룸이 보이는지 확인한다.
+    - 키보드 표시 시 입력창이 키보드 바로 위에 있고 큰 빈 공간이 없는지 확인한다.
+    - 외부 이동 확인/취소 흐름을 확인한다.
+  - 검증 기준:
+    - 기대 결과: PRD Success Criteria를 충족한다.
+
+### Phase 4: 사용자 재검증 후 보정
+
+- [x] **Task 4.1: 보안 컨테이너를 화면 전체로 확장**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
+  - 작업 내용:
+    - `ScreenCaptureSecureContainer`에 무한 최대 frame을 부여한다.
+    - 컨테이너 바깥에서 모든 safe area를 무시해 UIKit 컨테이너 경계가 전체 화면을 차지하도록 한다.
+  - 검증 기준:
+    - 라이브룸 배경이 상태 표시줄과 홈 인디케이터 영역까지 덮는다.
+
+- [x] **Task 4.2: 내부 UIHostingController의 키보드 자동 회피 제거**
+  - 대상 파일:
+    - 수정: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
+  - 작업 내용:
+    - `UIHostingController.safeAreaRegions`를 `.container`로 제한한다.
+    - 일반 container safe area는 내부 UI에 유지하고 keyboard safe area만 제외한다.
+    - 기존 `appliedKeyboardHeight` offset은 유지한다.
+  - 검증 기준:
+    - 키보드 표시 시 내부 호스팅 크기 축소와 수동 offset이 중복되지 않는다.
+
+### Phase 5: 재검증
+
+- [x] **Task 5.1: 정적 검사 및 Debug 빌드**
+  - 대상 파일:
+    - 확인: `SodaLive/Sources/Live/Room/V2/LiveRoomViewV2.swift`
+  - 검증 기준:
+    - `git diff --check`가 성공한다.
+    - `SodaLive-dev` Debug 빌드가 `** BUILD SUCCEEDED **`로 완료된다.
+
+- [ ] **Task 5.2: 수정본 수동 동작 검증**
+  - 대상 화면:
+    - 전역 라이브룸 화면
+    - 라이브룸 채팅 입력 화면
+  - 검증 기준:
+    - 라이브룸이 화면 전체를 덮는다.
+    - 키보드 표시 시 입력창이 키보드 바로 위에 위치하고 큰 빈 공간이 없다.
+
+## 검증 기록
+
+- 2026-07-14: 코드 조사 결과 `LiveRoomViewV2`가 `MainView` 내부에 있어 navigation destination보다 아래에 놓이는 표시 계층 문제와, `ScreenCaptureSecureContainer` 바깥의 시스템 키보드 회피 및 내부 수동 offset이 중복될 수 있는 구조를 확인했다. 구현 및 빌드 검증은 아직 수행하지 않았다.
+- 2026-07-14: `LiveRoomViewV2` 표시를 `ContentView`의 `NavigationStack` overlay로 옮기고, 외부 이동 확인 상태와 다이얼로그도 같은 전역 계층으로 이동했다. `MainView`에서는 전역 상태에 요청만 위임하도록 정리했다.
+- 2026-07-14: `.ignoresSafeArea(.keyboard)`를 내부 hosted content에서 `ScreenCaptureSecureContainer` 바깥으로 이동해 시스템 키보드 회피와 기존 수동 offset이 중복되지 않도록 했다.
+- 2026-07-14: `rg`로 라이브룸 단일 표시 지점, 외부 이동 확인 흐름, 키보드 modifier 위치를 확인했고 `git diff --check`가 오류 없이 완료됐다.
+- 2026-07-14: sandbox 환경의 CoreSimulator/XPC 접근 제한으로 최초 빌드가 소스 컴파일 전에 중단됐다. 동일 명령을 허용된 환경에서 `-derivedDataPath /tmp/SodaLiveDerivedData`와 함께 다시 실행했으며, 전체 빌드와 최종 변경 후 증분 빌드 모두 `** BUILD SUCCEEDED **`를 확인했다.
+- 2026-07-14: Task 3.3의 실제 즉시 라이브 생성, 채팅 키보드, 라이브 중 외부 이동 확인/취소는 기기 또는 시뮬레이터 수동 QA가 필요해 미실행 상태로 남겼다.
+- 2026-07-14: 사용자 재검증에서 라이브룸이 화면 전체를 덮지 않고 키보드 위 빈 공간도 남는 것을 확인했다. 바깥 `ScreenCaptureSecureContainer`와 내부 `UIHostingController`가 별도의 safe area 경계를 가지므로 바깥 modifier 이동만으로는 부족했다.
+- 2026-07-14: `ScreenCaptureSecureContainer`를 전체 화면 frame으로 확장하고 모든 바깥 safe area를 무시하도록 보정했다. 내부 `UIHostingController.safeAreaRegions`는 `.container`로 제한해 상태 표시줄/홈 인디케이터 safe area는 유지하면서 키보드 자동 회피만 제외했다.
+- 2026-07-14: 보정 후 `git diff --check`가 성공했고, `xcodebuild -workspace SodaLive.xcworkspace -scheme SodaLive-dev -configuration Debug -derivedDataPath /tmp/SodaLiveDerivedData build`에서 `** BUILD SUCCEEDED **`를 확인했다. Task 5.2의 실제 화면 확인은 사용자 수동 재검증이 필요하다.