모바일 제공 방식 검토 · 2026-11-19

아동 화면 모바일 제공 방식 비교 — 웹 · PWA · 하이브리드 · 네이티브

마지막 업데이트 2026-11-19

대상: 아동 수업 화면(/client-guest)을 모바일에서 어떤 형태로 제공할지 정하려는 개발자·PM

모바일 문제의 대부분은 iOS WebKit의 오디오 제어 한계에서 나온다. 앱 껍데기(WebView, PWA)만 씌우면 진입 경로·전체 화면 문제는 풀리지만 음성 안정성은 그대로다. 음성 문제를 실제로 풀려면 음성 세션을 네이티브 SDK로 옮기는 하이브리드(H2)가 필요하다.

네트워크 안정성은 제공 방식과 거의 별개다. 443 포트 우회 경로, 재접속 시 세션 유지 같은 서버·프로토콜 쪽 개선이 웹·앱 모두에 이득이다. 추천 순서는 네트워크 개선 + PWA 1단계 → iPad H2 PoC → 필요 시 확대이며, 순수 네이티브는 보류한다.

1. 현재 웹에서 모바일 때문에 생긴 비용

문제근거원인
TTS 무음·재생 고착 (AudioContext가 suspended·interrupted로 남음)#838, tts-player.ts:471iOS는 사용자 제스처 밖에서 만든 AudioContext를 멈춰 둠
마이크를 켜면 다른 소리가 작아짐(덕킹) → TTS·영상 소리를 WebRTC loopback으로 우회#845, #870, #931, meet-video.tsx:81웹에서는 iOS 오디오 세션(AVAudioSession)을 직접 정할 수 없음
백그라운드 복귀 시 무음, 재접속 직후 무음 마이크·검은 카메라#921, meet-video.tsx:135, use-local-media-stream.ts:10앱 전환 같은 중단 이벤트를 웹이 제대로 받지 못함
iPad AI 음성 밀림, 저전력 모드 감지#1084, use-low-power-mode-probe.ts저전력 모드에서 화면 갱신(rAF)이 30fps로 고정되고 디코딩도 느려짐
제스처 밖 출력 기기 변경(setSinkId) 금지#979, ai-audio-output-sink.ts:21iOS 정책
카카오·네이버 인앱 브라우저 리다이렉트, "Chrome에서 열기" 유도, 미지원 기기 안내#894, #1280, #1286, #835아동이 어떤 브라우저로 들어오는지 통제할 수 없음
Android 태블릿 데스크톱 모드에서 재생 정체#1319기기·브라우저 모드가 너무 다양함

iOS에서는 Chrome도 내부 엔진이 WebKit이다(EU 제외). "Chrome에서 열기"(#894)를 해도, WebView 하이브리드(WKWebView)로 감싸도, PWA로 홈 화면에 설치해도 위 오디오 제약은 그대로 남는다.

관련 사례: iPad AI 음성 “밀림” 재현 — 저전력 모드 × WebAudio 렌더 부하, setSinkId() 호출 시 시스템 볼륨 슬라이더 미동작 분석.

2. 한눈에 비교

하이브리드 앱은 성격이 크게 다른 두 가지로 나눈다. H1은 기존 웹 화면을 WebView로 감싸기만 하는 얇은 껍데기, H2는 화면은 WebView로 두고 음성 세션만 네이티브 LiveKit SDK로 처리하는 방식이다.

항목현재 웹PWA하이브리드 H1하이브리드 H2네이티브 (Swift / Kotlin)
iOS 음성 안정성 (덕킹, AudioContext 멈춤, 출력 기기)✗ 우회 코드로 버팀✗ 웹과 같음✗ 같은 WebKit✓✓
백그라운드·중단 후 복구△ 추정에 의존△ 더 빨리 멈출 수 있음△✓✓
네트워크 안정성서버·프로토콜 쪽 개선이 핵심 (방식과 거의 무관)약간 유리 (네트워크 전환 감지)약간 유리
진입 경로 고정 (인앱 브라우저 회피)✗✓ (설치 후)✓✓✓
전체 화면, 오조작 방지✗✓✓✓✓
화면 꺼짐 방지·권한 유지△△ iOS는 확인 필요✓✓✓
리소스 캐시·로딩 속도△✓ (service worker)✓✓✓
기존 코드 재사용100%거의 100%약 95%UI는 재사용, 미디어 계층은 새로 작성거의 없음
배포 속도즉시즉시UI는 즉시, 껍데기만 심사UI는 즉시, 음성 부분은 심사전부 심사
기능 일치 부담없음없음낮음중간 (웹-네이티브 연동 계약)높음 (웹·iOS·Android 3벌)
스토어 정책 (아동 앱, 외부 분석 SDK)해당 없음해당 없음적용적용적용
새로 생기는 위험없음 (현행 유지)캐시 때문에 서버-클라이언트 버전 불일치Android WebView 버전 편차네이티브와 WebView가 마이크를 함께 씀 (mediasoup 경로)플랫폼마다 기능이 어긋남
필요 인력현 팀현 팀현 팀 + 약간의 모바일 지식모바일 엔지니어 1명 이상플랫폼별 전담
도입 비용0매우 낮음낮음중간~높음매우 높음

3. 방식별 장단점

현재 웹

PWA

하이브리드 H1 (얇은 WebView 껍데기, Capacitor 등)

하이브리드 H2 (WebView UI + 네이티브 음성)

순수 네이티브 (Swift / Kotlin)

4. PWA 웹앱으로 제공할 때의 장점과 단점

현재 public/에 icon-192x192.png, icon-512x512.png는 있지만 manifest와 service worker는 없다. 즉 지금은 PWA가 아니다. 과거에 next-pwa로 PWA를 운영하다가 Server Action 오류 때문에 제거한 이력이 있다(아래 4-4).

한 줄 요약: PWA는 운영 안정성(진입·오조작·자료 로딩)을 적은 비용으로 높인다. 미디어 안정성(iOS 음성, WebRTC·네트워크)은 바뀌지 않는다. 대신 홈 화면 앱은 잘 새로고침되지 않아 배포 버전 불일치 위험이 커지므로 선행 작업이 필요하다.

4-1. 장점

장점설명기존 문제와의 관련
진입 경로 고정홈 화면 아이콘으로 바로 실행되어 카카오·네이버 인앱 브라우저나 지원하지 않는 브라우저를 거치지 않는다.#1280, #1286, #835의 리다이렉트·차단 처리 부담 감소
아동 오조작 감소display: standalone로 주소창·탭이 없어 뒤로 가기, 새로고침, 탭 전환으로 수업이 끊기는 일이 준다.수업 중 이탈·재입장
화면 공간 확보주소창 높이만큼 화면이 넓어진다.낮은 화면에서 입장 입력칸이 잘리는 문제(#1334), 가로 레이아웃(#955)
화면 꺼짐 방지Screen Wake Lock API를 쓸 수 있다. iOS는 버전별 지원 차이와 홈 화면 앱 버그 이력이 있어 실기기 확인이 필요하다.수업 중 화면 꺼짐
자료 로딩 안정화service worker로 app shell, 아바타·자료 영상을 미리 캐시하면 입장이 빨라지고 약한 회선에서 로딩이 덜 멈춘다.리소스 로딩 정체, use-waiting-resource-prefetch 확장
Android는 앱에 가까움Chrome이 설치형 앱(WebAPK)으로 만들어 주고 엔진도 Chrome 그대로다.Android 경험이 가장 크게 개선
수업 알림웹 푸시. iOS는 16.4 이상이고 홈 화면에 설치한 경우에만 된다.수업 시작 알림
낮은 비용스토어 심사가 없고 배포는 기존 웹 배포와 같다. 코드 재사용 거의 100%.웹 개발 속도 유지

4-2. 단점·한계

단점설명
iOS 음성 문제 그대로홈 화면 앱도 WebKit이다. 덕킹 우회 loopback, AudioContext 멈춤, setSinkId 제약, 저전력 모드 30fps가 모두 남는다(1장).
WebRTC·네트워크 변화 없음연결 실패, 업링크 부족, 두 SFU 릴레이 구조의 영향은 그대로다(5장).
기기 성능 문제 변화 없음저사양 기기의 영상 디코딩 과부하(DECODE_OVERLOAD) 등은 같다.
백그라운드에서 더 빨리 멈출 수 있음iOS 홈 화면 앱은 Safari 탭보다 백그라운드 정지가 빠른 경향이 있다.
테스트 환경 증가iOS 홈 화면 실행 모드는 Safari 탭과 동작이 미묘하게 다르다(과거 권한 반복 요청, 오디오 출력 경로 차이 버그). QA 표에 별도 항목이 필요하다.
iOS 설치 번거로움설치 팝업이 없어 공유 → "홈 화면에 추가"를 직접 해야 한다. 보호자용 설치 안내가 필요하다.
입장 흐름 변경 필요홈 화면 아이콘은 항상 같은 start_url로 열린다. 수업마다 링크가 다른 현재 구조와 맞추지 않으면 진입 실패가 오히려 늘 수 있다.
배포 버전 불일치 (가장 큰 위험)서버는 새 버전인데 클라이언트는 옛 HTML·JS로 실행되는 문제. service worker 캐시가 직접 원인이 되고, service worker가 없어도 홈 화면 앱은 잘 새로고침되지 않아 "배포를 넘긴 열린 화면"이 브라우저 탭보다 훨씬 자주 생긴다. 4-4 참고.

4-3. 안정성 관점 정리

장애 유형PWA 효과
진입 실패 (인앱 브라우저, 미지원 브라우저)✓ 개선
아동 오조작에 의한 이탈 (뒤로 가기, 탭 전환, 화면 꺼짐)✓ 개선
자료·리소스 로딩 정체✓ 개선 (service worker 도입 시)
iOS 음성 무음·덕킹·밀림✗ 변화 없음
WebRTC 연결 실패·끊김, 업링크 부족✗ 변화 없음
배포 직후 Server Action·청크 로딩 실패⚠ 악화 가능 (선행 작업 필요)

최근 장애에서 앞쪽 세 유형의 비중이 크면 체감 효과가 크고, 음성·연결 비중이 크면 효과가 작다.

4-4. 과거 Server Action 문제와 현재 상태

시점커밋내용
2025-12-096a1cb3a8 (#43)next-pwa 제거. 당시 설정은 register: true, skipWaiting: true로, service worker(workbox)가 페이지를 캐시해 옛 HTML·JS가 계속 실행된 것으로 보인다.
2025-12-175a95e7a1 (#53)"server action not found" 수정. 설치된 service worker를 전부 해제하고 새로고침하는 ServiceWorkerCleanUp 추가, HTML에 no-cache 헤더.
2026-01-054ff912ff (#83)배포 workflow에서 Server Actions 빌드 키 고정.
2026-01-273688d2b4 (#155)게스트 세션의 sendSdp를 Server Action에서 API Route로 전환.
2026-10~11#1244, #1256Staging·Prod 빌드 키를 AWS SSM 버전으로 고정.

해결된 것: service worker가 없어 옛 번들이 오래 남는 경로가 없고, 예전에 설치된 service worker도 app/layout.tsx:45의 ServiceWorkerCleanUp이 지운다. 빌드 키 고정으로 HA 노드 간·키 불일치에 의한 실패 원인도 없어졌다.

남아 있는 위험:

  1. 아동 입장 화면이 아직 Server Action을 직접 호출한다: app/client-guest/page.tsx:16에서 @/lib/dynamodb의 getLesson을 import해 :232, :451에서 호출한다.
  2. 배포를 넘긴 열린 화면은 보장되지 않는다: docs/server-actions-build-key.md에 "버전 사이에서 열린 탭의 Server Actions ID 호환성을 보장하지 않습니다"라고 명시되어 있다.
  3. HTML 캐시 헤더가 다시 느슨해졌다: #53의 no-cache가 지금은 private, max-age=0, stale-while-revalidate=300이다(next.config.mjs:44~50, #299에서 변경). 배포 후 최대 5분간 옛 HTML이 먼저 보일 수 있다(브라우저별 지원 차이가 있어 추정).
  4. 자동 복구 장치가 없다: Failed to find Server Action·ChunkLoadError를 감지해 새로고침하는 처리를 코드와 ppi-docs에서 찾지 못했다. 최근 장애 기록도 없지만, 장애가 없어서인지 기록되지 않아서인지는 구분할 수 없다.

PWA 재도입 시 충돌: 루트 레이아웃의 ServiceWorkerCleanUp은 모든 service worker를 해제하고 새로고침한다. 이 상태로 새 service worker를 넣으면 설치 → 해제 → 새로고침이 반복될 수 있으므로 먼저 정리해야 한다(manifest만 쓰는 1단계에서는 그대로 둬도 된다).

4-5. 옛 버전이 남는 원리 — Server Action과 PWA

한 문장 요약: 브라우저에 남은 옛 버전 화면이 새 버전으로 바뀐 서버에 옛 Server Action ID로 요청을 보내서 실패한다. PWA는 이 "옛 화면이 남아 있는 시간"을 크게 늘린다.

[빌드 시점]
  "use server" 함수(getLesson 등)마다 Action ID(해시)를 만든다
  ├─ 서버: ID → 실제 함수 대응표(manifest)
  └─ 클라이언트 JS 번들: getLesson() 호출을 "ID abc123으로 POST"로 바꿔 넣음

[배포 후]
  옛 화면 ──POST (Next-Action: abc123, 옛 ID)──▶ 새 서버 (manifest엔 xyz789만 있음)
                                                 └▶ "Failed to find Server Action"

과거 PWA가 이 문제를 키운 이유

  1. service worker 캐시: 당시 next-pwa(workbox)가 HTML·JS를 캐시해 다음 실행 때 캐시에서 먼저 꺼냈다. 서버를 배포해도 새 service worker가 받아지고 새로고침될 때까지 옛 버전이 유지됐다. "코드 업데이트가 반영 안 된다"는 현상이 이것이다.
  2. skipWaiting: true: 새 service worker가 즉시 교체되지만 열린 화면은 옛 JS 그대로라, 한 세션 안에 옛 화면·새 service worker·새 서버가 섞일 수 있었다.
  3. 홈 화면 앱은 거의 새로고침되지 않음: 주소창·새로고침 버튼이 없고 앱 전환 뒤 메모리에서 그대로 이어진다. 며칠 전 화면이 살아 있다가 Server Action을 부르면 실패한다(service worker와 무관).
  4. 빌드 키 불일치 (PWA와 별개): 빌드 키 고정(#83, #1244, #1256) 전에는 빌드마다 키가 달라 배포 사이·노드 사이 호환이 더 쉽게 깨졌다.

당시 장애 로그는 확인하지 않았으므로 각 원인의 기여도는 추정이다.

설정 단계별로 옛 JS가 남는가

구성옛 JS가 남는가이유
manifest만 (홈 화면 추가, standalone)앱이 살아 있는 동안만캐시 장치가 없어 새로 실행하면 서버에서 HTML을 다시 받는다. 다만 백그라운드에서 다시 열면 이전 페이지가 그대로 이어진다. 열린 탭과 같지만 더 오래 간다.
manifest + service worker (해시 정적 파일만 캐시)위와 같음_next/static/…는 파일 이름에 해시가 있어 새 HTML은 새 파일을 요청한다. 오히려 안전하고 빠르다.
manifest + service worker (HTML까지 캐시)실행할 때마다캐시된 옛 HTML이 옛 JS를 불러온다. 새 service worker가 적용되기 전까지 앱을 껐다 켜도 옛 버전이다. 과거 next-pwa 문제가 이 유형으로 보인다.

4-6. service worker 캐시 설정 원칙

HTML 캐시를 끄면 큰 원인은 사라진다. 하지만 "HTML만 캐시 안 하면 끝"은 아니다.

HTML 말고도 캐시하면 안 되는 것

요청이유
RSC 페이로드 (?_rsc= 쿼리 또는 RSC: 1 헤더)App Router가 화면 이동 때 HTML 대신 받는 데이터로, JS 청크와 Server Action ID 정보를 담는다. 캐시하면 HTML 캐시와 같은 문제가 생긴다. 가장 놓치기 쉽다.
오프라인 대체 화면"네트워크 우선, 실패 시 캐시된 HTML"이면 약한 회선에서 옛 HTML이 다시 나온다. 대체 화면은 고정 오프라인 안내 페이지로 한다.
미리 캐시(precache) 목록workbox·next-pwa류 도구가 빌드 산출물을 자동으로 미리 캐시한다. HTML·RSC가 목록에 없는지 확인한다.
API·Server ActionServer Action은 POST라 Cache API에 저장되지 않는다. GET API는 runtime 캐시 규칙에서 명시적으로 제외한다.

그래도 남는 문제

  1. 살아 있는 페이지: 백그라운드에서 다시 열린 앱은 옛 JS 그대로다. 캐시와 무관하므로 Server Action 제거와 빌드 ID 비교 후 새로고침이 여전히 필요하다.
  2. 삭제된 청크 요청: 옛 화면이 새 배포에서 지워진 청크를 불러오면 ChunkLoadError. 해시 정적 파일 캐시가 이를 줄이지만, 처음 받은 적 없는 청크는 막지 못하므로 실패 시 새로고침 안전장치가 필요하다.
  3. service worker 교체 시점: skipWaiting + clients.claim으로 수업 도중 교체되면 캐시 규칙이 세션 중간에 바뀐다. 수업 밖에서 교체한다.
  4. ServiceWorkerCleanUp: 루트 레이아웃이 모든 service worker를 해제·새로고침하므로 먼저 정리한다.

권장 설정 요약

navigation(HTML) 요청       → 항상 네트워크 (캐시 저장 X, 캐시 대체 X)
RSC 요청 (?_rsc / RSC:1)    → 항상 네트워크
/api/*, POST                → service worker 통과 (관여 X)
/_next/static/* (해시 파일) → cache-first (변하지 않는 파일이라 안전)
아바타·자료 영상             → cache-first + 용량 상한
새 service worker           → 대기 후 수업 밖에서 교체 (skipWaiting 자동 사용 X)

이 설정에 Server Action 제거와 빌드 ID 비교 후 새로고침을 더해야 과거 같은 업데이트 누락을 사실상 막을 수 있다. 캐시 설정만으로는 부족하다.

4-7. PWA와 service worker의 관계

service worker는 PWA와 별개로 쓸 수 있다. HTTPS 사이트라면 navigator.serviceWorker.register()로 일반 브라우저 탭에서도 등록할 수 있고, manifest나 홈 화면 설치가 필요 없다. "PWA"는 둘을 합쳐 앱처럼 쓰는 방식을 부르는 이름일 뿐이다.

구성 요소역할서로 필요한가
manifest홈 화면 설치, 전체 화면(standalone), 아이콘, 시작 주소service worker 없이 단독으로 된다. iOS 홈 화면 추가는 원래 service worker가 필요 없었고, Chrome도 최근 버전부터 설치 조건에서 service worker 필수 요건을 없앴다(버전별 차이 있음).
service worker요청 가로채기, 캐시, 웹 푸시, 백그라운드 처리manifest 없이 일반 브라우저 탭에서도 동작한다.
도입 방식효과위험
A. manifest만진입·오조작 개선거의 없음
B. service worker만 (4-6 규칙 적용)자료 로딩 개선캐시 규칙을 잘못 정하면 버전 불일치
A + B (완전한 PWA)위 효과 모두, iOS 저장소 삭제 제외B와 같음

어느 방식이든 선행 작업은 같다: 아동 경로의 Server Action 제거, 빌드 ID 비교 후 새로고침, ServiceWorkerCleanUp 정리(4-8).

4-8. 도입 전 선행 작업

  1. 아동 경로에서 Server Action 제거: client-guest/page.tsx의 getLesson을 API Route로 바꾼다(#155의 sendSdp와 같은 방식). 아동 화면에서 Server Action ID 문제가 원천적으로 사라진다.
  2. HTML 캐시 헤더: 최소한 /client-guest는 no-cache로 되돌릴지 검토한다.
  3. 버전 감지: 앱이 다시 열릴 때(visibilitychange)나 수업 입장 전에 서버 빌드 ID와 비교해, 다르면 수업 중이 아닐 때만 새로고침한다. ChunkLoadError·Server Action 실패를 잡아 한 번 새로고침하는 안전장치도 넣는다.
  4. ServiceWorkerCleanUp 정리: 새 service worker를 넣기 전에 수정한다.
  5. service worker 캐시 원칙(넣는 경우): HTML·API·Server Action 요청은 캐시하지 않고(network-first), 해시가 붙은 정적 파일과 미디어만 캐시한다(cache-first). 과거처럼 skipWaiting으로 수업 중에 갑자기 교체하지 않는다.

1번과 3번은 PWA와 상관없이 현재 웹에도 이득이다.

4-9. 함께 결정할 것

  1. iOS 브라우저 정책(#894): iOS 16.4 이상은 Chrome에서도 홈 화면 추가가 되지만 엔진은 어느 쪽이든 WebKit이다. "Chrome 유도"를 "홈 화면 앱 유도"로 바꿀지 정한다.
  2. 입장 방식: 코드 입력·기기 등록으로 "오늘 수업"을 찾는 흐름이나, 링크를 설치된 PWA로 넘기는 흐름 중 하나가 필요하다.
  3. 적용 범위: manifest scope를 /client-guest로 제한해 치료사·운영자 화면에 영향을 주지 않는다.

5. 네트워크 안정성 방향

웹이든 앱이든 같은 Wi-Fi·LTE 위에서 같은 libwebrtc를 쓴다. 네이티브의 이점은 네트워크 전환 감지(iOS NWPathMonitor, Android ConnectivityManager)로 미리 ICE 재시작을 하는 정도이고, 기관 방화벽·혼잡 Wi-Fi·NAT 문제는 그대로다. 기존 검토는 2026-11-10 PPI 네트워크 불안정 대책 — 착수 항목 코드 적용성 검토, 2026-11-10 PPI 네트워크 불안정 대책 착수 백로그를 참고한다.

코드에서 확인한 현재 상태

영역현재위치
실패 원인 진단연결 실패 시 ICE_DIAGNOSTIC_SUMMARY로 원인 분류 로그docs/ice-diagnostics.md (PPI-1327)
TURNMetered 자격 증명을 받아 기본 서버와 합침hooks/use-ice-servers.ts, app/api/ice-servers/route.ts
LiveKit 연결 설정합친 설정을 rtcConfig로 LiveKit에 넘김use-guest-page-session.ts:537 → livekit-client-session.ts:4159
LiveKit 재연결재연결 중 → 복구 이벤트 처리, 복구 후 마이크 입력 상태 재조정livekit-client-session.ts:3325~
mediasoup 전송announced IP로 UDP·TCP를 직접 받음apps/socket/src/sfu-config.ts, transportManager.ts:57
ICE 재시작 훅use-ice-restart.ts가 있지만 사용하는 곳이 없음grep 결과
Agent 연결 끊김 처리아동이 퇴장하면 AI 세션을 닫고 job도 즉시 종료agent.py:382, agent.py:2700
업링크 대역폭대역폭이 낮으면 카메라 인코딩 단계적 하향#1143

추천 방향 (우선순위 순)

  1. 측정: ICE_DIAGNOSTIC_SUMMARY와 LiveKit 이벤트(connection_reconnecting·recovered·disconnected)를 기관·기기·통신 유형별로 집계한다. udp_path_unresponsive가 많으면 2번, 복구는 되는데 수업이 끊기면 3번, 연결은 유지되는데 소리가 끊기면 4번이 핵심이다.
  2. 443 포트 우회 경로: LiveKit 내장 TURN을 TLS 443으로 열거나 Metered turns:…:443이 실제로 선택되는지 확인한다. 클라이언트가 rtcConfig.iceServers를 넘기면 LiveKit 서버가 내려주는 TURN 목록이 무시될 수 있다(SDK 동작 확인 필요, 추정). mediasoup 포트가 막힌 환경에서 TURN 중계가 적용되는지도 경로별로 확인한다. 기관 IT용 허용 도메인·포트 목록 문서를 만든다.
  3. 장애 복구: LiveKit 완전 재접속(full reconnect) 시 participant 퇴장으로 처리되면 AI 세션과 대화 문맥이 사라질 수 있다(close_on_disconnect + 즉시 job 종료, 코드 기반 추정이며 끊김 재현 테스트로 확정 필요). 짧은 유예 시간 동안 세션을 유지하거나, 재접속 시 대화 이력·현재 스텝을 session config로 넘기는 방안을 검토한다. mediasoup은 disconnected 시 restartIce 흐름을 연결하고, socket.io 재접속 뒤 producer·consumer 재생성 경로를 점검한다. 재연결 중에는 아동에게 상태를 보여 주고 AI 발화를 잠시 멈춘다.
  4. 음성 우선 품질 저하: 음성에 Opus FEC와 RED(red, dtx publish 옵션)가 켜져 있는지 확인한다. 대역폭이 부족하면 아바타 영상 → 카메라 → 오디오 순으로 포기하는 정책을 정한다. 업링크 쪽은 PPI 업링크 stall 웹 대처방안을 참고한다.
  5. 수업 전 네트워크 점검: 장치 점검 화면(#1129)에 실제 서버 대상 UDP·TCP·TURN/TLS 연결 테스트와 RTT·손실률 측정을 추가하고, 결과가 나쁘면 5GHz Wi-Fi 전환 같은 안내를 미리 보여 준다.
  6. 서버 측: LiveKit·SFU 리전과 증설 여력, Redis/Valkey 단일 장애점 여부를 운영 환경에서 확인한다(LiveKit 서버 설정은 저장소에 없음).

관련 사례: 석우주 8회기 아동 화면 미표시·AI 세션 실패 — iPad WebKit ICE 후보 미수집 원인 분석.

6. 공통 고려사항 (앱 방식 선택 시)

7. 추천 경로

  1. 지금: 네트워크 개선(443 우회 경로, 재접속 시 세션 유지, mediasoup ICE 재시작)과 PWA 1단계(manifest·standalone·scope, Wake Lock, 설치 안내. service worker 제외)를 병행한다. 비용이 작고 웹·앱 어느 쪽에도 이득이 남는다. PWA 전에 아동 입장 화면의 Server Action(getLesson)을 API Route로 바꾸고 버전 감지를 넣는다(4-8).
  2. 실기기 측정: 홈 화면 실행 모드를 iOS·Android에서 QA하고, 진단 로그에 실행 모드(display-mode)를 넣어 Safari 탭과 지표를 비교한다. 효과가 확인되면 4장의 캐시 원칙으로 service worker를 추가한다.
  3. iOS 음성 문제가 여전히 주요 원인이면: iPad 기준 H2 PoC(2~4주 규모)로 덕킹·무음·백그라운드 복귀·저전력 지표를 기존 웹과 비교하고, mediasoup 경로와 마이크 공유 가능성을 확인한다. 효과가 확인되면 iOS부터 H2로 출시하고 Android는 웹·PWA를 유지한다.
  4. H1은 건너뛴다: PWA와 효과 차이가 작다. 기관 기기 일괄 배포처럼 스토어 배포 자체가 필요할 때만 검토한다.
  5. 순수 네이티브는 보류: 제품 UI가 안정되고 모바일 전담 인력이 생긴 뒤 검토한다.

근거와 검증 범위

관련 PPI 문서