챕터 6: 복구, 저장소 및 문제 해결

Chrome은 확장 프로그램을 중단시킬 것입니다. 여부가 아니라 시기의 문제입니다 — 서비스 워커는 유휴 상태에서 절전 모드가 되고, 탭은 닫히며, Chrome은 압박 하에 메모리를 회수합니다. 이 챕터는 확장 프로그램이 어떻게 살아남는지, 그리고 이음새가 보일 때 무엇을 해야 하는지에 관한 것입니다.

한 단락으로 보는 복구 모델

모든 녹음은 오디오 청크와 메타데이터를 발생하는 대로 IndexedDB (브라우저의 로컬 데이터베이스)에 기록합니다. Chrome이 녹음 중간에 확장 프로그램을 종료해도 청크는 남아 있습니다. 다음에 사이드 패널을 열면 saved on this device 목록에 Upload all 버튼과 함께 나타납니다 — 재개 가능한 다중 파트 업로드 덕분에 로그인한 사용자는 중단된 업로드를 중단된 지점부터 재시도할 수 있습니다. 익명 사용자는 오디오를 컴퓨터로 다운로드하거나 나중에 로그인하여 업로드할 수 있습니다. 아무것도 조용히 손실되지 않습니다.

이 섹션은 요약이며, 1.6-1.9 버전의 릴리스 노트에 이것이 대체한 버그 클래스의 전체 히스토리가 있습니다.

"saved on this device" 목록

로컬에 준비된 녹음이 있으면 사이드 패널 상단에서 열립니다. 각 행은 다음을 표시합니다:

회의 제목 (또는 제목을 얻지 못한 녹음의 경우 "Untitled — <date>").
캡처된 지속 시간.
상태 (Ready to upload / Uploading / Failed / Finalized).
버튼: Upload (로그인) 또는 Download / Delete.

목록 상단의 Upload all이 큐를 비웁니다. 전체 4분 마감을 기다리지 않고 재생 스윕이 완료 신호를 보내는 즉시 종료되므로 반응성이 좋게 느껴집니다.

Chrome이 녹음 중간에 확장 프로그램을 종료할 때

다음 중 어느 것이라도 발생할 수 있으며 처리됩니다:

녹음 중인 탭이 닫힘. 서비스 워커는 tabs.onRemoved 이벤트를 받고 Chrome이 서비스 워커를 절전 모드로 만들기 전에 정상적인 Stop + 업로드 배출을 트리거합니다.
녹음 탭이 충돌함. 마이크 콘텐츠 스크립트 릴레이가 죽습니다; PCM 프레임이 없는 5초 후 사이드 패널은 "microphone signal was lost" 경고를 표시합니다. 녹음이 중지되고 그 시점까지 캡처된 청크가 복구를 위해 준비됩니다.
서비스 워커가 Chrome에 의해 재활용됨. 다음 콜드 스타트에서 확장 프로그램은 오프스크린 문서에 핑을 보냅니다. 응답하면 녹음이 원활하게 계속되고, 그렇지 않으면 오프스크린이 포기되고 패널이 준비된 청크가 그대로 남은 상태로 설정으로 돌아갑니다.
오프스크린 문서가 메모리 압박 하에 회수됨. 그것의 pagehide 핸들러가 녹음을 강제 중지합니다. 오프스크린 내부의 30초 마이크 신호 정체 백스톱은 모든 외부 신호가 손실되면 녹음을 중지합니다.
녹음 중 브라우저가 닫힘. 다음에 Chrome을 열 때 녹음이 "saved on this device" 목록에 나타납니다.

이전에는 조용히 손실되던 한 가지 사례 — 단일 페이지 앱 탐색으로 종료되는 Google Meet 회의 — 는 콘텐츠 스크립트와 독립적으로 서비스 워커가 탭이 회의 코드 URL을 떠나는 것을 직접 감시함으로써 처리됩니다.

업로드가 실패할 때

업로드는 재개 가능한 다중 파트 전송을 사용합니다. 부분이 실패하면 그 부분만 다시 시도합니다. 전송 중간에 전체 업로드가 죽으면:

준비된 청크는 IndexedDB에 유지됩니다.
녹음이 Failed 상태로 "saved on this device" 목록에 나타납니다.
로그인: 해당 행의 Upload가 마지막 성공 부분에서 전송을 재개합니다. 긴 회의의 경우 이것은 완전한 재업로드가 아닙니다.
익명: Download가 오디오를 .webm 파일로 컴퓨터에 저장합니다; 로컬로 재생하거나 로그인 후 나중에 업로드할 수 있습니다.

저장소 관리

로컬 녹음은 이제 30일 후에 자동 삭제되지 않습니다. 확장 프로그램을 독립 실행형 녹음기로 취급한다면 — 회의 녹음, 파일 로컬 보관, 로그인 안 함 — 이전에는 오래된 녹음이 조용히 사라졌습니다. 그것이 수정되었습니다.

두 카테고리만 안전하게 자동 정리됩니다:

최종화된 고아 — 업로드가 녹음이 R2에 안전하게 있음을 확인했고, 로컬 복사본이 이제 중복입니다.
0바이트 고아 — 오디오가 캡처되기 전에 녹음이 죽었습니다; 복구할 것이 없습니다.

로컬 녹음이 준비된 상태로 500 MB에 도달하면 사이드 패널 상단에 노란색 저장소 경고가 나타납니다. 이는 권고 사항입니다 — 데이터는 삭제되지 않습니다 — 하지만 로그인하여 업로드하거나 다운로드하여 지우라는 알림입니다.

특정 녹음을 지우려면: "saved on this device" 목록에서 해당 행의 Delete를 클릭합니다. 녹음에 업로드되지 않은 실시간 노트가 있으면 삭제는 확인을 요청합니다.

일반적인 문제

"확장 프로그램 아이콘이 chrome://, edge://, 또는 Chrome 웹 스토어에서 회색으로 표시됩니다."

Chrome은 확장 프로그램이 chrome:// 페이지, edge:// 페이지 및 Chrome 웹 스토어 자체에서 실행되는 것을 금지합니다. 이것은 브라우저 전체 제한입니다; SeaMeet가 할 수 있는 것은 없습니다. 일반 탭에서 회의를 여세요.

"탭 캡처가 'Cannot access a chrome:// URL' 또는 'Extension not allowed for this tab'으로 실패했습니다."

탭이 확장 프로그램을 설치하기 전에 열려 있었습니다. Chrome은 권한이 부여되지 않은 탭에 탭 캡처를 연결하는 것을 거부합니다. 탭을 다시 로드하고 다시 시도하세요.

"복구 목록에서 녹음이 0:00으로 표시됩니다."

이것은 이전 버전의 버그였습니다 — 지속 시간은 중지 시에만 기록되었으므로 중단된 녹음에는 없었습니다. 이제 녹음 중에 유지되므로 첫 번째 지속 시간 업데이트 전에 녹음이 종료된 경우에만 발생합니다. 알 수 없을 때는 —로 대체됩니다.

"업로드된 파일이 재생되지만 알 수 없음 / 무한 지속 시간이 표시됩니다."

최대 100 MB까지의 녹음은 업로드가 완료되기 전에 지속 시간 메타데이터가 다시 작성되므로 이 문제는 수정되었습니다. 더 크거나 재개된 녹음은 Part-1 패치 대체를 유지합니다 — 파일은 재생되지만 소수의 플레이어는 올바르게 탐색하지 못할 수 있습니다. 해결 방법으로 VLC를 시도하세요.

"Meet 회의가 끝났지만 녹음이 계속되었습니다."

이 버그 클래스는 1.9에서 수정되었습니다. 1.9 이상에서 발생하면 chrome://extensions/의 버전 번호와 회의 플랫폼에 대한 메모와 함께 신고해 주세요.

"회의 중간에 자막이 멈췄습니다."

실시간 음성-텍스트 변환은 몇 번 자동 재연결됩니다; 소진되면 전사 위에 "Retry captions" 배너가 나타납니다. 클릭하세요. 녹음은 그 동안 계속됩니다 — 오디오는 손실되지 않습니다.

"Meet 통화의 녹음에 잘못된 제목 (탭 제목)이 있습니다."

이것은 1.8에서 수정되었습니다 — 확장 프로그램 녹음은 이제 웹 앱의 기본 이름 가드와 일치하도록 "Untitled — <date>"로 시작하므로 AI 생성 회의 제목이 업로드 후 올바르게 대체됩니다. 1.8 이상에서 이것을 보면 AI 이름 변경이 보통 1분 이내에 따라잡습니다.

버그를 신고할 때

중단 후 녹음이 "saved on this device" 목록에 나타나지 않았습니다.
Upload all이 성공했다고 주장하지만 웹 라이브러리에 녹음이 없습니다.
확장 프로그램이 (정상적으로 실패하지 않고) Chrome을 충돌시킵니다.
조용한 데이터 손실이 발생합니다.

데스크톱 앱 리포지토리 (seasalt-ai/seameet-app-desktop)에 확장 프로그램 버전, 브라우저 버전, 그리고 가능하면 사이드 패널의 스크린샷과 함께 신고하세요.

빠른 참조

증상	시도
확장 프로그램이 녹음하지 않음	탭을 다시 로드한 후 재시도
충돌 후 녹음 누락	사이드 패널의 "saved on this device" 목록 확인
업로드 정체	행에서 다시 Upload 클릭 — 재개 가능한 다중 파트
자막 중지	전사 위 배너의 Retry captions 클릭
500 MB에서 저장소 경고	로그인하고 Upload all, 또는 Download 및 Delete
종료 후 회의가 계속 녹음됨	아직 1.9+가 아니라면 업데이트

Last updated: 2026-08-27

← 챕터 5: 로그인 및 웹 앱으로 동기화