# @digitalpersona/fingerprint 中文文档

规范地址：https://npmcn.com/package/%40digitalpersona/fingerprint/

版本：1\.0\.0
npm 元数据更新时间：2026-08-31T18:04:38.474Z
中文译文更新时间：2026-11-12T09:08:05.217Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40digitalpersona/fingerprint
原文对照：https://npmcn.com/package/%40digitalpersona/fingerprint/?lang=original
项目主页：https://github.com/hidglobal/digitalpersona-fingerprint#readme
源码仓库：https://github.com/hidglobal/digitalpersona-fingerprint

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：79.4 kB，9 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@digitalpersona/websdk ^1\.0\.1
- 首次发布：2025-05-04T04:18:01.171Z
- 最新版本发布：2025-05-04T04:18:01.451Z
- 近 30 天下载量：13570（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 0 个）

## 中文简介

HID DigitalPersona 指纹 API 库

## 安装

```sh
npm install @digitalpersona/fingerprint
```

也可以使用：`pnpm add @digitalpersona/fingerprint`、`yarn add @digitalpersona/fingerprint`、`bun add @digitalpersona/fingerprint`

## README

# HID 数字个人指纹 API

JavaScript 库允许在网页浏览器中使用指纹阅读器 并使用数字Persona获取指纹记录或认证数据 本地设备访问 API.

> \[大 API的设计只用于浏览器环境! 这不是NodeJS图书馆!

## 所需资源

指纹 API 需要安装一个跟随 HID DigitalPersona 客户端 在用户的机器上:

-   [HID 数字个人工作站/ Kiosk](https://www.hidglobal.com/product-mix/digitalpersona) --HID DigitalPersona Premium套件的一部分,提供多要素认证,生物鉴别,与Active Directory等集成.
-   [HID 认证设备客户端](https://digitalpersona.hidglobal.com/lite-client/) (前作"Lite Client")——免费的Windows客户端,提供 与指纹读取器,卡片等设备进行交流.

## 目标平台和技术

支持的平台 :

-   窗口 10 及以后
-   Windows 服务器 2008 R2 及以后

支持的浏览器 :

-   Chrome和基于Chrome的浏览器(Edge等)
-   火花
-   边缘遗产(WebView2)

模块格式( 只浏览器, 无节点JS !) :

-   国际家庭教育研究所(ES5): `dist/fingerprint.sdk[.min].js`
-   打字 (TypeScript):'dist/指印. sdk.d.ts

## 文档

[用法信息和API描述](https://npmcn.com/package/%40digitalpersona/fingerprint/docs/usage/index.adoc)

[代码样本](https://npmcn.com/package/%40digitalpersona/fingerprint/samples)

[供捐助者/维护者参考的资料](https://npmcn.com/package/%40digitalpersona/fingerprint/docs/maintain/index.adoc)

## 许可证

图书馆的许可证根据 [麻省理工学院](https://npmcn.com/package/%40digitalpersona/fingerprint/LICENSE) 执照.

版权 (c) 2025 HID Global Inc.

## 常见问题

### @digitalpersona/fingerprint 是什么？

HID DigitalPersona 指纹 API 库

### 如何安装 @digitalpersona/fingerprint？

在项目目录运行 npm install @digitalpersona/fingerprint，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@digitalpersona/websdk（^1\.0\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @digitalpersona/fingerprint 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @digitalpersona/fingerprint 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @digitalpersona/fingerprint 可以商用吗？

@digitalpersona/fingerprint 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @digitalpersona/fingerprint 的下载量有多少？

根据 npm 官方下载统计，@digitalpersona/fingerprint 在 2026/10/12 – 2026/11/10 这 30 天内被下载 13,570 次，日均约 452 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @digitalpersona/fingerprint 还在维护吗？

最新版本 1\.0\.0 发布于 2025/05/04（1\.5 年前）；至今共发布 1 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/05/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。