iPhone 아바타 미노출과 흰 화면 조사
마지막 업데이트 2026-11-16
13회기 고객 영상과 아동·모니터 브라우저 로그를 대조한 중간 조사 기록이다. 코드 수정과 실기기 재현은 수행하지 않았다.
캐릭터 표시 이상은 확인됐지만 기기 귀책은 확정되지 않았다
고객 영상에서 캐릭터가 사라지는 동안 아동 카메라는 계속 움직인다. 18:48:53 신고 스냅샷에서는 앞쪽 두 video 요소의 currentSrc가 빈 상태이며 readyState: 0으로 기록됐다. 캐릭터 영상의 소스 선택·로딩·해제·표시 경로가 우선 조사 대상이다.
수업 자료 사전 캐시는 세 번 모두 failedCount: 0이다. 제공된 기록에는 다운로드 실패, video.play() 거절, 미디어 error 이벤트가 없다. 그러나 캐릭터 파일별 다운로드 완료 기록과 재생 실패 로그가 충분하지 않아 S3 파일 로딩 문제까지 배제할 수는 없다.
아이폰 고장, 성능 부족, 서버 무관, 다운로드 실패 중 어느 하나를 원인으로 확정하지 않는다. S3에 저장된 이 파일은 브라우저 로그이며 백엔드 서버 로그나 S3 접근 로그가 아니다.
검토 자료와 범위
| 자료 | 범위 | 한계 |
|---|---|---|
| LogRocket JSON 2개 | 2,000건: 18:23:05~18:31:48 17,000건: 18:32:19~18:46:16 | 수업 후반 기록이 없어 이후 제공된 S3 보관 로그로 보완했다. 두 자료를 합산해 오류 건수를 세지 않았다. |
| S3 보관 JSONL | 37,564줄. guest 18,266건, monitor 19,298건. 전체 18:26:25~18:52:31, guest는 18:30:00~18:52:30. | .gz 확장자지만 제공된 파일 내용은 압축이 해제된 평문 JSONL이다. data의 JSON 문자열을 파싱해 분석했다. |
| 고객 촬영 영상 3개 | 약 22초, 13초, 17초. 시간별 프레임을 추출해 시각적으로 검토했다. | 음성 내용은 판정하지 않았다. 영상 내 절대 시각이 없어 로그와 초 단위로 동기화하지 못했다. |
| 리소스 등록 스크린샷 | 현재 화면에서 talking과 idle이 각각 1개다. | 11월 13일 당시에도 동일한 등록 상태였는지, 실제 파일 바이트가 정상인지 확인한 자료는 아니다. |
| PPI 소스 정적 검토 | 분석 기준 리비전 c0400d5f23f227774c4971d17295ab4967c45787 | 사고 당시 배포된 브라우저 번들과 이 리비전의 동일성은 별도 확인이 필요하다. |
고객 영상에서는 캐릭터 영역이 비어 있다
| 파일 | 관찰 | 해석 |
|---|---|---|
talkv_high.mp422.167초 | 추출한 0~22초 프레임에서 수업 콘텐츠 영역이 흰색으로 비어 있다. 아동 카메라의 얼굴과 말하기 테두리는 변한다. | 화면 전체 정지보다 캐릭터 표시 경로의 이상과 맞는다. 브라우저가 모든 기능을 정상 처리했다는 뜻은 아니다. |
talkv_high (1).mp412.917초 | 교실 비교 자료와 아동 카메라는 보이지만 오른쪽 위 캐릭터 영역이 비어 있다. | 자료가 고정된 모습 자체는 영상 정지의 증거가 아니다. 관련 활동 로그에는 split:image 대화 단계가 있다. |
talkv_high (2).mp416.792초 | 농구 자료 옆 캐릭터가 초반에 없고 약 6초 프레임에는 나타난다. 약 16.7초 프레임에는 다시 사라진다. 아동 카메라는 계속 변한다. | 대화 중 아바타 표시가 불안정한 정황이다. 농구 배경은 로그의 '수호고민상담' 이미지 단계와 맞는다. 캐릭터 소멸이 발화 전환 때문인지는 확정하지 않았다. |
원본 고객 영상과 얼굴 이미지는 이 문서에 첨부하지 않았다. 원본 파일명은 근거 자료 대조용이다.
로그에서 확인한 시간순 사건
| 시각 | 관찰 | 원본 줄 |
|---|---|---|
| 18:30:01.932 | getUserMedia가 NotAllowedError로 한 번 실패했다. 재입장 후 18:30:18.108과 18:32:27.542에는 카메라·마이크 시작이 성공했다. | 별도 LOCAL_MEDIA_STREAM 이벤트 |
| 18:30:01.088 / 18:30:16.252 / 18:32:26.132 | 세 입장의 수업 자료 캐시 결과가 모두 failedCount: 0이다. | 84 / 279 / 3030 |
| 18:30:55.603 / 18:31:12.417 / 18:31:56.342 | '친구가 안 보여요' 신고 3회. 첫 video는 srcKind: none, readyState: 0이다. | 872 / 1193 / 2801 |
| 18:32:12.801 | reason: kick으로 강제퇴장 이벤트가 기록됐다. 이 이벤트만으로 브라우저 종료나 자연 연결 단절로 해석하지 않는다. | 2922 |
| 18:39:24.507 | '친구가 안 보여요' 신고. 첫 video는 none / 0, 두 번째는 blob / 4이며 정지 상태다. | 13080 |
| 18:48:42.025 | 활동 10, 스텝 0 '동아리선택'으로 전환했다. full:ai, 초기 상태 idle이다. | 30664 / 30666 |
| 18:48:42.094 | 해당 활동의 avatarId가 tiki_C02reward로 기록됐다. 18:48:42.122에는 hasAvatar: true다. | 30713 / 30716 |
| 18:48:53.178 | '친구가 안 보여요' 신고. 앞쪽 두 video 모두 none / 0 / paused다. aiSessionActive: true, 탭은 visible이다. | 31133 |
| 18:48:53.254 | 모니터가 같은 신고를 수신했다. 신고 이벤트 전달 간격은 로그 시각 기준 76ms다. | 31135 / 31136 |
| 18:52:25.000 | 엔딩송은 Blob URL이며 전체 길이 약 49.9초가 버퍼에 있다. readyState: 4로 재생을 시작했다. | 37485 |
| 18:52:30.316~18:52:30.376 | 엔딩송이 4.498초에서 예상치 못하게 정지했다. 약 60ms 뒤 play와 복구 로그가 기록됐다. 이 짧은 복구 기록으로 앞선 지속적인 흰 화면을 설명할 수는 없다. | 37548~37551 |
18:48:53 스냅샷의 두 video는 선택된 소스가 없다
실제 메시지명은 [ISSUE_DIAG] Issue diagnostics snapshot at report다. currentSrc: ""라는 필드를 직접 출력한 로그는 아니다. 아래는 원본 31133줄에서 처음 두 요소의 관련 필드만 발췌한 내용이다.
videoSrc가 비었다고 직접 기록된 로그도 아니다. 이 스냅샷에는 React의 videoSrc 값이 없다. guest 로그에서 최상위 data에 videoSrc가 기록된 레코드를 별도로 확인했으며, 빈 문자열이나 null인 기록은 없었다. 이후 설명의 '소스 없음'은 srcKind: none에서 해석한 currentSrc 상태를 뜻한다.
{
"issueText": "친구가 안 보여요",
"media": [
{ "srcKind": "none", "readyState": 0, "paused": true },
{ "srcKind": "none", "readyState": 0, "paused": true }
]
}
스냅샷은 DOM 순서대로 미디어 요소를 수집한다. 요소 ID, data-monitor-media, 파일명, src 속성은 기록하지 않는다. 아래 역할 대응은 현재 화면 구조와 비교한 추정이다.
| 요소 순서 | srcKind | readyState | paused | currentTime | 역할 해석 |
|---|---|---|---|---|---|
| 1 | none | 0 | true | 0 | 아바타 idle 영상으로 추정 |
| 2 | none | 0 | true | 0 | 아바타 talking 영상으로 추정 |
| 3 | src | 4 | false | 8.586 | 콘텐츠가 없을 때 유지되는 기본 video로 추정 |
| 4 | srcObject | 4 | false | 982.701 | 아동 카메라로 추정 |
srcKind: none은 진단 코드에서 srcObject가 없고 currentSrc가 빈 값이라는 뜻이다. src 속성 자체가 없었다는 확정 증거는 아니다. 다운로드를 완료했어도 소스 연결 누락, 전환 중 초기화, 소스 선택 이전 상태에서 이 값이 나올 수 있다.
반대로 카메라처럼 srcObject를 사용하는 요소는 이 진단에서 srcKind: srcObject로 구분한다. 해당 요소의 URL 상태를 파일 기반 video와 같은 기준으로 판단하지 않는다.
hasAvatar: true도 아바타 정보 조회 결과이며, idle·talking 영상 파일 다운로드 완료나 디코딩 성공을 뜻하지 않는다. 개별 video 리소스 ID와 파일명을 이 스냅샷에 직접 연결할 수 없다.
현재 리소스 등록 구성은 코드의 요구와 맞는다
talking1개:avatar_tiki_C02reward_talking_0.mp4idle1개:avatar_tiki_C02reward_idle_0.mp4
useAvatarVideo는 두 타입의 resources[].fileName을 선택한다. 각각 1개인 구성도 허용된다. 스크린샷에서 등록 누락이나 타입명 오타는 보이지 않는다. 화면 썸네일만으로 MP4 파일의 정상 디코딩, 수업 당시 등록 상태, 아동 기기의 로딩 완료를 확인할 수는 없다.
getResourceUrl은 파일을 Blob으로 확보한 후 URL을 반환한다. 정상 파일을 완전히 받은 뒤의 프레임 디코딩과 표시는 브라우저가 처리한다. 다운로드가 실패하면 원격 URL을 그대로 반환하는 대신 오류를 기록하고 null을 반환한다.
따라서 정상 Blob 확보가 확인되면 재생·표시 경로를 우선 조사한다. 다만 이번 자료의 사전 캐시 성공을 모든 아바타 파일의 개별 성공으로 확대해석하지 않는다. 원본 파일 손상과 잘못된 메타데이터도 검증하지 않았다.
실제 오류는 있지만 흰 화면과의 인과관계는 확인되지 않았다
다음 건수는 S3 보관 JSONL 한 파일에서 역할별로 집계한 로그 레코드 수다. 동일 사건이 여러 이유로 중복 기록될 수 있으므로 독립 장애 횟수와 같지 않다.
| 역할과 메시지 | 건수 | 확인된 의미와 한계 |
|---|---|---|
| guest · ASR continuation window 적용 실패 | 24 | '음성 합치기 설정 변경 실패'. agent_trust_pinned와 ready_response_confirmed 등에서 기록됐다. 캐릭터 흰 화면의 원인으로 연결하지 않았다. |
guest · Failed to produce mic audio | 8 | AwaitQueueStoppedError: queue stopped. 활동 전환 시 연결 정리와 겹친다. 영상 다운로드 실패 로그가 아니다. |
guest · guest-step-update ACK 시간 초과 | 3 | 18:30 초반에 발생했다. 서버 응답 지연과 네트워크 중 원인을 이 기록만으로 분리할 수 없다. |
guest · video setSinkId failed | 10 | NotAllowedError: A user gesture is required. 오디오 출력 장치 설정 실패이며 video.play() 거절과 구분한다. |
| guest · 예상치 못한 video pause | 1 | 18:52:30 엔딩송에서 발생했고 약 60ms 뒤 복구 로그가 있다. |
monitor · Consume failed | 19 | 19건 모두 UNAUTHORIZED다. 모니터의 미디어 구독 경로에서 난 오류다. S3 리소스 다운로드 권한 오류로 해석하지 않는다. |
guest는 canplay 7건과 play 이벤트 8건, monitor는 각각 22건이다. 두 역할 모두 직접적인 play 실패, video error 이벤트, 리소스 다운로드 실패 메시지는 0건이다. 이 수치는 주로 MEET_VIDEO 자료 재생 로그이며, 아바타 영상이 정상 재생됐다는 증거로 사용하지 않는다.
아동의 '친구가 안 보여요' 신고는 총 5회다. 모니터의 정상 콘텐츠 재생 기록도 아동 측 아바타의 정상 표시를 보장하지 않는다.
현재 코드는 원인 추적에 필요한 정보를 일부 남기지 않는다
MeetAvatar와useAvatarRms의 일부play().catch(() => {})는 재생 거절을 기록하지 않는다. 아바타의 play 실패 기록이 없다는 이유로 성공을 주장할 수 없다.collectIssueDiagnostics는 요소 순서와 재생 상태만 기록한다. 빈 소스가 어느 파일인지,src속성을 코드가 제거했는지, 아직 소스를 선택하지 못했는지 구분할 수 없다.MeetAvatar에는 영상 해제 시pause(),removeAttribute("src"),load()를 실행하는 코드가 있다. 이번 미노출이 이 처리 때문에 발생했다는 재현 증거는 없다.isLowPerformanceDevice: true는 성능 부족의 확정 근거가 아니다. 현재measurePerformance()는 예약한 rAF 콜백이 실행되기 전에 frameCount로 결과를 계산한다. 해당 함수를 분리해 콜백 순서를 확인했을 때 반환값은 0이었다. 이는 실제 기기 성능 측정이 아니다.
반면 guest의 별도 LOW_POWER_PROBE 44개 표본은 모두 약 58.8fps이며 lowPowerSuspected: false다. 이 값은 수집 시점의 화면 갱신 간격 표본이다. 지속적인 MP4 디코딩 성능이나 GPU 상태를 보장하지 않는다.
다운로드 실패와 소스 연결 실패를 구분할 증거가 더 필요하다
다음 항목은 후속 조사 제안이며 아직 구현하거나 검증하지 않았다.
- 아바타 파일별로 선택된 파일명, 리소스 ID, 캐시 적중 여부, 다운로드 결과, Blob 크기를 확인한다. 현재 등록 파일과 당시 사용 파일의 버전·체크섬도 대조한다.
- idle·talking 요소에 대해
data-monitor-media,getAttribute("src"),currentSrc,readyState,networkState,videoWidth,videoHeight,video.error를 함께 수집한다. - play 거절과
loadstart,loadeddata,playing,pause,emptied,error를 기록한다. 활동·스텝·아바타 ID와 소스 할당·해제 이유를 같은 순서로 연결한다. - 같은 iPhone 환경에서
tiki_C02reward의 idle·talking 전환과split:image에서full:ai로의 전환을 재현한다. 소스 상태가 정상인데도 보이지 않을 때 CSS 표시 상태와 canvas 활성 여부를 확인한다. - 모니터
UNAUTHORIZED는 별도 미디어 구독 문제로 추적한다. 백엔드 오류와의 연관성을 주장하려면 해당 요청·서버 로그를 대조한다.
고객 안내에는 '캐릭터 화면이 표시되지 않는 현상을 확인했고, 영상 로딩과 화면 전환 과정을 조사 중'이라고 설명할 수 있다. 기기 교체나 서버 정상 판정을 이 자료만으로 안내하지 않는다.
근거 자료와 코드 위치
원본은 분석자 로컬 제공 자료다. 아래 줄 번호는 S3 보관 파일의 물리적 JSONL 줄 번호이며, 다운로드 후 JSON을 다시 정렬하면 달라질 수 있다.
lesson-log-20261113-cc02211c-9aa5-4c5e-8015-0ca0c002a7fc.jsonl.gz
SHA-256:a35832689b08cf26b0cd9df1e47ab7f59f4ae642ba70c688159a51ce6dda456d- LogRocket 제공 파일
6-01a1d437-bdbd-78b4-a639-04c3d3f0b517_0_c392a399-e519-49b4-b5c5-5c753bb996d2.json과6-01a1d437-bdbd-78b4-a639-04c3d3f0b517_0_76101eda-3004-46b5-9ff1-bd4197f1d472.json - 진단 스냅샷의 currentSrc 분류
- idle·talking 파일 선택, 비동기 로딩과 정리
- 아바타 video 해제와 play 호출
- Blob URL 확보와 실패 시 null 반환
- 아바타 RMS 재생 제어 · 저성능 판정 함수
주요 로그 건수 재집계
제공 파일 경로를 인자로 전달한다. 출력 건수는 LogRocket JSON을 합산하지 않은 S3 보관 파일 기준이다.
python3 - ~/Downloads/lesson-log-20261113-cc02211c-9aa5-4c5e-8015-0ca0c002a7fc.jsonl.gz <<'PY'
import collections, gzip, json, sys
path = sys.argv[1]
with open(path, "rb") as stream:
compressed = stream.read(2) == b"\x1f\x8b"
opener = gzip.open if compressed else open
with opener(path, "rt") as stream:
rows = [json.loads(line) for line in stream if line.strip()]
print("roles", collections.Counter(row["role"] for row in rows))
counts = collections.Counter(
(row["role"], row["ctx"], row["msg"])
for row in rows if row["level"] in {"warn", "error"}
)
for key, count in counts.most_common():
print(count, *key, sep="\t")
PY