Troubleshooting

카메라·업로드 오류 해결 가이드

분석이 안 될 때 — 모든 오류 유형별 단계별 해결 방법

📌 핵심 요약

🗡️ 지원 안내

상현 AI 운영팀 — 다양한 기기와 브라우저에서 발생하는 오류 패턴을 정리하여 이 가이드를 작성했습니다. 가이드로 해결되지 않는 문제는 문의 페이지로 상세히 보내주시면 최대한 빠르게 확인하겠습니다.

최종 수정일:

📷 카메라 접근 오류

가장 흔한 문제입니다. 카메라 기능을 처음 사용하면 브라우저가 권한을 묻는데, 이를 실수로 차단하거나 이전에 거부한 경우입니다.

Chrome (PC / Android)

  1. 주소창 왼쪽 자물쇠(🔒) 아이콘 클릭
  2. "카메라" 항목을 "허용"으로 변경
  3. 페이지 새로고침 (F5 또는 새로고침 버튼)
  4. 카메라 권한 팝업이 다시 뜨면 "허용" 클릭

Chrome 설정에서 변경하려면: 설정 → 개인정보 및 보안 → 사이트 설정 → 카메라에서 이 사이트를 허용 목록에 추가하세요.

Safari (iOS / iPhone · iPad)

  1. 설정 앱 → Safari → 카메라 → "허용"으로 변경
  2. 또는 Safari 앱 실행 → 주소창의 AA 버튼 → 웹사이트 설정 → 카메라 허용
  3. Safari를 닫고 다시 열기 (완전 종료 후 재시작)

Safari (macOS)

  1. Safari 상단 메뉴 → Safari → 환경설정
  2. "웹사이트" 탭 → 왼쪽 "카메라" 선택
  3. 이 사이트(bs-pb2.pages.dev) 옆에서 "허용" 선택
  4. 페이지 새로고침

Firefox

  1. 주소창 왼쪽 방패·자물쇠 아이콘 클릭
  2. "카메라 사용 권한" 옆의 ✕ 클릭하여 차단 해제
  3. 페이지 새로고침 후 "허용" 클릭

🔐 카메라가 아예 작동하지 않음 (HTTPS 문제)

카메라 API(getUserMedia)는 보안 정책상 HTTPS 연결에서만 작동합니다. HTTP 주소로 접속하거나 일부 구형 기기에서 이 문제가 발생합니다.

해결 방법

기타 카메라 오류 메시지

⏳ AI 모델 로딩 실패 / 무한 로딩

Teachable Machine 모델 파일(5~15MB)을 구글 서버에서 다운로드하는 데 실패하는 경우입니다.

원인과 해결 방법

로딩이 매우 느린 경우

모델 최초 다운로드는 인터넷 속도에 따라 10~60초가 걸릴 수 있습니다. 로딩 중에는 페이지를 닫지 않고 기다려주세요. 한 번 다운로드되면 브라우저 캐시에 저장되어 이후에는 빠르게 로딩됩니다.

🖼️ 이미지 업로드 오류

지원 형식 및 크기

업로드는 되지만 분석이 안 되는 경우

스마트폰에서 업로드 방법

  1. "이미지 업로드" 버튼 탭
  2. 팝업에서 "사진 라이브러리" 또는 "파일"에서 선택
  3. 원하는 사진 선택 → 자동으로 미리보기 표시
  4. "분석 시작" 버튼 탭

🌐 브라우저별 주의사항

iOS (iPhone / iPad) — 중요!

iOS에서는 반드시 Safari 브라우저를 사용하세요. iOS의 Chrome, Firefox 등 타사 브라우저 앱은 iOS 보안 정책상 카메라 접근이 제한될 수 있습니다. 카메라 기능이 필요하다면 Safari에서 접속하거나, 이미지 업로드 모드를 사용하세요.

Android

Chrome 브라우저 사용을 권장합니다. Samsung Internet, Firefox 등도 대부분 지원되지만, 구형 버전에서는 문제가 발생할 수 있습니다. 브라우저를 최신 버전으로 업데이트하세요.

PC (Windows)

Chrome, Edge, Firefox 모두 잘 작동합니다. 노트북의 경우 내장 웹캠이 자동으로 인식됩니다. 외장 웹캠을 사용한다면 USB 연결 후 브라우저를 재시작하세요.

PC (Mac)

Safari 또는 Chrome 사용을 권장합니다. macOS 시스템 환경설정에서 Safari/Chrome에 카메라 접근 권한이 부여되어 있는지 확인하세요: 시스템 설정 → 개인정보 보호 및 보안 → 카메라

지원하지 않는 브라우저

📊 분석 결과 관련 문제

결과가 항상 같은 캐릭터로만 나와요

조명, 배경, 카메라 각도를 바꿔서 여러 번 시도해보세요. 특정 조명 조건이나 각도에서 특정 캐릭터가 더 자주 나올 수 있습니다. 촬영 가이드를 참고해 최적의 조건을 만들어보세요.

유사도가 모두 낮게 나와요 (0~20%)

얼굴이 화면에 너무 작거나, 빛이 너무 어두운 경우, 또는 이미지 품질이 낮은 경우 전체적으로 낮은 유사도가 나올 수 있습니다. 더 밝고 선명한 사진으로 다시 시도해보세요.

결과가 나왔다가 사라져요

페이지를 다시 로딩하거나, 브라우저 캐시를 삭제 후 재시도하세요. 브라우저 메모리 부족으로 인해 발생할 수 있으며, 다른 탭을 닫고 이 서비스만 열면 도움이 됩니다.

공유 버튼이 작동하지 않아요

링크 복사 기능은 HTTPS 환경에서만 완전히 지원됩니다. iOS에서 공유 버튼이 작동하지 않으면 스크린샷을 찍어 직접 공유하세요.

❓ 자주 묻는 질문

Q. 카메라 권한을 거부했는데 어떻게 다시 허용하나요?

Chrome에서는 주소창 왼쪽의 자물쇠 아이콘 클릭 → 카메라 권한을 '허용'으로 변경 → 페이지 새로고침하세요. Safari(iOS)는 설정 앱 → Safari → 카메라에서 변경 가능합니다. 더 자세한 방법은 위의 브라우저별 설명을 참고하세요.

Q. 모델이 계속 로딩 중인데 얼마나 기다려야 하나요?

인터넷 속도에 따라 최대 60초까지 걸릴 수 있습니다. 60초가 지나도 로딩이 안 되면 페이지를 새로고침하고 다시 시도하세요. VPN을 사용 중이라면 끄고 시도해보세요.

Q. 분석 중에 화면이 멈췄어요.

기기 메모리나 CPU에 부하가 걸렸을 수 있습니다. 다른 앱과 탭을 모두 닫고 브라우저를 재시작한 후 다시 시도하세요. 오래된 기기에서는 분석에 더 오랜 시간(5~10초)이 걸릴 수 있습니다.

Q. 위의 방법으로 해결이 안 돼요.

문의 페이지를 통해 ①사용 기기 및 브라우저, ②오류 메시지 내용, ③문제 발생 단계를 상세히 알려주시면 최대한 빠르게 확인하겠습니다.

✅ 링크가 복사됐어요!