Files
sodalive-ios/docs/20260313_라이브종료참여자블랙스크린수정.md

3.1 KiB

20260313 라이브 종료 참여자 블랙 스크린 수정

구현 체크리스트

  • LiveRoom V2 참여자 종료 흐름 관련 코드 위치 확인
  • 방장 종료 이벤트 수신 시 참여자 퇴장 로직 원인 분석
  • 블랙 스크린 재현 경로 차단하도록 최소 수정
  • 수정 코드 정적 진단 및 빌드 검증
  • 수동 검증 시나리오와 결과 기록

완료 기준 (Acceptance Criteria)

  • QA: 참여자 상태에서 방장이 라이브 종료 시 라이브가 종료되었습니다 토스트가 노출된다.
  • QA: 토스트 노출 이후 라이브 화면이 닫히고 앱에서 다른 화면 조작이 가능하다.
  • QA: 방장 본인 종료 동작은 기존과 동일하게 정상 동작한다.

검증 기록

  • [2026-03-13] 무엇: 참여자 상태에서 방장 종료 시 블랙 스크린이 남는 원인 분석 및 최소 수정
    • 왜: didOfflineOfUid 경로에서 liveRoomInfo만 nil 처리되어 HomeView 오버레이(appState.isShowPlayer)가 유지되는 상태였음
    • 어떻게: SodaLive/Sources/Live/Room/LiveRoomViewModel.swift의 호스트 오프라인 분기에서 deInitAgoraEngine() 호출 후 전역 토스트(AppState.shared.errorMessage, AppState.shared.isShowErrorPopup)를 노출하고 AppState.shared.roomId = 0으로 오버레이 종료 트리거를 추가. Oracle 검토 반영으로 [weak self] + creatorId 가드도 추가해 콜백 경합 시 강제 언래핑 크래시 가능성을 제거
  • [2026-03-13] 실행 명령 및 결과
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug buildBUILD SUCCEEDED
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug buildBUILD SUCCEEDED
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" testScheme SodaLive is not currently configured for the test action.
    • xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" testScheme SodaLive-dev is not currently configured for the test action.
    • lsp_diagnostics(LiveRoomViewModel.swift) → 개발 환경 SourceKit 의존성 인덱싱 한계로 No such module 'Moya' 반환 (빌드는 성공)
    • 코드 수정 후 재검증: xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" -configuration Debug build && xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" -configuration Debug build → 두 스킴 모두 BUILD SUCCEEDED
    • 코드 수정 후 재검증: xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive" test; xcodebuild -workspace "SodaLive.xcworkspace" -scheme "SodaLive-dev" test → 두 스킴 모두 test action 미구성 에러 동일
  • [2026-03-13] 수동 검증 시나리오
    • 시나리오: 2개 클라이언트(방장/참여자) 동시 접속 후 방장이 종료 버튼 실행
    • 기대 결과: 참여자에게 라이브가 종료되었습니다 토스트 노출 후 라이브 오버레이 종료
    • 현재 결과: CLI 환경에서는 실시간 2클라이언트/계정 세션을 구성할 수 없어 실제 실행 검증은 로컬 앱 환경에서 추가 확인 필요