사용자 경험, 알림, 인터랙션 | Appbox Android SDK 가이드
기기 기능
생체 인증
지문이나 얼굴 인식으로 사용자를 인증합니다. 자동 로그인이나 민감한 화면 진입 전에 본인 확인이 필요할 때 호출합니다.
biometricAuth(haptic?, callback)
호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.
생체정보 인증하기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
haptic | - | 성공 또는 실패 시 진동 햅틱 (true, false) | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
필요 권한: 생체인증. SDK가 요청하며, 거부 시 PERMISSION_DENIED(-7000)로 전달됩니다.
웹 브릿지에서는 생체 인증의 application.biometricAuth입니다.
앱 종료
exit(callback): 잠금 없음
앱을 강제 종료
항목 정의
앱의 모든 화면과 프로세스를 종료합니다. callback은 호출되지 않습니다. 프로세스가 사라지므로 이 함수 뒤의 코드는 실행되지 않습니다. 호출 즉시 종료되므로 "종료하시겠습니까?" 확인 후 호출하는 것이 자연스럽습니다.
웹 브릿지에서는 앱 종료의 application.exit입니다.
앱 설정으로 이동
openAppSettings(callback)
호출 형태: 패턴 A(인자 없는 값 조회).
OS의 앱 설정으로 이동
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
| 오류 코드 | -8000: 설정 화면 실행 실패 |
웹 브릿지에서는 앱 설정으로 이동의 application.openAppSettings입니다.
앱 평가
reviewRequest(callback)
호출 형태: 패턴 A(인자 없는 값 조회). 실행 중에 다시 호출하면 거절됩니다.
마켓의 앱 평가 점수 올리기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
| - | - | 별도 요청 항목 없음 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
리뷰 창이 실제로 뜨는지는 OS가 결정하므로 성공이 노출을 보장하지 않습니다. 호출 횟수 제한과 스토어 정책에 따라 표시되지 않을 수 있습니다. 스토어에 등록되지 않은 빌드나 에뮬레이터에서는 실패합니다.
웹 브릿지에서는 앱 평가의 application.reviewRequest입니다.
토스트 메시지
toastShow(message, delaySecond, haptic?, textColor?, backColor?, fontSize?, callback)
호출 형태: 패턴 D(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.
토스트 메시지 띄우기
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(선택 인자가 여러 개인 함수). 실행 중에 다시 호출하면 거절됩니다.
앱을 최신 버전으로 업데이트
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(인자 있는 동작).
진동으로 알림을 명확하게
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
vibrationCount | 필수 | 진동 횟수 | - |
type | 필수 | 진동 타입: haptic / short / long | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | 성공 여부 (Boolean) |
type은 long, short, haptic만 유효합니다. 그 외 값을 넘겨도 오류가 아니라 성공으로 끝나고 진동만 발생하지 않습니다.
웹 브릿지에서는 진동 울리기의 application.vibrate입니다.