GoldenSpot AIANDROID USER GUIDE
홈페이지

GOLDENSPOT AI · DOCUMENTATION

사용자 설명서

Golden-first AI Inspection · Golden Image 등록부터 실시간 모니터링까지.

Android 앱 1.5.29 (37) · 정식 출시 2026.10.13 · 설명서 업데이트 2026.10.13

01

빠른 시작

GoldenSpot AI Android 앱은 정상 제품의 이미지를 등록한 뒤 새 이미지의 차이를 검사합니다. 이 설명서는 Android 앱 1.5.29과 장비 내 모니터링 웹을 다룹니다.

  1. 설치 및 로그인. Google Play에서 앱을 설치하고 바로 시작을 눌러 로그인 없이 이용하거나 Google로 계속하기를 선택합니다. 첫 접속에는 인터넷이 필요합니다. 카메라 권한을 허용하세요.
  2. 입력 선택. 설정 → 입력에서 On-Device CAM 또는 RTSP를 선택합니다. 후면 카메라는 제품과 조명을 고정하고, RTSP는 주소와 계정을 입력한 뒤 저장합니다.
  3. SKU와 모델 선택. 설정 → SKU 지식관리에서 제품을 추가·선택한 뒤 해당 SKU의 단순고속 또는 단순정밀을 선택합니다. 처음에는 단순고속으로 시작하세요.
  4. 정상 등록. 결함 없는 제품을 화면 중앙에 놓고 정상 등록을 누릅니다. 정상 이미지가 한 장 이상 있어야 검사할 수 있습니다.
  5. 검사. 시간모드 또는 탐지모드를 선택합니다. 시간모드는 촬영 주기에 따라 검사하고, 탐지모드는 물체가 없는 빈 배경에서 시작한 뒤 3→2→1 측정이 끝나면 물체를 투입합니다.
  6. 판정 확인. OK/NG, Score, Threshold와 측정 시각을 확인하고 정상·불량 샘플 모두로 기준을 검증합니다.
02

설치와 촬영 준비

Android 8.0 이상이 필요합니다. 검사 속도와 등록 가능한 이미지 수는 휴대폰에 따라 다릅니다. 처음 시작하거나 Google로 로그인할 때 인터넷이 필요합니다. 오픈 기념으로 Pro를 한시적으로 무료 제공합니다. 출력 탭 전체를 구독·결제 없이 이용할 수 있습니다.

  • 촬영 대상의 위치, 거리, 배경과 조명을 일정하게 유지하세요. 반사·흔들림·초점 불량을 줄입니다.
  • 검사는 영상 중앙의 정사각형 영역을 기준으로 합니다. 검사할 부위가 이 영역 안에 들어오도록 배치하세요.
  • 앱을 전면에 유지하세요. 자동 검사 중 화면 꺼짐을 방지하지만 앱이 배경으로 이동하면 검사와 모니터링 서비스가 중지됩니다.
  • 모니터링에는 휴대폰과 브라우저가 서로 통신할 수 있는 같은 Wi-Fi 또는 LAN이 필요합니다.

2026년 10월 13일 Google Play 정식 출시된 1.5.29 (37)을 기준으로 합니다. Google Play에서 설치 또는 업데이트하세요. 별도의 테스트 참여는 필요하지 않습니다. 이전 버전 사용자는 업데이트 후 오픈 기념 Pro 무료 기능을 이용할 수 있습니다.

03

정상 이미지와 모델

정상 제품의 허용 가능한 위치·조명·모양 변화를 포함해 등록하세요. 불량 제품을 정상으로 등록하지 마세요. 비슷한 이미지를 반복 등록하면 비교 시간과 메모리 사용이 늘어납니다.

모델선택 기준
단순고속빠른 검사로 시작할 때
단순정밀작은 결함을 더 세밀하게 시험할 때

단순정밀은 단순고속보다 메모리를 더 사용하며 처리 시간이 늘 수 있습니다. 모든 제품에서 더 정확하다는 뜻은 아니므로 실제 샘플로 확인하세요.

  • 모델 선택: 즉시 적용됩니다. 해당 모델에 정상 이미지를 등록해야 합니다.
  • 등록 상한: 설정 → SKU 지식관리에서 조절합니다. 기기 메모리에 따라 최대 장수가 제한됩니다. 상한을 낮춰도 기존 이미지는 삭제하지 않습니다.
  • 초기화: 확인 후 현재 SKU·모델의 정상 이미지와 최적화 설정을 초기화합니다. 이 초기화는 다른 모델의 등록 데이터를 유지합니다. 다른 SKU의 지식도 유지됩니다. SKU 전환은 초기화가 아닙니다.
04

시간모드와 탐지모드

검사를 정지한 상태에서 메인 화면의 시간모드 / 탐지모드를 선택하세요. 두 모드 모두 휴대폰 카메라와 RTSP 입력을 지원합니다.

검사 중 화면과 설정 변경

자동검사(1·2·3·5s) 또는 탐지모드에서 검사 시작을 누르면 설정 조작부를 숨기고 영상 영역을 넓힙니다. 하단에는 SKU·모델, 촬영 주기 또는 촬영 지연, 판정 기준을 요약해 표시합니다. OK/NG와 결함 표시, 탐지 상태 및 필요한 안내는 계속 확인할 수 있습니다.

검사 중에는 촬영 대기 시간에도 모든 설정 변경이 잠깁니다. 촬영 주기, 탐지라인, 판정 기준, SKU·모델과 입력·출력 설정을 바꾸려면 먼저 하단의 큰 검사 정지 버튼을 누르고 처리가 끝날 때까지 기다리세요. 기존 설정 조작부가 복원되면 값을 변경하고 검사 시작을 다시 누릅니다. 정상 이미지 등록·초기화·로그아웃도 검사 중에는 사용할 수 없습니다.

시간모드 0s 단발검사는 화면 배치를 유지합니다. 처리 중에만 설정이 잠기며, 완료되면 버튼이 검사 시작으로 돌아오고 설정도 자동으로 활성화됩니다. 탐지모드의 촬영 지연 0s는 단발검사가 아니므로 정지할 때까지 잠금과 요약 화면을 유지합니다.

시간모드 · 촬영 시작 시점 기준의 주기

촬영 주기 0s는 버튼을 누를 때 한 번 검사합니다. 1·2·3·5s는 검사 시작 직후 첫 촬영을 하고 선택한 주기로 다음 촬영을 예약합니다. 2s는 검사 후 2초 대기가 아니라 촬영 시작 시점 기준 약 2초마다 촬영입니다. 처리에 사용한 시간을 제외한 나머지만 기다립니다.

탐지모드 · 탐지 → 캡처 → 판정

  1. 현재 SKU와 모델에 정상 제품을 등록한 후 화면 전체에서 물체를 치워 빈 배경을 만듭니다. 카메라와 조명을 고정하세요.
  2. 탐지라인을 위아래로 움직여 제품이 지나갈 위치에 놓습니다. 촬영지연 0·0.5·1·2s 중 선택합니다. 0s는 탐지 직후 촬영합니다.
  3. 검사 시작을 누릅니다. 빈 배경 기준을 확보한 뒤 화면 중앙에 3 → 2 → 1이 크게 표시됩니다. 이때는 물체를 넣지 마세요.
  4. 측정이 끝나 준비 상태가 되면 제품을 투입합니다. 탐지라인의 변화를 감지하면 설정한 촬영지연 후 캡처하고 판정합니다.
  5. 검사한 물체가 탐지라인에서 벗어나 배경이 다시 보이면 다음 물체를 기다립니다. 물체가 라인에 머물러 있는 동안 반복 촬영하지 않습니다.

검사 중에는 모드와 라인 위치를 바꿀 수 없습니다. 라인 위치와 촬영지연은 SKU별로 저장됩니다. 정지하거나 앱을 배경으로 보내면 예약된 촬영이 취소됩니다. 다시 시작할 때마다 빈 배경에서 기준을 새로 측정합니다.

탐지모드의 배경 제외와 판정 보류

촬영한 이미지와 시작 시 확보한 빈 배경을 비교해 물체 영역을 구분합니다. 배경으로 구분된 영역은 이상 점수와 OK/NG 판정, 불량 표시 영역에서 제외됩니다. 화면·이력·알람·외부 전송에는 같은 최종 판정이 적용됩니다. 이 기능은 탐지모드에 적용되며 시간모드에는 적용되지 않습니다.

카메라 위치·배경·조명을 바꿨다면 정지하고 물체를 치운 뒤 다시 시작하세요. 배경과 비슷한 색의 물체, 그림자, 흔들림이나 움직이는 배경은 탐지와 분리에 영향을 줍니다. 실제 정상·불량 제품으로 확인하세요. 시작 시의 빈 배경 촬영은 검사 결과로 저장하거나 전송하지 않습니다.

05

판정과 NG 영역 이해

Score는 정상 등록 데이터와 비교한 이상 점수이며 불량 확률(%)이 아닙니다. Threshold는 판정 임계값입니다. 점수가 임계값 이상이고, 최소 면적 필터가 켜져 있다면 기준을 통과한 영역이 있어야 NG가 됩니다.

임계값을 낮추면 더 작은 차이에 민감해지고, 높이면 NG로 판정되는 범위가 줄어듭니다. 실제 정상·불량 샘플을 비교해 조정하세요. 조명이나 입력 모델을 바꾼 뒤에는 기준을 다시 확인합니다.

최소 BBOX 면적

설정 → SKU 지식관리 → 최소 불량 영역 (%)의 기본값은 0.01%입니다. 검사 이미지 전체에서 불량 표시 사각형이 차지하는 면적을 기준으로 합니다.

가로 1% × 세로 1% = 전체 면적의 0.01%

기준보다 작은 영역은 판정·표시·전송에서 제외됩니다. 0%는 면적 필터를 끕니다. 실제 작은 결함까지 제외하지 않도록 확인하세요.

검사 시간·판정 주기·가속기

  • 검사 시간: 추론과 리포트 처리에 걸린 시간입니다. 촬영 대기 시간과 구분해서 보세요.
  • 판정 주기 · 대기 포함: 이전 판정 완료부터 이번 판정 완료까지 실제로 흐른 시간입니다. 처리와 대기 시간이 포함되며 카메라 FPS가 아닙니다. 첫 판정에는 비교할 이전 판정이 없어 주기를 표시하지 않습니다.
  • 촬영 주기: 촬영 시작을 예약하는 설정값입니다. 매번 처리 시간이 다르므로 2s로 설정해도 판정 주기가 항상 정확히 2.00초가 되는 것은 아닙니다.

추론 시간과 리포트 시간은 처리 단계별 수치입니다. QNN / GPU / NPU / CPU 배지는 실제 선택된 가속기이며 앱이 자동으로 선택합니다.

06

일반 설정과 속도 조정

  • 언어: 자동 / 한국어 / English. 자동은 기기 언어를 따르고 미지원 언어는 영어로 표시합니다. 검사를 정지한 뒤 변경하세요. 언어 변경은 즉시 반영됩니다.
  • 장비명(Device ID): 공백 없이 최대 80자. 모니터링 로그인 ID로도 사용합니다. 예: LINE-01.
  • SKU: 제품별 지식과 설정을 구분합니다. 설정 → SKU 지식관리에서 제품을 추가·검색·선택합니다. 전환해도 기존 지식이 유지됩니다. 코드와 표시 이름은 별개이며, 다른 장비로 지식을 전송할 때는 양쪽의 현재 SKU 코드를 정확히 맞추세요.
  • 장비 NG 알람: ON/OFF, 지속시간 1~10초, Cooldown 0~60초. 음량은 휴대폰 미디어 볼륨으로 조절합니다. 웹 알람과 독립적으로 동작합니다.

3×3 그리드 표시

설정 → 일반 → 3×3 그리드 표시를 켜고 저장하세요. 기본값은 보이지 않음입니다. 영상 위치를 가늠할 수 있도록 1px 아이보리 선을 표시하며, 휴대폰 카메라와 RTSP 미리보기에 적용됩니다. 그리드는 저장 이미지나 AI 판정에 포함되지 않습니다.

등록 수가 많아 검사 시간이 길어질 때

설정 → SKU 지식관리 → 검사 최적화에서 기본 모드 또는 최적화 사용을 선택합니다.

  1. 검사를 정지합니다.
  2. 최적화 사용과 낮음·보통·높음 중 수준을 선택합니다. 처음에는 보통으로 시험하세요.
  3. 최적화 적용을 누릅니다. 하단 저장과 별개로 즉시 적용됩니다.
  4. 정상·불량 샘플로 점수와 임계값을 다시 검증합니다.

각 항목 옆 ?를 누르면 기능, 선택 기준, 변경 영향을 볼 수 있습니다. 일반 설정은 저장이 필요한 항목을 확인하세요. 모델 선택과 등록 상한·검사 최적화는 즉시 적용됩니다.

07

입력 영상 설정

On-Device CAM

휴대폰 후면 카메라를 사용합니다. 카메라 권한이 거부되면 앱에서 권한 허용을 누르거나 Android 앱 설정에서 카메라 권한을 켜세요.

RTSP

  1. 카메라를 연결할 수 있는 네트워크에 접속합니다.
  2. 설정 → 입력 → RTSP를 선택합니다.
  3. 전체 주소, 접속 ID, 비밀번호를 입력합니다. 예: rtsp://192.168.0.10:554/stream1. 주소는 카메라 제조사의 안내를 확인하세요.
  4. 카메라가 H.264 영상을 제공하도록 설정하고 저장합니다.
  5. 영상이 표시된 뒤 정상 이미지를 등록하고 검사합니다.

카메라 제조사별 스트림 경로가 필요하므로 IP만 입력하면 충분하지 않습니다. 계정 정보는 주소에 넣지 말고 별도 입력란을 사용하세요. 영상이 끊기면 자동 검사가 정지합니다. 네트워크·계정·영상 형식을 확인하고 다시 연결하세요.

08

출력·판정 기록 검색

설정은 일반·입력·출력·SKU 지식관리로 나뉩니다. 오픈 기념 무료 제공 기간에는 구독·결제 없이 판정 기록 검색을 포함한 출력 탭 전체를 사용할 수 있습니다. 오픈 기념 Pro 무료 안내을 확인하세요.

출력 방식은 한 순간에 하나만 선택할 수 있습니다. 다른 방식을 선택하면 기존 출력의 실행이 중지됩니다. MQTT도 같은 목록에서 선택하며, MQTT용 이미지 조회 API는 MQTT에 포함된 기능입니다. 네트워크 출력은 방식을 선택한 뒤 접속 정보를 설정하고 사용을 켜세요. 판정 기록 검색은 선택하면 검색 화면이 열리고 검사와 모든 네트워크 출력이 중지됩니다.

방식입력 정보완료 기준
REST API · POSThttp/https 전체 URL, 선택적 Bearer 토큰HTTP 2xx 응답
FTP / SFTP서버·폴더·계정·비밀번호, SFTP SHA256 호스트 키 지문파일 업로드 완료
Socket · WebSocketws/wss 수신 주소, 선택적 Bearer 토큰서버의 event_id 수신 확인
MQTT휴대폰 서버 주소·9자리 접속 코드외부 프로그램이 구독하여 수신
모니터링 웹Device ID와 모니터링 비밀번호장비 웹서버에서 조회
판정 기록 검색SKU·OK/NG·시작일·종료일기기에 저장된 기록과 이미지 조회

암호화 통신에는 HTTPS, SFTP, WSS를 사용합니다. SFTP 지문은 서버 관리자에게 받아 확인하고, 업로드할 폴더는 미리 생성하세요. Socket은 일반 TCP 소켓이 아닌 WebSocket입니다.

판정 기록 검색과 이상 영역 표시

  1. 설정 → 출력 → 판정 기록 검색을 선택합니다. 휴대폰을 들고 검색하면 촬영 구도를 유지하기 어려우므로 검사와 다른 출력을 중지합니다.
  2. SKU와 전체·OK·NG를 선택하고 시작일·종료일을 누르면 열리는 달력에서 날짜를 고릅니다. 종료일 당일을 포함하며 기기의 현지 날짜를 기준으로 검색합니다. 빠른 기간 선택도 사용할 수 있습니다.
  3. 검색을 누르고 결과를 선택하면 이미지, 판정, 점수와 저장된 검사 정보를 확인할 수 있습니다.
  4. 상세의 이상 영역 표시는 기본으로 켜져 있습니다. 저장된 이상 영역 사각형(BBOX)을 검사 이미지 위에 표시하며, 끄면 검사 대상 이미지만 표시합니다. 확대·이동으로 세부 영역을 확인할 수 있습니다.

REST POST·FTP·SFTP·WebSocket 재전송

최초 실패 후 추가 시도 횟수를 0~3회로 설정합니다. 3회는 최초를 포함해 최대 4번이며 1·2·4초 간격으로 재시도합니다. 실패로 검사를 멈추지는 않지만 앱 종료 시 대기 결과는 보존하지 않습니다. 수신 서버는 event_id로 중복을 구분해야 합니다.

09

모니터링 웹 사용

  1. 일반 설정에서 Device ID를 입력합니다.
  2. 출력에서 모니터링 웹을 선택하고 선택한 출력 사용을 켠 뒤 10~128자의 비밀번호를 설정·저장합니다.
  3. 검사를 시작합니다. 서비스가 실행되면 검사 화면 상단에 접속 가능한 HTTPS URL이 표시됩니다.
  4. 같은 네트워크의 브라우저에서 표시된 URL을 그대로 엽니다. 첫 접속에서는 앱의 SHA-256 지문과 브라우저 인증서를 대조한 뒤 장비 인증서를 확인합니다.
  5. Device ID와 모니터링 비밀번호로 로그인합니다. Google 계정 비밀번호를 사용하지 않습니다.

이미지와 상태 보기

왼쪽은 검사 이미지와 NG 영역, 오른쪽은 판정·점수·임계값·장비·SKU·측정 시각·상태를 보여줍니다. 이미지를 클릭하면 해당 측정의 원본을 확대합니다. 원본은 검사에 사용한 중앙 정사각형 JPEG이며 카메라 전체 센서 영상이 아닙니다.

최근 20건은 실시간 목록입니다. 24시간 이력에서는 저장된 결과를 조회합니다. 최대 최근 24시간을 보관하되 저장 공간 부족 시 오래된 자료가 먼저 삭제될 수 있습니다. 삭제된 원본은 복구 조회할 수 없습니다.

NG Only와 알람

NG Only는 표시만 필터링하며 전체 검사 카운트와 장비 상태는 계속 갱신됩니다. 카운트는 현재 모니터링 서비스 실행 기준입니다. 상단 알람 메뉴에서 ON/OFF·볼륨·Cooldown을 지정하고 알람 활성화 / 시험 재생을 누르세요. 브라우저가 닫히면 웹 알람은 울리지 않습니다.

상단 언어 선택은 브라우저별로 저장되며 장비 언어와 별개입니다. 한 번에 한 명만 접속할 수 있고 새 로그인이 이전 세션을 종료합니다. 비밀번호 변경·초기화는 장비에서 저장해야 적용됩니다. 웹에서는 SKU·임계값·AI·카메라·장비 알람을 변경할 수 없습니다.

10

외부 프로그램 연동 참고

외부 프로그램을 직접 연결하는 담당자를 위한 정보입니다. 앱에서 검사만 진행한다면 다음 장으로 이동하세요.

전송 데이터 형식과 수신 처리 보기

REST POST·FTP·SFTP·WebSocket의 외부 전송 JSON에는 schema_version, event_id, device_id, sku_id, UTC 측정 시각 timestamp, verdict, score, threshold, min_bbox_area_percent, accelerator, inference_ms, report_ms, inspection_image와 defect_regions가 포함됩니다. schema_version은 전송 형식 버전이며 현재 값은 1입니다. sku_id는 검사한 제품의 SKU ID입니다. 검사 이미지는 Base64로 변환한 JPEG입니다.

아래는 영역 정보만 발췌한 예시입니다. 전체 전송 페이로드가 아닙니다.

{
  "defect_regions": {
    "coordinate_space": "normalized_inspection_image",
    "format": "cxcywh",
    "width": 720,
    "height": 720,
    "boxes": [
      {
        "cx": 0.5,
        "cy": 0.5,
        "w": 0.2,
        "h": 0.1
      }
    ]
  }
}

cx, cy는 박스 중심, w, h는 너비·높이이며 모두 검사 이미지 기준 0~1로 정규화합니다. 왼쪽 좌표는 cx − w/2, 위쪽 좌표는 cy − h/2입니다. OK에서는 boxes가 빈 배열입니다.

WebSocket 수신 서버는 처리한 결과의 ID를 {"ack":"받은 event_id 값"}으로 회신해야 합니다. REST 요청에는 같은 ID의 Idempotency-Key 헤더가 제공됩니다.

11

SKU 지식관리와 QR 지식 전송

설정 → SKU 지식관리에서 제품별 검사 지식과 설정을 함께 관리합니다. 검사 정지 상태에서 변경하세요.

제품 추가·전환·복제

  1. SKU 추가에서 고유 SKU ID와 표시 이름을 입력합니다. ID는 영문·숫자로 시작하는 최대 80자의 영문·숫자·점·밑줄·하이픈이며 생성 후 변경할 수 없습니다. 표시 이름은 별도로 수정할 수 있습니다.
  2. SKU를 검색하고 선택하거나 메인 화면의 SKU 선택기를 사용합니다. 전환해도 기존 제품의 지식은 삭제되지 않습니다. 새 SKU에는 정상 이미지를 등록하거나 지식을 받으세요.
  3. 현재 SKU 복제는 현재 제품의 지식과 설정을 새 ID로 복사합니다. 새 제품의 정상·불량 샘플로 기준을 다시 검증하세요.

SKU별 통합 설정

모델, 판정 임계값, 최소 불량 영역, 정상 등록 상한, 촬영 모드·주기와 탐지라인·촬영지연을 SKU별로 유지합니다. 모델별 정상 지식과 검사 최적화도 제품별로 관리됩니다. 현재 SKU의 설정은 해당 조작으로 즉시 반영되며, 최소 영역은 영역 설정 적용을 누릅니다. 입력 연결·출력 연결·계정 및 접속 정보는 제품 설정과 별개입니다.

QR로 지식 공유

검사 최적화와 등록 상한을 확인하고 다른 장비와 검사 지식을 주고받을 수 있습니다.

보내는 장비

  1. 보낼 SKU에 검사 지식이 있는지 확인합니다.
  2. SKU 지식관리 → 다른 장비와 지식 주고받기 → 보내기 · QR 생성을 누릅니다. 검사는 정지됩니다.
  3. QR 화면을 열어 두고 받는 장비에서 스캔하도록 합니다. QR은 10분 동안 유효하며 화면을 닫거나 앱을 배경으로 보내면 사용할 수 없습니다.

받는 장비

  1. SKU 지식관리 → 받기 · QR 스캔을 누르고 카메라 권한을 허용합니다.
  2. 휴대폰을 세로로 든 상태에서 중앙 스캔 영역에 보내는 장비의 QR을 맞춥니다. 한 번 스캔하면 단순고속·단순정밀의 기본 데이터와 최적화 데이터를 차례로 받을 수 있습니다.
  3. 접속 후 같은 SKU인지와 모델 호환성을 확인합니다.
  4. 기본값은 기존 지식을 유지하는 병합입니다. 필요하면 기존 지식 교체 또는 판정 설정도 적용을 선택하고 안내를 읽은 뒤 YES를 누릅니다. NO를 선택하면 지식을 내려받거나 통합하지 않습니다.
  5. 아래 네 가지를 차례로 받은 뒤 통합 완료 안내를 기다립니다.
순서모델데이터
1단순고속기본 데이터
2단순고속최적화 데이터
3단순정밀기본 데이터
4단순정밀최적화 데이터

기본 병합은 모델과 데이터 종류에 맞춰 지식을 추가하고 중복을 제외합니다. 기존 지식 교체를 선택하면 현재 SKU의 모든 모델 지식을 수신 지식으로 교체하므로 기존 지식을 되돌릴 수 없습니다. 전송 실패·취소 시 기존 지식은 유지됩니다. 수신 데이터가 지원하면 판정 설정도 적용으로 임계값·최소 영역·등록 상한을 함께 적용할 수 있습니다. 두 옵션의 기본값은 꺼짐입니다. 원본 이미지, 계정·네트워크 접속 정보와 촬영 위치·주기 설정은 전송으로 적용되지 않습니다.

받은 지식으로 검사하기

SKU 지식관리에서 검사 모델과 검사 최적화를 선택합니다. 받은 최적화 데이터를 쓰려면 저장된 최적화 사용을 누릅니다. 최적화 적용은 선택한 수준으로 최적화를 새로 적용합니다. 전송만으로 사용 방식이 자동 변경되지는 않습니다. 정상·불량 샘플로 판정을 다시 확인하세요.

QR이 인식되지 않거나 연결되지 않습니다.

동일 네트워크, 양쪽의 현재 SKU, 카메라 권한을 확인하세요. 보내는 QR 화면을 열어 두고 QR 전체가 선명하게 보이도록 거리와 반사를 조정합니다. QR이 만료되었거나 지식이 변경되었다면 새 QR을 생성하세요. 통합 용량이나 호환성 문제도 전송 실패 원인이 될 수 있습니다.

12

MQTT 서버와 이미지 조회

휴대폰이 MQTT 서버입니다. 외부 프로그램이 휴대폰에 접속하여 검사 결과를 구독합니다. 별도 외부 브로커 주소를 입력할 필요가 없습니다.

  1. 휴대폰과 외부 프로그램을 서로 통신 가능한 네트워크에 연결합니다.
  2. 설정 → 출력의 출력 방식에서 MQTT를 선택합니다. 선택만으로 실행되지 않으며 사용 스위치의 기본값은 DISABLE입니다. MQTT 사용 스위치를 켜면 즉시 실행됩니다. 다른 출력 방식을 선택하면 MQTT와 부속 이미지 조회 API가 중지됩니다. MQTT 옆 ?에서 도움말을 볼 수 있습니다.
  3. 화면의 휴대폰 주소와 대문자·숫자 9자리 접속 코드를 외부 프로그램에 입력합니다. 추가 항목은 연동 정보에서 확인합니다.
  4. 외부 프로그램에서 아래 조건으로 접속·구독하고 앱을 전면에 유지한 채 검사합니다.
접속MQTT 3.1.1 / TLS / 포트 8883
사용자 이름goldenspot
비밀번호앱의 9자리 접속 코드
구독goldenspot/#
클라이언트 설정Clean Session 사용, Will 사용 안 함

앱의 인증서 SHA-256 지문을 외부 프로그램에서 확인하세요. 접속 코드를 공개하지 마세요. MQTT는 검사 결과 구독용이며 외부 명령 발행은 지원하지 않습니다. 구독자가 없을 때 대기 이벤트를 보관하므로 수신 프로그램은 event_id로 중복을 구분해야 합니다.

이미지 라이브러리 REST API

MQTT 메시지에는 이미지 자체가 없습니다. MQTT를 켜면 이미지 조회 REST API도 자동으로 제공되며 별도 설정은 필요하지 않습니다. 외부 프로그램은 메시지의 image_id로 원본 JPEG를 요청합니다.

GET https://휴대폰주소:8443/api/v1/image-library/images/{image_id}/file
Authorization: Bearer 앱의_9자리_접속_코드

휴대폰 주소와 image_id는 실제 값으로 바꿉니다. HTTPS 인증서도 앱의 지문으로 확인합니다. 인증 실패 시 MQTT 사용 여부와 접속 코드를 확인하고, 이미지 없음 응답은 해당 이미지가 남아 있는지 확인하세요.

13

Pro 무료·계정·지원

앱 사용자 개선 참여

무료 사용자는 첫 검사 전 서비스 개선 및 홈페이지 마케팅용 검사 횟수 전송·합계 공개에 동의해야 검사할 수 있습니다. 유효한 유료 구독 사용자는 선택 사항입니다. 설정 → 앱 사용자 개선 참여에서 변경·철회할 수 있습니다. 철회 시 미전송 횟수는 삭제되고 무료 사용자의 검사는 중지됩니다. 검사 이미지·판정 결과·SKU는 집계에 보내지 않습니다.

오픈 기념 한시적 Pro 무료

앱 1.5.27부터 기본 검사·정상 이미지 등록·SKU 지식관리뿐 아니라 판정 기록 검색, REST POST, FTP/SFTP, WebSocket, MQTT, 모니터링 웹을 포함한 출력 탭 전체를 구독·결제 없이 이용할 수 있습니다.

무료 제공 종료 일정은 추후 안내합니다. 이 혜택은 자동으로 유료 구독으로 전환되지 않습니다. 현재 버전에서는 구독 구매와 구매 복원을 제공하지 않으며, 출력 권한을 위한 정기적인 구독 확인도 필요하지 않습니다.

시작 화면의 바로 시작으로 로그인 없이 이용하거나 Google로 계속하기를 선택하세요. 첫 접속에는 인터넷이 필요합니다. 계정 연결은 선택 사항이며 데이터의 클라우드 백업을 의미하지 않습니다. 계정 삭제는 설정에서 진행합니다.

이전 버전에서 가입한 구독이 있다면 이 앱 업데이트만으로 해지되지 않습니다. Google Play의 정기 결제 화면에서 기존 구독을 확인·관리하세요.

문의 시 앱 버전, 기기, 오류 내용과 재현 방법을 알려주세요. 비밀번호나 접속 코드는 보내지 마세요. support@goldenspot.ai

14

문제 해결

탐지가 안 되거나 판정 보류가 나옵니다.

검사를 정지하고 화면에서 물체를 모두 치운 뒤 다시 시작하세요. 3→2→1 측정이 끝날 때까지 기다립니다. 카메라·조명을 고정하고 탐지라인이 제품 경로에 있는지 확인하세요. 물체가 완전히 이탈한 뒤 다음 제품을 투입하세요. 탐지모드와 배경 제외 안내를 확인하세요.

검사를 시작할 수 없습니다.

현재 SKU와 선택한 모델의 검사 지식 보유 여부, 모델 준비 상태를 확인하세요. 오픈 기념 무료 제공 기간에는 검사와 출력 모두 구독 없이 이용합니다. 재생성 필요가 표시되면 검사 최적화를 다시 적용합니다.

추론은 빠른데 결과가 늦게 나옵니다.

등록한 정상 이미지가 많으면 결과를 얻는 데 더 오래 걸릴 수 있습니다. SKU 지식관리에서 검사 최적화를 적용하고 정상·불량 판정을 다시 확인하세요. 시간모드는 촬영 시작 기준의 주기 중 남은 시간만 기다립니다. 처리 시간이 길면 지난 촬영 시점을 건너뜁니다. 검사 시간과 대기를 포함한 판정 주기를 구분하세요.

모니터링 URL이 보이지 않거나 접속되지 않습니다.

출력이 모니터링 웹인지, 사용이 켜져 있는지, Device ID·비밀번호를 저장했는지 확인하고 검사를 시작하세요. 앱을 전면에 유지합니다. HTTPS 주소를 그대로 사용하고 같은 LAN인지 확인하세요. 게스트 Wi-Fi의 장비 간 차단을 확인합니다. USB·이동통신 IP나 홈페이지 주소로 장비 모니터링에 접속할 수는 없습니다.

웹에서 로그아웃되거나 원본이 사라졌습니다.

다른 곳의 새 로그인, 장비 ID·비밀번호 변경, 앱 배경 전환 또는 세션 만료로 연결이 끝날 수 있습니다. 원본은 최대 24시간 또는 공간 정리 시점까지만 유지합니다.

알람이 들리지 않습니다.

웹은 알람 활성화 / 시험 재생과 브라우저 소리 권한을 확인하세요. 장비는 Edge 알람과 미디어 볼륨을 확인합니다. 두 알람의 Cooldown과 ON/OFF는 별개입니다.

검사 시작 후 설정이 사라지거나 변경되지 않습니다.

자동·탐지 검사는 영상과 판정에 집중하도록 설정 조작부 대신 요약 정보를 보여줍니다. 설정을 바꾸려면 검사 정지를 누르고 처리가 끝난 후 변경하세요. 시간모드 0s 단발검사는 완료 후 자동으로 설정이 활성화됩니다. 검사 중 화면과 설정 변경을 참고하세요.

정상 제품이 NG로 나옵니다.

등록 때의 조명·거리·구도와 같은지 먼저 확인하세요. 정상 변화가 충분히 등록되어 있는지 확인한 뒤 임계값과 최소 영역을 조정합니다. 작은 결함을 놓치지 않는지도 함께 검증하세요.