查设备

searchDevices 用来枚举当前 SDK 能访问到的 UKey Wallet 设备。通常在用户完成 USB 授权或 BLE 扫描后调用，用于拿到后续请求需要的 connectId。

不同传输方式返回的信息略有差异。WebUSB 场景通常会直接返回较完整的设备信息；BLE 场景一般先返回设备名称和 connectId，连接后再通过 getFeatures 获取 device_id 等详细信息。

在 UI 上建议先展示设备名称，让用户选择目标设备，再进入连接和特征读取流程。

const requestResult = await ukeySdk.searchDevices();

入参

• 无

参考片段

ukeySdk.searchDevices().then((result) => {
  console.log(`扫描到的设备列表: ${result}`);
});

输出

{
    success: true,
    payload: [
        {
            "connectId": string, // 设备连接句柄，同一设备下通常比较稳定，重置也不受影响
            "uuid": string, // 设备对应的唯一标识
            "deviceType": string, // 设备型号分类：'classic' | 'mini' | 'touch' | 'pro'
            "deviceId": string, // 钱包设备 ID，重置/擦除/恢复后可能变化，仅 webusb 传输会返回
            "path": string, // 通过 WebUSB 连接 USB 时对应的设备序列号
            "name": string, // 设备当前广播出来的蓝牙名称
        },
    ]
}

异常

{
    success: false,
    payload: {
        error: string, // 异常说明
        code: number // 状态码
    }
}