본문으로 건너뛰기

Scanner (스캐너) Widget Control

Scanner(스캐너) 위젯을 스크립트에서 제어할 때 사용하는 Widget Control(Property · Method · Event) 목록입니다. 위젯 소개와 사용법은 Scanner 문서를 참고하세요.

정보

아래 예시의 scannerID는 캔버스에서 Scanner 위젯에 지정한 이름(ID)입니다. 스크립트에서는 위젯ID.멤버 형태로 접근합니다.

Widget Control 요약​

Widget Control종류시그니처설명
onChangedEventonChanged = (lastScannedText) => { ... }새 QR 코드·바코드를 인식했을 때 실행

Property​

정보

해당 없음 - Scanner 위젯에는 스크립트 전용 Property가 없습니다. 스크립트에서는 아래 공통 Widget Control(getProperty / setProperty)로 값을 읽고 씁니다.

Method​

정보

해당 없음 - Scanner 위젯에는 전용 Method가 없습니다. 아래 공통 Widget Control을 사용합니다.

Event​

onChanged​

스캔 영역 안의 QR 코드나 바코드를 새로 인식하면 실행됩니다. 핸들러는 인식된 코드의 텍스트를 인자로 받습니다.

  • 종류: Event
  • 핸들러: 인자 1개를 받는 콜백 함수
  • Parameters: lastScannedText (string) - 인식된 코드의 디코딩 텍스트
  • Returns: 없음

Example

scannerID.onChanged = (lastScannedText) => {
  // 인식된 코드 텍스트 처리
  console.log(lastScannedText);
};

공통 Widget Control (모든 위젯)​

노트

모든 위젯은 setProperty / getProperty / setStyleProperty 같은 이름 기반 공통 Widget Control(Method)을 사용할 수 있습니다. 공통 레퍼런스 문서(작성 예정)를 참고하세요.