기기 기능

생체 인증

지문이나 얼굴 인식으로 사용자를 인증합니다. 자동 로그인이나 민감한 화면 진입 전에 본인 확인이 필요할 때 호출합니다.

biometricAuth(haptic?, callback)

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

생체정보 인증하기

AppBox.biometricAuth(haptic, callback)

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

Request 항목 정의

Request 항목필수여부설명기본값
haptic-성공 또는 실패 시 진동 햅틱 (true, false)-


Response 항목 정의

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


필요 권한: 생체인증. SDK가 요청하며, 거부 시 PERMISSION_DENIED(-7000)로 전달됩니다.

웹 브릿지에서는 생체 인증의 application.biometricAuth입니다.

앱 종료

앱을 종료합니다. 종료 확인 다이얼로그에서 사용자가 종료를 선택했을 때 호출합니다.

exit(callback): 잠금 없음

앱을 강제 종료

AppBox.exit(callback)

Kotlin
1 AppBox.exit { _, _ -> }
1 AppBox.exit((value, error) -> { });

항목 정의

앱의 모든 화면과 프로세스를 종료합니다. callback은 호출되지 않습니다. 프로세스가 사라지므로 이 함수 뒤의 코드는 실행되지 않습니다. 호출 즉시 종료되므로 "종료하시겠습니까?" 확인 후 호출하는 것이 자연스럽습니다.

웹 브릿지에서는 앱 종료의 application.exit입니다.

앱 설정으로 이동

이 앱의 OS 설정 화면을 엽니다. 사용자가 알림, 위치 등 권한을 직접 바꿔야 할 때 바로 이동시켜 줍니다.

openAppSettings(callback)

호출 형태: 패턴 A(인자 없는 값 조회).

OS의 앱 설정으로 이동

AppBox.openAppSettings(callback)

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

Request 항목 정의

Request 항목필수여부설명기본값
--별도 요청 항목 없음-


Response 항목 정의

Response 결과값
값성공 여부 (Boolean)
오류 코드-8000: 설정 화면 실행 실패

웹 브릿지에서는 앱 설정으로 이동의 application.openAppSettings입니다.

앱 평가

스토어 인앱 리뷰 요청 팝업을 띄웁니다. 사용자 만족 시점(미션 완료 등)에 호출해 평점 작성을 유도할 수 있습니다.

reviewRequest(callback)

호출 형태: 패턴 A(인자 없는 값 조회). 실행 중에 다시 호출하면 거절됩니다.

마켓의 앱 평가 점수 올리기

AppBox.reviewRequest(callback)

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

Request 항목 정의

Request 항목필수여부설명기본값
--별도 요청 항목 없음-


Response 항목 정의

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


리뷰 창이 실제로 뜨는지는 OS가 결정하므로 성공이 노출을 보장하지 않습니다. 호출 횟수 제한과 스토어 정책에 따라 표시되지 않을 수 있습니다. 스토어에 등록되지 않은 빌드나 에뮬레이터에서는 실패합니다.

웹 브릿지에서는 앱 평가의 application.reviewRequest입니다.

토스트 메시지

토스트 메시지를 띄웁니다. 저장 완료처럼 짧은 피드백을 사용자에게 보여줄 때 호출합니다.

toastShow(message, delaySecond, haptic?, textColor?, backColor?, fontSize?, callback)

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

토스트 메시지 띄우기

AppBox.toastShow(message, delaySecond, haptic, textColor, backColor, fontSize, callback)

Kotlin
1 AppBox.toastShow(message = "저장했습니다", delaySecond = 2, haptic = true,
2 textColor = "#FFFFFF", backColor = "#00000099", fontSize = 12) { value, error ->
3 if (error != null) return@toastShow
4 Log.d("AppBox", value.toString())
5 }
1 AppBox.toastShow("저장했습니다", 2, true, "#FFFFFF", "#00000099", 12, (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
message필수메시지-
delaySecond필수유지 시간(초). 0이면 사라지지 않고 터치해야 닫힙니다-
haptic-표시할 때 햅틱 진동 여부true
textColor-텍스트 색#FFFFFF
backColor-배경 색#00000099
fontSize-텍스트 크기12


Response 항목 정의

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


8자리 hex는 #RRGGBBAA라 iOS와 문자열을 공유할 수 없습니다 → 기기 기능 공통 규칙 개요의 인자 규칙.

웹 브릿지에서는 토스트 메시지의 application.toastShow입니다.

앱 업데이트

스토어 버전과 비교해 업데이트 팝업을 띄웁니다. 구버전 사용자를 최신 버전으로 유도할 때 호출합니다.

updatePrompt(require, message, googlePlay, updateButton, cancelButton?, updateAlert?, callback)

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

앱을 최신 버전으로 업데이트

AppBox.updatePrompt(require, message, googlePlay, updateButton, cancelButton, updateAlert, callback)

Kotlin
1 AppBox.updatePrompt(require = false, message = "마켓에 새로운 버전이 있습니다.",
2 googlePlay = "https://play.google.com/store/apps/details?id=com.example.app",
3 updateButton = "업데이트", cancelButton = "다음에", updateAlert = true) { value, error ->
4 if (error != null) return@updatePrompt
5 Log.d("AppBox", value.toString())
6 }
1 AppBox.updatePrompt(false, "마켓에 새로운 버전이 있습니다.",
2 "https://play.google.com/store/apps/details?id=com.example.app",
3 "업데이트", "다음에", true, (value, error) -> {
4 if (error != null) return;
5 Log.d("AppBox", String.valueOf(value));
6 });

Request 항목 정의

Request 항목필수여부설명기본값
require필수true면 강제 업데이트(닫을 수 없음), false면 권장-
message필수업데이트 안내 메시지-
googlePlay필수Google Play 다운로드 URL. https://play.google.com/store/apps/details?id={패키지명} 형식-
updateButton필수업데이트 버튼 텍스트-
cancelButton-취소 버튼 텍스트. require가 false면 사실상 필수입니다-
updateAlert-업데이트 안내를 SDK가 띄울지 여부. false면 앱이 직접 띄웁니다true


Response 항목 정의

Response 결과값
값Map<String, Boolean>
오류 코드-6000: 스토어에서 앱을 찾을 수 없음. 마켓에 등록하지 않은 빌드로 테스트하는 경우

웹 브릿지에서는 앱 업데이트의 application.updatePrompt입니다.

진동 울리기

기기를 진동시킵니다. 사용자 행동에 즉각적인 촉각 피드백을 줄 때 호출합니다.

vibrate(vibrationCount, type, callback)

호출 형태: 패턴 C(인자 있는 동작).

진동으로 알림을 명확하게

AppBox.vibrate(vibrationCount, type, callback)

Kotlin
1 AppBox.vibrate(vibrationCount = 1, type = "haptic") { value, error ->
2 if (error != null) return@vibrate
3 Log.d("AppBox", value.toString())
4 }
1 AppBox.vibrate(1, "haptic", (value, error) -> {
2 if (error != null) return;
3 Log.d("AppBox", String.valueOf(value));
4 });

Request 항목 정의

Request 항목필수여부설명기본값
vibrationCount필수진동 횟수-
type필수진동 타입: haptic / short / long-


Response 항목 정의

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


type은 long, short, haptic만 유효합니다. 그 외 값을 넘겨도 오류가 아니라 성공으로 끝나고 진동만 발생하지 않습니다.

웹 브릿지에서는 진동 울리기의 application.vibrate입니다.

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