iPad 백그라운드 복귀 시 영상 loopback 오디오 무음 — 원인 분석 및 수정 (PPI-1158) 분석수정

1. 증상

iPad(iPadOS 26.3 + Chrome/CriOS 150 = WebKit) 게스트가 인트로 영상(오프닝송, video_dubutiki_long_introsong)을 재생하는데 소리가 나오지 않았다. 영상 화면과 재생 시간(currentTime)은 정상적으로 흐르고 muted:false·volume:1인데도 무음이었고, 아동이 도움 메뉴에서 '🙉 소리가 안 들려요'를 신고했다(재생 시작 약 121초 시점).

2. 배경 — iPad에서 영상 오디오는 직접 재생이 아니다

iPad에서는 마이크 EC(voice-processing) 활성 중 <video> 직접 재생이 시스템 덕킹으로 감쇠되는 문제(PPI-1101)를 피하기 위해, 영상 오디오를 WebRTC loopback(통화 카테고리, 덕킹 면제)으로 우회 출력한다. iOS 계열 게스트에서만 활성화된다.

3. 원인 — 백그라운드 복귀 후 공유 ctx가 suspended로 남음

영상 loopback은 AI 세션과 같은 공유 AudioContext(ensureSharedTtsAudioContext)를 탄다. 그런데 이 ctx를 resume하는 트리거가 ①명시적 호출(warmup/attach) ②pointerdown/touchend 제스처 뿐이고, 포그라운드 복귀(visibilitychange)에는 아무 것도 없었다. iOS는 백그라운드 진입 시 AudioContext를 suspend하는데, 복귀 후 아동이 탭하지 않으면 ctx가 suspended로 남아 loopback 그래프가 무음이 된다.

4. 진단 근거

5. 수정 (PR #921 · 브랜치 PPI-1158)

// video-audio-loopback.ts — 유일한 복구 경로: ctx를 running으로
resume(): void {
  if (this.disposed) return;
  const ctx = this.options.getAudioContext();
  if (ctx && ctx.state === "suspended") {
    void ctx.resume().catch(() => {});
  }
  const audio = this.audioElement;
  if (audio && audio.srcObject && audio.paused) {
    void Promise.resolve(audio.play()).catch(() => { /* resume 실패 로깅 */ });
  }
}

검증: loopback 유닛 테스트 전체 통과(신규 3건 포함) · tsc --noEmit 에러 없음. 실기기 검증은 dev 배포 후 진행.

6. 실기기 재현/검증 시나리오

기기: iPad + Chrome(CriOS) 우선(원 로그가 CriOS 150), Safari 병행.

A. 버그 재현 (수정 전)

• 게스트 입장 → 준비 팝업 "시작"(탭) → 인트로 영상 재생, 소리 정상 확인
• 재생 중 홈/앱 전환으로 30~40초 백그라운드 (원 로그 약 47초)
• 브라우저로 복귀, 화면을 탭하지 말고 관찰 → 화면·시간은 흐르는데 소리만 무음

B. 수정 검증 (PPI-1158)

• 1~3 동일 → 복귀 직후 탭 없이도 소리 회복이 기대 동작
• 백그라운드↔포그라운드 2~3회 반복 안정성
• 사이드이펙트: 에코/이중재생 없음 · 립싱크 · 선택 출력기기(헤드셋/스피커) 유지 · TTS(AI 대화 스텝) 복귀 후 정상

7. 후속(미반영) — 실기기 결과에 따라

• ② 탭 유도 안전망: video가 paused:false인데 공유 ctx.state!=="running"이 일정 시간 지속되면 "화면을 한 번 탭해주세요" 오버레이 — 전화/잠금 인터럽션으로 제스처 없는 resume이 거부되는 케이스까지 확실히 커버.
• ③ 진단 강화: ISSUE_DIAG에 공유 loopback ctx의 실제 state를 함께 기록 — 지금은 throwaway 프로브 ctx만 찍혀 원인 확정이 어려웠음.