스캔 및 코드 생성 | Appbox Android SDK 가이드

기기 기능

바코드 보기 팝업

전달한 문자열을 바코드로 그려 팝업으로 보여줍니다(스캔이 아닙니다). 멤버십 번호 제시 화면 등에 사용합니다.

barcodePopupOpen(barcode, haptic?, animation?, callback)

호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.

바코드를 팝업으로 노출

AppBox.barcodePopupOpen(barcode, haptic, animation, callback)

Kotlin
1 AppBox.barcodePopupOpen(barcode = "8801234567890", haptic = true, animation = true) { value, error ->
2 if (error != null) return@barcodePopupOpen
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.barcodePopupOpen("8801234567890", true, true, (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
barcode필수바코드로 그릴 문자열-
haptic-표시할 때 진동 여부true
animation-표시 애니메이션 사용 여부true


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)

웹 브릿지에서는 바코드 보기 팝업의 ui.barcodePopupOpen입니다.

바코드 리더기 오픈

바코드 스캐너를 띄우고 스캔한 값을 돌려줍니다. 상품 조회, 포인트 적립 같은 흐름에 사용합니다.

openBarcodeScanner(infoMessage?, messageColor?, defColor?, succColor?, haptic?, callback)

호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.

바코드 리더기로 바코드 받아오기

AppBox.openBarcodeScanner(infoMessage, messageColor, defColor, succColor, haptic, callback)

Kotlin
1 AppBox.openBarcodeScanner(infoMessage = "바코드를 비춰주세요.", messageColor = "#FFFFFF",
2 defColor = "#FFFFFF", succColor = "#0000FF", haptic = true) { value, error ->
3 if (error != null) return@openBarcodeScanner
4 Log.d("AppBox", value.toString())
5 }
1 AppBox.openBarcodeScanner("바코드를 비춰주세요.", "#FFFFFF", "#FFFFFF", "#0000FF", true, (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
infoMessage-화면에 표시할 안내 문구-
messageColor-안내 문구 색-
defColor-인식 전 가이드 프레임 색-
succColor-인식 성공 시 프레임 색-
haptic-인식 시 진동 여부true


Response 항목 정의

Response 결과값
값스캔 결과 (String)


필요 권한: 카메라. SDK가 요청하며, 거부 시 PERMISSION_DENIED(-7000)로 전달됩니다. 색상 인자가 잘못되면 이 함수는 예외적으로 투명이 되어 해당 요소가 보이지 않습니다 → 기기 기능 공통 규칙 개요의 인자 규칙.

웹 브릿지에서는 바코드 리더기 오픈의 scanner.openBarcodeScanner입니다.

QR 리더기 오픈

QR 스캐너를 띄우고 스캔한 값을 돌려줍니다. 로그인, 쿠폰 등록, 출석 체크 같은 흐름에 사용합니다.

openQRCodeScanner(infoMessage?, messageColor?, defColor?, succColor?, haptic?, callback)

호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.

QR 리더기 실행하기

AppBox.openQRCodeScanner(infoMessage, messageColor, defColor, succColor, haptic, callback)

Kotlin
1 AppBox.openQRCodeScanner(infoMessage = "QR을 비춰주세요.", messageColor = "#FFFFFF",
2 defColor = "#FFFFFF", succColor = "#0000FF", haptic = true) { value, error ->
3 if (error != null) return@openQRCodeScanner
4 Log.d("AppBox", value.toString())
5 }
1 AppBox.openQRCodeScanner("QR을 비춰주세요.", "#FFFFFF", "#FFFFFF", "#0000FF", true, (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
infoMessage-화면에 표시할 안내 문구-
messageColor-안내 문구 색-
defColor-인식 전 가이드 프레임 색-
succColor-인식 성공 시 프레임 색-
haptic-인식 시 진동 여부true


Response 항목 정의

Response 결과값
값스캔 결과 (String)


필요 권한: 카메라. SDK가 요청하며, 거부 시 PERMISSION_DENIED(-7000)로 전달됩니다. 색상 인자가 잘못되면 이 함수는 예외적으로 투명이 되어 해당 요소가 보이지 않습니다 → 기기 기능 공통 규칙 개요의 인자 규칙.

웹 브릿지에서는 QR 리더기 오픈의 scanner.openQRCodeScanner입니다.

QR 보기 팝업

전달한 문자열을 QR 코드로 그려 팝업으로 보여줍니다(스캔이 아닙니다). 초대, 인증, 티켓 확인 화면 등에 사용합니다.

qrcodePopupOpen(qr, haptic?, animation?, callback)

호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.

QR을 팝업으로 노출

AppBox.qrcodePopupOpen(qr, haptic, animation, callback)

Kotlin
1 AppBox.qrcodePopupOpen(qr = "https://appboxapp.com", haptic = true, animation = true) { value, error ->
2 if (error != null) return@qrcodePopupOpen
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.qrcodePopupOpen("https://appboxapp.com", true, true, (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
qr필수QR로 그릴 문자열-
haptic-표시할 때 진동 여부true
animation-표시 애니메이션 사용 여부true


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)

웹 브릿지에서는 QR 보기 팝업의 ui.qrcodePopupOpen입니다.

www.naver.com
QR 코드를 촬영하면 입력하신 주소의
앱 예시 화면을 테스트할 수 있습니다.
* 스캔 후 바로 앱 다운로드 이동합니다.