기존 스캐너에 WIA Code 얹기

이미 QR 디코더를 돌리고 있는 POS·키오스크·스캐너 SDK 팀을 위한 페이지입니다. 이미 배포 중인 QR 경로를 건드리지 않고 그 옆에 WIA Code 해독을 나란히 얹는 가장 짧은 경로입니다.

어떻게 붙는가

기존 QR 경로는 무수정입니다. WIA Code 해독은 같은 프레임 위에서 그 옆에 나란히 돕니다.

최소 통합 코드

같은 프레임에 호출 하나만 더합니다. 기존 QR 라이브러리가 아무것도 못 찾으면 같은 ImageData를 WiaScan.detectAuto()에 넘기세요.

async function onFrame(imageData) {
  // your existing decoder, unchanged:
  const qr = existingQrLib.decode(imageData);
  if (qr) return handleResult(qr.data);

  // same frame, handed to WIA Code:
  const wia = WiaScan.detectAuto(imageData, { psf: true, deep: true });
  if (wia && wia.decoded) return handleResult(wia.text);
}

이 detectAuto() 호출은 이 페이지를 게시하기 전에 실제 적합성 벡터(clean_square_url.png, 평가 킷)로 직접 실행해 정상 해독을 확인했습니다 — 돌려보지 않은 예시 코드가 아닙니다.

직접 만든 빌드도 같은 방법으로 검증하세요: 적합성 벡터 35장 전체를 레퍼런스 엔진으로 돌리는 node verify.js 한 줄 — 평가 킷 ↗.

어느 스캐너가 가능한가

이건 소프트웨어 변경이지 하드웨어 변경이 아닙니다 — 단, 애초에 이미지를 취득하는 스캐너에 한해서입니다.

스캐너 종류	SW 업데이트로 가능한가	이유
카메라식 2D 이미저, 폰/키오스크/웹캠	가능	실제 이미지 프레임을 취득합니다 — 위 예시가 해독하는 입력과 동일합니다.
레이저식 1D/CCD 레이저 바코드 스캐너	불가	이미지 자체를 취득하지 않습니다 — 한 줄로 반사된 레이저 세기만 측정합니다. `detectAuto()`에 넘길 프레임이 애초에 없습니다.

과장 없이: 레이저 스캐너는 펌웨어 업데이트로 이 코드를 읽지 못합니다. 이건 로드맵상의 공백이 아니라 센서의 물리적 한계입니다.

아직 통합 안 한 스캐너도 오늘부터 동작합니다

모든 WIA Code는 wiacode.com/s.html로 가는 작은 표준 QR 패치(부스터)를 함께 담고 있습니다. 여러분의 기존 QR 리더도 — 무수정 그대로 — 이미 그 패치를 스캔해 브라우저 안 WIA 웹 스캐너에 도달할 수 있습니다. 네이티브 통합이 없애는 건 그 사이의 여분 단계입니다.

	부스터만(미통합)	본체 직독(이 페이지)
페이로드까지 단계	2단계 — 부스터 스캔 → 페이지 로드 → 코드에 카메라를 다시 갖다 댐	1단계 — 여러분의 파이프라인이 바로 해독
네트워크	필요 — 웹페이지를 불러옵니다	불필요 — 완전 오프라인
받는 것	직접적으로는 없음 — 부스터는 고정된 리다이렉트 URL만 담고 있습니다	원본 페이로드 문자열 그대로, 여러분의 앱 안에서
인식되는 모양	내부에 박힌 작은 사각 패치뿐	공개된 8종 실루엣 전부
해독 지연	여러분의 QR 판독 + 네트워크 왕복	단일 프레임 해독 — 레퍼런스 엔진 자체 디버그 HUD 실측 기준 프레임당 약 386ms

개방 서약

적합성 테스트를 통과하는 구현이라면 누구에게나 무료입니다 — 로열티 없고, 경쟁 스캐너라고 예외를 두지 않습니다. 전문 서약과 평가 킷 보러 가기 ↗

킷을 돌려본 뒤에도 질문이 남으셨나요? 대량 발급·제휴·상용 도입 문의도 같은 주소로 받습니다. wiasoom@smilestory.ai