Skip to content

生物测量管理器

初始化

要初始化组件,请使用initBiometryManager函数:

typescript
import { initBiometryManager } from '@telegram-apps/sdk';

const [biometryManager] = initBiometryManager();

INFO

由于 BiometryManager 无法同步实例化,因此该函数返回一个承诺,在获取生物测量管理器数据时, 。

认证

要验证用户身份,请使用 authenticate 方法:

ts
bm
  .authenticate({ reason: 'Authorize to unlock the storage' })
  .then(token => {
    console.log('Token received', token);
  });

此方法接受一个可选的 reason: string 属性,长度不超过 128 个符号。

打开设置

要打开包含生物测量设置的模态窗口,请使用 openSettings 方法:

ts
bm.openSettings();

在该模式下,用户可以打开或关闭生物测量功能。

申请访问

要申请使用生物测量的权限,请使用 requestAccess 方法:

ts
bm
  .requestAccess({ reason: 'Authorize to start using biometry' })
  .then(accessGranted => {
    console.log('Access granted', accessGranted);
  });

除了 authenticate 方法外,它还接受一个可选的 reason: string 属性,长度为 ,最多 128 个符号。

更新生物测量令牌 - Biometry Token

要更新存储在安全存储器中的令牌,请使用 updateToken 方法:

ts
bm
  .updateToken({ token: 'My token' })
  .then(status => {
    console.log('Token updated', status);
  });

此方法返回一个包含执行状态的 promise。

事件

可被 跟踪 的事件列表:

事件监听函数触发条件
change:accessGranted(value: boolean) => void已更改 accessGranted 属性
change:accessRequested(value: boolean) => void更改了 accessRequested 属性
change:available(value: boolean) => void更改了 available 属性
change:deviceId(value: string) => void已更改 deviceId 属性
change:tokenSaved(value: boolean) => void更改了 tokenSaved 属性
change:token(value: string) => void更改了 token 属性
change:biometryType(value: BiometryType) => void更改了 biometryType 属性

方法支持

方法列表,可用于 支持检查authopenSettingsrequestAccessupdateToken

Released under the MIT License.