PPI-1482 리소스 로딩 진행 바: As-Is → To-Be
마지막 업데이트 2026-11-19
진행 바 기준을 파일 개수에서 전체 바이트로 바꿉니다. 숫자 x / y는 그대로 파일 개수입니다. PR #1342 · 2026-11-19
배경 사례: 강예준 2회기 리소스 로딩 8/21 정체 원인 분석 (9번째 영상 수신 중 바 정체)
As-Is
바 = current / total (파일 수)
큰 영상 1개를 받는 동안 바가 멈춤 → 아동·보호자가 멈춘 줄 알고 재입장 반복
To-Be
바 = 받은 바이트 / 전체 바이트 (ratio)
받는 중인 파일의 진행분까지 반영 → 저속 회선에서도 바가 계속 차오름. 진행자 모니터도 같은 비율 표시
시뮬레이션 (가정: 파일 21개, 100MB, 8Mbps)
0초
칸 너비 = 파일 크기. 9번째 파일이 60MB 영상(전체의 60%), 나머지는 2MB씩
아동 로딩 화면
As-Is 파일 개수
To-Be 바이트 (250ms 간격 갱신)
진행자 모니터 (카드뷰·포커스뷰)
As-Is 파일 개수
To-Be 바이트 5% 단위
데이터 흐름 변경
아동 화면
/api/resources/urls
+ 화질별
+
파일 비중 합산 →
250ms throttle→ ResourceLoadingScreen
+ 화질별
size→
fetchResumable+
onBytes(received,total)→
useResourceCache파일 비중 합산 →
onByteProgress(ratio)→
useLessonDataLoader250ms throttle→ ResourceLoadingScreen
ratio ?? current/total
진행자 모니터
useLessonDataLoader
파일 수 변화·5% 단위만 publish→ GUEST_CACHING_PROGRESS
+
ratio 검증 → Redis 저장→ useMonitorSession
카드뷰·포커스뷰 바
파일 수 변화·5% 단위만 publish→ GUEST_CACHING_PROGRESS
+
ratio (0~1)→
socket 핸들러ratio 검증 → Redis 저장→ useMonitorSession
cachingProgressFromEvent→
MonitorMediaDisplay카드뷰·포커스뷰 바
초록 테두리 = 이번 PR에서 바뀐 지점. 크기를 모르는 파일은 크기를 아는 파일의 평균을 비중으로 씁니다. 비율은 뒤로 가지 않습니다.
호환성 (배포 순서 무관)
| 조합 | 아동 화면 | 진행자 모니터 |
|---|---|---|
| 새 web + 새 socket | 바이트 기준 | 바이트 기준 (5% 단위) |
| 새 web + 구 socket | 바이트 기준 | 파일 개수 기준 (socket이 ratio 무시) |
| 구 아동 화면 + 새 socket | 파일 개수 기준 | 파일 개수 기준 (ratio 없음) |
| size 정보 없는 리소스 | 평균 비중으로 계산, 전부 없으면 파일 개수와 같은 결과 | |
비용·남은 확인
- Redis 쓰기: 로딩 1회당 비율 이벤트 최대 약 20회 증가 (5% 단위)
- 진행자 화면 반영에는 socket 배포 필요
- 미확인: 저속 회선(1Mbps) 브라우저 확인, 저사양 Android 실기기 확인