Scanner
Scanner(스캐너) 위젯은 기기 카메라로 QR 코드와 바코드를 인식하는 위젯입니다.
인식된 코드가 웹 링크면 화면 아래 배너로 바로 열 수 있고, 인식된 텍스트는 스크립트에서 활용할 수 있습니다.
정의 / 역할
Scanner 위젯은 카메라 미리보기 위에 스캔 가이드 영역을 그리고, 그 안에 들어온 QR 코드 또는 바코드를 인식합니다. 인식에 성공하면 마지막 인식 텍스트가 저장되고 onChanged 동작이 실행됩니다. 편집(디자인) 모드에서는 카메라 대신 미리보기 안내가 표시되고, 앱을 실행하면 실제 카메라가 동작합니다.
- 카테고리: Contents
- 기본 스캔 대상: QR 코드
- 기본 카메라: 후면
- 기본 사이즈(Sized Box): 가로
infi, 세로200
기능
| 기능 | 설명 |
|---|---|
| QR·바코드 인식 | 카메라로 QR 코드 또는 1D 바코드를 인식합니다. formats로 인식 대상을 고릅니다. |
| 링크 배너 | 인식된 코드가 http/https 링크면 화면 아래에 배너를 띄우고 '열기'로 앱 내 웹뷰에서 엽니다. |
| 마지막 인식 텍스트 | 가장 최근 인식한 코드 텍스트를 저장하고 onChanged 동작으로 전달합니다. |
| 카메라·플래시 설정 | 전·후면 카메라 선택과 플래시(토치) 켜기를 설정합니다. |
| 인식 주기 | detectionTimeoutMs로 인식 처리 간격(밀리초)을 조정합니다. |
사용 방법
- 왼쪽 위젯 팔레트에서 Contents 카테고리를 엽니다.
- Scanner 항목을 캔버스로 끌어다 놓습니다.
- 오른쪽 속성 패널에서 스캔 대상(
formats)·카메라 방향(lensFacing) 등을 설정합니다. - 필요하면
onChanged에 코드 인식 후 실행할 동작(로직·스크립트)을 연결합니다. - 앱을 실행하면 카메라가 켜지고 스캔 영역 안의 코드를 인식합니다.
속성 (Property)
| 속성 | 설명 | 기본값 | 값 / 타입 |
|---|---|---|---|
lastScannedText | 가장 최근에 인식한 코드 텍스트 | 미지정 | 문자열 |
lensFacing | 사용할 카메라 방향 | back (후면) | back, front |
torchEnabled | 플래시(토치) 켜기 | false (꺼짐) | 참 / 거짓 |
formats | 인식할 코드 종류 | qr | qr, barcode |
detectionTimeoutMs | 인식 처리 간격(밀리초) | 250 | 숫자(ms) |
showLinkBanner | 링크 배너 표시 여부 | true (켜짐) | 참 / 거짓 |
주의 / 팁
경고
카메라를 사용하므로 실제 인식은 앱 실행 상태에서만 동작합니다. 편집(디자인) 모드에서는 미리보기 안내만 표시되며, 기기 카메라 권한이 필요합니다.
팁
formats를 barcode로 두면 code128·ean13·upc 등 여러 1D 바코드를 함께 인식하고, qr이면 QR 코드만 인식합니다. 같은 링크는 2초 안에 다시 인식돼도 배너를 다시 띄우지 않습니다.
더 알아보기
팁
이 위젯을 스크립트로 제어하는 Widget Control(Property·Method·Event) 전체는 Scanner (스캐너) Widget Control 문서에서 확인하세요.