获取设备特性
getFeatures 用来读取设备当前的能力和状态,例如固件版本、设备 ID、蓝牙信息、语言、名称、安全设置等。很多链 API 需要 device_id,因此 BLE 连接后通常会先调用一次该方法。
const requestResult = await ukeySdk.getFeatures(connectId);
如果设备屏幕停留在其他页面,调用该方法也可以让设备回到主界面状态。
入参
参考片段
const requestResult = await ukeySdk.getFeatures(connectId);
输出
{
success: true,
payload: {
major_version: number, // 大版本号
minor_version: number, // 次版本号
patch_version: number, // 修订版本号
bootloader_mode: null,
device_id: string,
pin_protection: boolean,
passphrase_protection: boolean, // 是否开启密码短语保护
language: string,
slot: string, // 设备标签名称
initialized: boolean, // 设备是否已初始化
model: string,
safety_checks: string,
ble_name: string, // 蓝牙广播名称
ble_ver: string, // 蓝牙固件版本号
ble_enable: string,
se_enable: boolean,
se_ver: string,
backup_only: boolean,
ukey_version: string, // 主固件版本号
ukey_serial: string, // 设备序列编号
bootloader_version: string, // Bootloader 版本
}
}
异常
{
success: false,
payload: {
error: string, // 异常说明
code: number // 状态码
}
}