사용자 경험, 알림, 인터랙션 | Appbox iOS SDK 가이드
사용자 경험, 알림, 인터랙션
생체 인증
생체정보 인증하기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
haptic | - | 성공 또는 실패시 진동 햅틱 (true, false) | - |
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 불필요. 축약형 (completion:)
웹 브릿지에서는 생체 인증의 application.biometricAuth입니다.
앱 종료
앱을 강제 종료
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 불필요. 셀렉터가 exitApp...입니다. iOS는 앱의 임의 종료를 권장하지 않습니다. 심사에서 문제가 될 수 있습니다
웹 브릿지에서는 앱 종료의 application.exit입니다.
앱 설정으로 이동
OS의 앱 설정으로 이동
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 불필요. 이 앱의 iOS 설정 화면을 엽니다
웹 브릿지에서는 앱 설정으로 이동의 application.openAppSettings입니다.
앱 평가
마켓의 앱 평가 점수 올리기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 불필요. 화면을 띄우는 다른 함수가 진행 중이면 -1003으로 실패합니다. SKStoreReviewController 요청입니다. iOS가 실제 표시 여부를 결정하므로 성공이 노출을 보장하지 않습니다
웹 브릿지에서는 앱 평가의 application.reviewRequest입니다.
토스트 메시지
토스트 메시지 띄우기
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
message | 필수 | 메시지 | - |
delaySecond | 필수 | 유지 시간(초). 0이면 사라지지 않고 터치해야 닫힙니다 | - |
backColor | - | 배경 색 | #000000 |
textColor | - | 텍스트 색 | #FFFFFF |
fontSize | - | 텍스트 크기 | 12 |
haptic | - | 표시할 때 햅틱 진동 여부 | true |
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 필요. 축약형 (message:delaySecond:completion:)
웹 브릿지에서는 토스트 메시지의 application.toastShow입니다.
앱 업데이트
앱을 최신 버전으로 업데이트
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
message | 필수 | 업데이트 안내 메시지 | - |
cancelButton | - | 취소 버튼 텍스트. require가 false면 사실상 필수입니다 | - |
updateButton | 필수 | 업데이트 버튼 텍스트 | - |
appStore | 필수 | App Store 다운로드 URL. https://apps.apple.com/kr/app/id{Apple ID} 형식 | - |
require | 필수 | true면 강제 업데이트(닫을 수 없음), false면 권장 | - |
updateAlert | - | 업데이트 안내를 SDK가 띄울지 여부. false면 앱이 직접 띄웁니다 | true |
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | [String: Any]? |
| 오류 | 실패 원인. NSError |
화면 필요. 축약형 (message:cancelButton:updateButton:appStore:require:completion:)
웹 브릿지에서는 앱 업데이트의 application.updatePrompt입니다.
로딩 인디케이터 표시
로딩 인디케이터 표시
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
loadingIcon | 필수 | 표시할 아이콘 리소스 | - |
sizePercentage | - | 화면 가로 대비 크기 비율(%) | 10 |
backColor | - | 배경 색 | #1a000000 |
iconColor | - | 아이콘 틴트 색 | #999999 |
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 필요. 축약형 (loadingIcon:completion:)
웹 브릿지에서는 application.loadingShow입니다.
진동 울리기
진동으로 알림을 명확하게
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 |
|---|---|---|---|
type | 필수 | 진동 타입: haptic / short / long | - |
vibrationCount | 필수 | 진동 횟수 | - |
completion | 필수 | 결과를 받는 콜백. 메인 스레드에서 한 번 호출됩니다 | - |
Response 항목 정의
| Response 결과값 | |
|---|---|
| 값 | Bool |
| 오류 | 실패 원인. NSError |
화면 불필요. type으로 진동 종류를 지정합니다
웹 브릿지에서는 진동 울리기의 application.vibrate입니다.