사용자 설명서

빠른 시작

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

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

Quick start

GoldenSpot AI for Android learns from registered normal product images and inspects new images for differences. This guide covers Android app 1.5.18 and the monitoring website served by the device.

1. Install and sign in. Install the supplied app. Select Start now to use it without signing in, or choose Continue with Google. Internet access is required for initial access. Allow camera permission.
2. Select the input. In Settings → Input, choose On-Device CAM or RTSP. Fix the product position and lighting for the rear camera, or enter RTSP credentials and save.
3. Select the model. In Settings → General, choose Fast or Detailed. Start with Fast.
4. Register normal images. Place a defect-free product in the center and tap Register normal. At least one registration is required.
5. Inspect. Choose Time or Detection mode. Time mode follows the capture interval. Start Detection mode with an empty scene, wait for the 3→2→1 calibration to finish, then introduce the product.
6. Review. Check OK/NG, Score, Threshold and measurement time. Validate your criteria using both normal and defective samples.

설치와 촬영 준비

Android 8.0 이상이 필요합니다. 검사 속도와 등록 가능한 이미지 수는 휴대폰에 따라 다릅니다. 처음 시작하거나 Google로 로그인할 때 인터넷이 필요합니다. 현재 비공개 테스트 버전은 구독 구매 없이 이용합니다.

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

스토어 또는 담당자가 제공한 정식 배포본을 사용하세요. 이 설명서는 현재 비공개 테스트 버전을 기준으로 합니다.

Installation & capture

Android 8.0 or later is required. Inspection speed and the number of images you can register depend on your phone. Initial access and Google sign-in require internet access. The current closed-test version does not require a subscription purchase.

• Keep position, distance, background and lighting consistent. Reduce reflections, motion blur and focus errors.
• Inspection uses the central square crop of the video. Keep every area you need to inspect within this crop.
• Keep the app in the foreground. Automatic inspection keeps the screen awake, but moving the app to the background stops inspection and monitoring.
• Monitoring requires the phone and browser to reach each other on the same Wi-Fi or LAN.

Use the official distribution supplied through the store or your provider. This manual describes the current closed-test version.

정상 이미지와 모델

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

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

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

Normal images & models

Register acceptable variations in normal product position, lighting and shape. Never register a defective item as normal. Repeated near-duplicate images increase comparison time and memory usage.

Detailed may require more memory and processing time than Fast. It does not guarantee higher accuracy for every product; validate with actual samples.

• Model selection: Applies immediately. Register normal images for that model.
• Registration limit: Adjust in Settings → Knowledge management. Device memory limits the maximum. Lowering the limit does not delete existing images.
• Reset: After confirmation, resets normal images and optimization for the current SKU and model. This reset preserves other models' registrations. Changing SKU deletes knowledge for all models.

시간모드와 탐지모드

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

시간모드 · 간격에 따라 촬영

촬영간격 0s는 버튼을 누를 때 한 번 검사합니다. 1·2·3·5s는 시작 즉시 첫 검사를 수행하고, 각 검사가 끝난 뒤 선택한 간격만큼 기다렸다가 반복합니다. 실제 촬영 간격에는 처리 시간도 포함됩니다.

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

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

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

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

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

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

Time and Detection modes

While inspection is stopped, select Time / Detection mode on the main screen. Both support the phone camera and RTSP input.

Time mode · capture by interval

A 0s capture interval inspects once per button press. 1, 2, 3 or 5s starts the first inspection immediately, then waits the selected interval after each inspection finishes. Processing time adds to the actual time between captures.

Detection mode · detect → capture → inspect

1. Register normal products for the current SKU and model, then remove objects from the entire view to leave an empty background. Keep the camera and lighting fixed.
2. Move the detection line up or down to the product path. Choose a capture delay of 0, 0.5, 1 or 2s. 0s captures immediately after detection.
3. Tap Start inspection. After acquiring the empty background reference, a large 3 → 2 → 1 countdown appears. Keep the view empty during this step.
4. When calibration finishes and the app is ready, introduce the product. A change at the detection line triggers capture after the chosen delay, followed by inspection.
5. After the inspected object leaves the line and the background reappears, the app waits for the next product. It does not repeatedly capture an object that remains on the line.

Mode and line position cannot be changed during inspection. Line position and capture delay are saved per SKU. Stopping or moving the app to the background cancels pending capture. Every new start measures a fresh reference from an empty scene.

Background exclusion and withheld inspections

Detection mode compares the captured image with the starting empty background to identify the object area. Areas identified as background are excluded from the anomaly score, OK/NG decision and marked defect regions. The screen, history, alarms and outbound results use the same final decision. This feature applies to Detection mode, not Time mode.

If the camera position, background or lighting changes, stop, remove the object and restart. Objects similar in color to the background, shadows, vibration and moving backgrounds can affect detection and separation. Validate with actual normal and defective products. The starting background capture is not saved or sent as an inspection result.

판정과 NG 영역 이해

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

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

최소 BBOX 면적

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

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

표시되는 시간과 가속기

추론 시간은 모델 실행 시간이며 최종 결과까지 걸리는 전체 시간과 다릅니다. 리포트에는 후처리 시간이 표시됩니다. 상단의 QNN / GPU / NPU / CPU 배지는 실제 선택된 가속기입니다. 앱이 자동으로 선택하므로 별도로 설정할 필요는 없습니다.

Results & defect regions

Score measures anomaly relative to registered normal data; it is not a defect probability. Threshold is the decision cutoff. NG requires a score at or above the threshold and, when the area filter is enabled, at least one region that passes it.

A lower threshold is more sensitive to differences; a higher one reduces NG decisions. Tune it with actual normal and defective samples. Revalidate after changing lighting or models.

Minimum BBOX area

Settings → General → Minimum defect area (%) defaults to 0.01%. The percentage is the area of the defect’s marked rectangle relative to the entire inspection image.

Smaller regions are excluded from decisions, display and delivery. 0% disables this filter. Check that real small defects are not excluded.

Timing and accelerator

Inference time measures model execution, not the full time to a final result. Report timing covers postprocessing. The QNN / GPU / NPU / CPU badge shows the selected accelerator. The app selects it automatically; no separate setting is needed.

일반 설정과 속도 조정

• 언어: 자동 / 한국어 / English. 자동은 기기 언어를 따르고 미지원 언어는 영어로 표시합니다. 언어 변경은 즉시 반영되며 검사와 연결을 유지합니다.
• 장비명(Device ID): 공백 없이 최대 80자. 모니터링 로그인 ID로도 사용합니다. 예: LINE-01.
• SKU: 최대 80자의 제품 코드입니다. SKU는 1개만 사용하며 검사 지식과 1:1로 연결됩니다. SKU를 변경하고 저장하면 기존 검사 지식 삭제 안내와 YES/NO 확인창이 표시됩니다. YES는 모든 모델의 정상 등록·최적화·수신 지식을 삭제하고 새 SKU를 빈 상태로 시작합니다. NO는 SKU 변경을 취소하고 기존 지식을 유지합니다. 삭제는 되돌릴 수 없으므로 새 SKU의 지식을 다시 등록하거나 받아야 합니다. 빈 값은 DEFAULT로 처리합니다. 다른 장비와 전송할 때는 양쪽의 현재 SKU를 정확히 맞추세요.
• 장비 NG 알람: ON/OFF, 지속시간 1~10초, Cooldown 0~300초. 음량은 휴대폰 미디어 볼륨으로 조절합니다. 웹 알람과 독립적으로 동작합니다.

3×3 그리드 표시

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

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

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

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

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

General settings & performance

• Language: Auto / 한국어 / English. Auto follows the device language and falls back to English for unsupported languages. Changes apply immediately without stopping inspection or connections.
• Device ID: Up to 80 characters, without spaces. Also the monitoring login ID. Example: LINE-01.
• SKU: A product code of up to 80 characters. Only one SKU is used, paired with one set of inspection knowledge. Changing the SKU and saving opens a deletion warning with YES/NO confirmation. YES deletes normal registrations, optimization and received knowledge for all models and starts the new SKU empty. NO cancels the SKU change and preserves existing knowledge. Deletion cannot be undone; register or receive knowledge for the new SKU again. An empty value uses DEFAULT. Set exactly the same current SKU on both devices before sharing knowledge.
• Device NG alarm: On/off, duration 1–10 seconds, cooldown 0–300 seconds. Use phone media volume for loudness. Independent of the web alarm.

Show 3×3 grid

Enable Show 3×3 grid in Settings → General and save. It is off by default. Thin 1px ivory lines help position objects in the phone camera and RTSP previews. The grid is not included in saved images or AI inspection.

When more registrations make inspection slower

Settings → Knowledge management → Inspection optimization offers Standard mode or Optimized data.

1. Stop inspection.
2. Select Optimized data and Low, Medium or High. Start testing at Medium.
3. Tap Apply optimization. It applies immediately, separately from Save.
4. Revalidate scores and thresholds with normal and defective samples.

Tap ? beside a setting to learn its purpose, selection guidance and effect. Save General settings when required. Model selection and registration limits and inspection optimization apply immediately.

입력 영상 설정

On-Device CAM

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

RTSP

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

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

Camera & RTSP input

On-Device CAM

Uses the phone's rear camera. If access is denied, allow camera permission in the app or Android app settings.

RTSP

1. Join a network that can reach the camera.
2. Select Settings → Input → RTSP.
3. Enter the full address, username and password. Example: rtsp://192.168.0.10:554/stream1. Use the address supplied by your camera manufacturer.
4. Configure H.264 video on the camera and save.
5. Once video appears, register normal images and inspect.

The stream path depends on the camera manufacturer; an IP alone is insufficient. Enter credentials in their separate fields, not in the URL. Interrupted video stops automatic inspection. Check network, credentials and video format, then reconnect.

출력소스와 자동 전송

설정은 일반·입력소스·출력소스·지식관리로 나뉩니다. 설정 → 출력소스에서 한 가지 방식만 선택합니다. MQTT도 같은 출력 방식 목록에서 선택합니다. MQTT를 켜면 REST POST·FTP·SFTP·WebSocket·모니터링 웹 출력의 선택과 실행이 차단됩니다. 다른 방식으로 바꾸려면 MQTT 설정에서 먼저 끄세요. MQTT의 이미지 조회 API는 함께 제공됩니다. 전송 사용을 켜고 접속 정보를 저장하면 다음 결과부터 적용됩니다.

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

REST POST·FTP·SFTP·WebSocket 재전송

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

Output & automatic delivery

Settings has General, Input, Output and Knowledge management tabs. Select one output method in Settings → Output. Select MQTT from the same output-method list. While MQTT is enabled, REST POST, FTP, SFTP, WebSocket and monitoring web cannot be selected or run. Turn MQTT off before choosing another output. Its image retrieval API remains available alongside MQTT. Enable delivery and save the connection details to apply them to subsequent results.

Use HTTPS, SFTP and WSS for encryption. Obtain and verify the SFTP fingerprint with the server administrator and create the destination folder first. Socket uses WebSocket, not a raw TCP socket.

REST POST, FTP, SFTP and WebSocket retries

Choose 0–3 additional attempts after an initial failure. Three retries allow up to four attempts, with 1, 2 and 4-second delays. Failure does not stop inspection, but pending results are lost when the app closes. The receiving server should deduplicate using event_id.

모니터링 웹 사용

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·카메라·장비 알람을 변경할 수 없습니다.

Monitoring web

1. Enter a Device ID in General settings.
2. Enable Monitoring web in Output, set a 10–128-character password and save.
3. Start inspection. An accessible HTTPS URL appears above the inspection view when the service runs.
4. Open that exact URL in a browser on the same network. On first access, compare the browser certificate with the SHA-256 fingerprint shown by the app before trusting the device certificate.
5. Sign in with Device ID and the monitoring password, not your Google account password.

Images and status

The left panel shows the image and NG regions. The right shows verdict, score, threshold, device, SKU, measurement time and status. Click the image to expand that measurement's original. This is the central square JPEG used for inspection, not the full camera sensor image.

Latest 20 results is the live list. The 24-hour history tab retrieves saved results. Retention is up to 24 hours; older records may be removed earlier when storage is low. Deleted originals cannot be retrieved.

NG Only and alarms

NG Only filters the view while total counts and device status keep updating. Counts cover the current monitoring service session. In the header Alarm menu, set on/off, volume and cooldown, then select Enable / test alarm. Web alarms stop when the browser closes.

The header language selection is stored per browser, independently of device language. Only one viewer is allowed; a new sign-in ends the previous session. Password changes or resets apply after saving on the device. The web cannot change SKU, threshold, AI, camera or device alarm settings.

외부 프로그램 연동 참고

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

{
  "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
      }
    ]
  }
}

External integration reference

For those connecting external programs. If you only use the app for inspection, continue to the next section.

{
  "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
      }
    ]
  }
}

지식관리와 QR 지식 전송

설정 → 지식관리에서 검사 최적화, 정상 이미지 등록 상한, 다른 장비와 지식 주고받기를 관리합니다.

보내는 장비

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

받는 장비

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

받은 지식은 모델과 데이터 종류에 맞춰 기존 지식에 추가됩니다. 중복된 지식은 제외하며, 전송이 실패하거나 취소되어도 기존 지식은 유지됩니다. 전송되는 것은 검사 지식이며, 원본 이미지와 계정·장비 설정은 포함되지 않습니다.

받은 지식으로 검사하기

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

Knowledge management and QR transfer

Settings → Knowledge management groups inspection optimization, registration limits and device-to-device knowledge sharing.

Sending device

1. Check that the selected SKU has knowledge to send.
2. Open Knowledge management → Share knowledge with another device → Send · Generate QR. Inspection stops.
3. Keep the QR screen open for the receiver. It expires after 10 minutes and is revoked when closed or when the app moves to the background.

Receiving device

1. Select Receive · Scan QR and allow camera access.
2. Hold the phone upright in portrait orientation and fit the sender’s QR inside the central scanning area. One scan lets you receive standard and optimized data for both Fast and Detailed models.
3. The app checks matching SKU and model compatibility after connecting.
4. Read the merge notice and select YES. NO exits without downloading or merging knowledge.
5. Wait for the four cases below to finish receiving and merging.

Received knowledge is added to the matching model and data type. Duplicates are excluded, and existing knowledge is preserved if transfer fails or is cancelled. Only inspection knowledge is shared; original images, accounts and device settings are not included.

Inspect with received knowledge

Select the model and Inspection optimization in Knowledge management. Tap Use saved optimization to use received optimized data. Apply optimization applies a new optimization at the selected level. Transfer alone does not change the active setting. Revalidate with normal and defective samples.

MQTT 서버와 이미지 조회

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

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

앱의 인증서 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 사용 여부와 접속 코드를 확인하고, 이미지 없음 응답은 해당 이미지가 남아 있는지 확인하세요.

MQTT server and image retrieval

The phone is the MQTT server. External programs connect to the phone and subscribe to inspection results. No external broker address is required in the app.

1. Connect the phone and external program to a network where they can reach each other.
2. Select MQTT from the output-method list in Settings → Output. Selection alone does not start it; the switch defaults to DISABLE. Turn on Enable MQTT to start it immediately and block other outputs from being selected or run. Tap ? beside MQTT for help.
3. Enter the displayed phone address and 9-character uppercase-letter/digit access code in the external program. Expand integration details for additional connection information.
4. Connect and subscribe using the settings below, then inspect while keeping the app in the foreground.

Verify the certificate SHA-256 fingerprint shown by the app. Keep the access code private. MQTT supports subscribing to results, not publishing external commands. Pending events are retained while there is no subscriber; deduplicate received events using event_id.

Image library REST API

MQTT messages do not contain image data. Enabling MQTT automatically enables image retrieval, with no separate setting. Use the message’s image_id to request the original JPEG.

GET https://PHONE_ADDRESS:8443/api/v1/image-library/images/{image_id}/file
Authorization: Bearer YOUR_9_CHARACTER_ACCESS_CODE

Substitute the actual phone address, image ID and access code. Verify the HTTPS certificate against the app’s fingerprint. For authentication failures, check MQTT and the code. An image-not-found response means the requested image is unavailable.

시작·로그아웃·지원

시작 화면의 바로 시작을 누르면 로그인 없이 이용할 수 있습니다. Google 계정을 사용하려면 Google로 계속하기를 선택합니다. 로그인 없이 이용 중에도 상단의 로그아웃 아이콘으로 시작 화면으로 돌아갈 수 있습니다.

상단에는 가속기 배지와 설정(톱니바퀴)·초기화(되돌림 화살표)·로그아웃(나가기 화살표) 아이콘이 한 줄로 표시됩니다.

지원 요청에는 앱 버전, 기기 모델, 입력소스, 오류 문구와 재현 순서를 알려주세요. 비밀번호·접속 코드·QR 인증 정보는 보내지 마세요. [email protected] · 앱 고객지원

Starting, signing out and support

Select Start now to use the app without signing in, or Continue with Google to use a Google account. The header sign-out icon returns to the start screen even when using the app without signing in.

The header shows the accelerator badge and Settings (gear), Reset (circular arrow) and Sign out (exit arrow) icons in one row.

For support, include app version, device model, input source, error text and reproduction steps. Do not send passwords, access codes or QR credentials. [email protected] · App support

문제 해결

Troubleshooting