생체 인증 | 사용자 경험, 알림, 인터랙션 | Appbox SDK 가이드
사용자 경험•알림•인터페이스
생체 인증
Touch ID 또는 Face ID를 활용해 특정 화면이나 기능 실행 전 사용자 인증을 요청할 수 있으며, 인증 결과는 웹으로 전달됩니다.
생체정보 인증하기
AppboxSDK.application.biometricAuth(...)
Javascript
1
// 생체 인증
2
AppboxSDK.application.biometricAuth( { haptic : true
}, (err, data) => {
3
if (err) {
4
console.error(
"생체 인증 실패:",
"code:", err.code,
"message:", err.message
);
5
} else {
6
console.log(
"생체 인증 OK:",
data.result
);
7
}
8
});
Request 항목 정의
| Request 항목 | 필수여부 | 설명 | 기본값 | |
|---|---|---|---|---|
| haptic | - | 성공 또는 실패시 진동 햅틱 (true, false) | ||
Response 항목 정의
| Response 결과값 | |
|---|---|
| data.result | 성공 여부 (true | false) |
| err.code | 에러코드 (-1000 : 사용자가 취소, -7000 : 생체 인증을 쓸 수 없음(지원 안 함, 미등록, 일시적 사용 불가, 잠김, iOS 는 기기 암호 미설정 포함), -9999 : 인증 실패, 기타) |
| err.message | 에러 메시지 |
카메라 권한과는 관계없습니다. iOS 는 생체 인증이 안 되면 기기 암호 입력으로 넘어갑니다.
생체인증을 사용하려면, 생체인증을 지원하는 디바이스 이여야 하며, 생체인증이 등록되어 있어야 합니다.
생체인증이 등록되지 않은 경우 err.code=-7000 으로 리턴됩니다.