# @anyline/anyline-js 中文文档

规范地址：https://npmcn.com/package/%40anyline/anyline-js/

版本：56\.6\.0
npm 元数据更新时间：2026-10-28T10:22:40.836Z
中文译文更新时间：2026-11-06T07:56:36.552Z
软件包许可：SEE LICENSE IN LICENSE\.md

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

原始 npm 页面：https://www.npmjs.com/package/%40anyline/anyline-js
原文对照：https://npmcn.com/package/%40anyline/anyline-js/?lang=original
项目主页：https://github.com/Anyline/anyline-ocr-anylinejs-module#readme
源码仓库：https://github.com/Anyline/anyline-ocr-anylinejs-module

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

- 包体积（解压后）：76.3 MB，25 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2021-03-19T15:19:00.880Z
- 最新版本发布：2026-10-28T10:22:40.588Z
- 近 30 天下载量：12201（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：72（近 12 个月 8 个）

## 中文简介

任意网络 SDK

## 安装

```sh
npm install @anyline/anyline-js
```

也可以使用：`pnpm add @anyline/anyline-js`、`yarn add @anyline/anyline-js`、`bun add @anyline/anyline-js`

## README

# 任意网络 SDK

[![npm version](https://img.shields.io/npm/v/@anyline/anyline-js.svg)](https://www.npmjs.com/package/@anyline/anyline-js) [![License](https://img.shields.io/badge/license-commercial-blue.svg)](https://npmcn.com/package/%40anyline/anyline-js/LICENSE.md)

[任意线](https://www.anyline.com/) Web SDK在浏览器中直接实现OCR和条码扫描.

**[现场直播](https://web-trial.anyline.com/)** | **[文档](https://documentation.anyline.com/web-sdk-component/latest/index.html)** | **[API 参考](https://documentation.anyline.com/web-sdk-component/latest/api-reference.html)**

## 支持使用实例

-   **条码** - QR码、数据矩阵、Aztec、PDF417、128码、EAN、UPC等
-   **ID 扫描** - 护照、身份证和驾驶执照
-   **轮胎和汽车** - VIN、TIN、轮胎尺寸、车牌
-   **计量** - 模拟、数字和拨号仪
-   **OCR (英语)** - 集装箱和海关

见 [文档](https://documentation.anyline.com/web-sdk-component/latest/index.html) 用于完整的支助格式和区域清单.

## 安装

```bash
npm install @anyline/anyline-js
```

或者通过CDN:

```html
<script src="https://cdn.jsdelivr.net/npm/@anyline/anyline-js/anyline.js"></script>
```

## 快速启动

**HTML : (英语)**

```html
<div id="scanner-root" style="width: 100%; height: 100vh;"></div>
```

**类型脚本/ Java 脚本 :**

```typescript
import { init } from '@anyline/anyline-js';

// Initialize the scanner
const anyline = init({
  // Your Anyline license key (obtain at anyline.com/request/contact)
  license: 'YOUR_LICENSE_KEY',
  // DOM element where the scanner will be mounted
  element: document.getElementById('scanner-root'),
  // Preset for the scan type (see documentation for all presets)
  preset: 'vin',
});

// Handle scan results
anyline.onResult = ({ result }) => {
  console.log('Scanned:', result);
};

// Start the camera and begin scanning
anyline.startScanning().catch((error) => {
  console.error('Failed to start:', error);
});

// Clean up resources when done
window.addEventListener('beforeunload', () => {
  anyline.dispose();
});
```

> **说明:** Web SDK需要HTTPS(本地主机除外)和相机权限. 浏览器会促使用户允许相机访问.

关于可用的预设和配置选项,参见 [获取启动指南](https://documentation.anyline.com/web-sdk-component/latest/getting_started.html)。 。 。 .

## 自有资产

默认情况下,SDK会从Anyline的CDN装入资产. 自我托管这些资产,以提高性能或遵守网络限制:

1.  复制 `anylinejs/` 文件夹到您的网络服务器
2.  设定 `anylinePath` 选择指向文件夹位置

```typescript
const anyline = init({
  license: 'YOUR_LICENSE_KEY',
  element: document.getElementById('scanner-root'),
  preset: 'vin',
  anylinePath: '/path/to/anylinejs',
});
```

见 [性能优化](https://documentation.anyline.com/web-sdk-component/latest/performance_notes.html) 用于CDN配置和缓存细节.

## 文档

-   [开始](https://documentation.anyline.com/web-sdk-component/latest/getting_started.html) - 安装、预设和配置
-   [实例](https://documentation.anyline.com/web-sdk-component/latest/examples.html) - 常见案例的代码示例
-   [API 参考](https://documentation.anyline.com/web-sdk-component/latest/api-reference.html) - 完成API文档
-   [配置指南](https://documentation.anyline.com/web-sdk-component/latest/configurations.html) - 插件和视图配置

## 试试吧

软件包包括一个演示应用程序. 运行它:

1.  [申请测试许可证](https://anyline.com/request/contact) 用于您的域
2.  编辑您的主机文件以将您的域路径到本地主机( 许可证为域限制)
3.  运行演示 :

```bash
npm run demo
```

4.  访问 `http://yourdomain.com:8080/demo`

用于网络上的智能手机测试(端口8443上的HTTPS):

```bash
npm run demo:network
```

打开 `https://<your-ip>:8443/` 并接受自签名的证书警告,然后选择运行演示的演示文件夹.

## 软件包内容

-   **任意线性js/** - 自营资产
-   **任意行.d.ts** - 类型脚本类型定义
-   **任何线条.js** - 主SDK图书馆
-   **利比里亚** - 第三方许可协议

## 资源

-   [现场直播](https://web-trial.anyline.com/)
-   [示例工作表](https://anyline.com/example-sheets) - 扫描试验材料
-   [申请许可证](https://anyline.com/request/contact)

## 许可证

这个SDK需要来自Anyline的商业执照. [申请审判许可证](https://anyline.com/request/contact) 要开始.

见 [利比里亚](https://npmcn.com/package/%40anyline/anyline-js/LICENSE.md) 第三方许可协议.

## 常见问题

### @anyline/anyline-js 是什么？

任意网络 SDK

### 如何安装 @anyline/anyline-js？

在项目目录运行 npm install @anyline/anyline-js，或使用 pnpm add / yarn add / bun add。

### @anyline/anyline-js 支持 TypeScript 吗？

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

### @anyline/anyline-js 支持 ESM 还是 CommonJS？

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

### @anyline/anyline-js 可以商用吗？

@anyline/anyline-js 使用 SEE LICENSE IN LICENSE\.md 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @anyline/anyline-js 的下载量有多少？

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

### @anyline/anyline-js 还在维护吗？

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