# harmony-utils之AuthUtil，生物認證相關工具類

## harmony-utils 簡介與說明

------
[harmony-utils](https://ohpm.openharmony.cn/#/cn/detail/@pura%2Fharmony-utils) 一款功能豐富且極易上手的HarmonyOS工具庫，借助眾多實用工具類，致力于助力開發者迅速構建鴻蒙應用。其封裝的工具涵蓋了APP、設備、屏幕、授權、通知、線程間通信、彈框、吐司、生物認證、用戶首選項、拍照、相冊、掃碼、文件、日志，異常捕獲、字符、字符串、數字、集合、日期、隨機、base64、加密、解密、JSON等一系列的功能和操作，能夠滿足各種不同的開發需求。    
[picker_utils](https://ohpm.openharmony.cn/#/cn/detail/@pura%2Fpicker_utils) 是harmony-utils拆分出來的一個子庫，包含PickerUtil、PhotoHelper、ScanUtil。

下載安裝  
`ohpm i @pura/harmony-utils`  
`ohpm i @pura/picker_utils`

全局初始化方法，在UIAbility的onCreate方法中初始化 AppUtil.init（） onCreate（want： Want， launchParam： AbilityConstant.LaunchParam）： void { AppUtil.init（this.context）;
}

## API方法與使用

------

##### getAvailableStatus  查詢指定類型和等級的認證能力是否支持

let status = AuthUtil.getAvailableStatus（userIAM_userAuth.UserAuthType.FACE， userIAM_userAuth.AuthTrustLevel.ATL1） if （status.status） { ToastUtil.showToast（“當前設備支持人臉識別”）;LogUtil.error（JSON.stringify（status， null， 2））;
}

##### onStartEasy  開始認證,使用指紋和密碼認證

AuthUtil.onStartEasy（true， （result： userAuth.UserAuthResult） => { let resultStr = JSON.stringify（result， null， 2）;
});

##### onStart  開始認證，用戶指定類型認證

AuthUtil.onStart（{ authType： [userAuth.UserAuthType.FACE]， authTrustLevel： userAuth.AuthTrustLevel.ATL3， title： '請驗證人臉'， showTip： true }， （result） => { let resultStr = JSON.stringify（result， null， 2）;
});

##### cancel  取消認證

AuthUtil.cancel（）;

##### generateChallenge 生成挑戰值,用來防重放攻擊

let challenge = AuthUtil.generateChallenge（）;

##### getErrorMsg 獲取錯誤msg

const errorTip = AuthUtil.getErrorMsg(result.result, '');

## 創作不易，請給童長老點贊