# @cloudpdf/viewer 中文文档

规范地址：https://npmcn.com/package/%40cloudpdf/viewer/

版本：3\.1\.0
npm 元数据更新时间：2026-11-08T19:23:33.393Z
中文译文更新时间：2026-11-10T04:35:35.457Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40cloudpdf/viewer
原文对照：https://npmcn.com/package/%40cloudpdf/viewer/?lang=original
项目主页：https://www.cloudpdf.com/
源码仓库：https://github.com/embedpdf/embed-pdf-viewer

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

- 包体积（解压后）：38.4 MB，168 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2022-08-15T19:20:15.073Z
- 最新版本发布：2026-11-08T19:23:32.931Z
- 近 30 天下载量：2245（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 26 个）

## 中文简介

以 CloudPDF 引擎为默认值的开源 EmbedPDF 查看器: , init () 和每个框架包装器的名称,在 CloudPDF SaaS 或您自己的@cloudpdf/ server 上提供的页面,本地引擎仅在需要邮票时才加载. 点/点

## 安装

```sh
npm install @cloudpdf/viewer
```

也可以使用：`pnpm add @cloudpdf/viewer`、`yarn add @cloudpdf/viewer`、`bun add @cloudpdf/viewer`

## README

# @ cloudpdf/ 查看器

以 CloudPDF 引擎作为默认的全 EmbedPDF 查看器: 相同 `<embedpdf-viewer>` 元素和 `init()` 作为 [`@embedpdf/viewer`](https://www.npmjs.com/package/@embedpdf/viewer),其 文档在 CloudPDF (SaaS, 或您自己的 [`@cloudpdf/server`](https://www.npmjs.com/package/@cloudpdf/server)) (中文(简体) ). 开幕 而读取的文档仅为HTTPS API流量. 唯一的例外是邮票: 邮票库是 PDF 在浏览器中切入邮票,所以第一次 有人打开印花或签名 查看器加载本地引擎 (单位:千美元)`embedpdf.wasm`,在同一个文件夹中运出). 过 `plugins: { stamp: { assetEngine } }` 提供你自己的.

## 使用量

```html
<embedpdf-viewer id="viewer" style="height: 100vh"></embedpdf-viewer>

<script type="module">
  import 'https://cdn.jsdelivr.net/npm/@cloudpdf/viewer@3/dist/cloudpdf.js';

  document.getElementById('viewer').src = { grant: 'grt_…' };
</script>
```

云文档不是URL,所以它是从脚本中给出的,而不是作为属性. 或者从脚本创建取景器:

```js
import CloudPDF from 'https://cdn.jsdelivr.net/npm/@cloudpdf/viewer@3/dist/cloudpdf.js';

CloudPDF.init({ target: '#viewer', src: { token: '<document token>' } });
```

`src` 文档是: `{ token }` 带有文档符号的后端创建 用于用户(一个字符串,或一个给新字符串的函数), `{ id }` 当 引擎本身 `token` 已经允许了,或者 `{ grant }` 有补助金 从仪表板。 又一个 `src` 打开它的位置。 关于若干文件,见 一次,通过 `documents`: 条目 `{ src, name, password, active }`。 。 。 .

取景器连接了 CloudPDF SaaS (`https://engine.cloudpdf.com`) (中文(简体) ). 属于你的 [`@cloudpdf/server`](https://www.npmjs.com/package/@cloudpdf/server) 进入 引擎设置 : `engine: { baseUrl: 'https://pdf.example.com' }`,与 引擎本身 `token` 财务报告和审定财务报表 `fetch` 旁边.

开源查看器的每个定制选项(布局、命令、, 图标、主题、语言)沿着逐字记录;参见 [嵌入式PDF 文件](https://www.embedpdf.com/docs) 用于词汇.

从 npm 而不是 CDN :

```bash
npm install @cloudpdf/viewer
```

```ts
import CloudPDF from '@cloudpdf/viewer';
```

## 许可证

阿帕奇-2.0 — 见 [自由主义](https://npmcn.com/package/%40cloudpdf/viewer/LICENSE)。 。 。 .

CloudPDF给浏览器的船都是开源的;所有运行在 服务器是商用的。 这个文物是浏览器侧面,所以是Apache-2.0——作为 是取景器铬和引擎接口 它的基于,从 [嵌入式PDF](https://www.embedpdf.com/) 开源项目. 发作发生在一个 CloudPDF的部署(SaaS, 或自主办 [`@cloudpdf/server`](https://www.npmjs.com/package/@cloudpdf/server) a 项下 ,即商业部分.

## 常见问题

### @cloudpdf/viewer 是什么？

以 CloudPDF 引擎为默认值的开源 EmbedPDF 查看器: , init \(\) 和每个框架包装器的名称,在 CloudPDF SaaS 或您自己的@cloudpdf/ server 上提供的页面,本地引擎仅在需要邮票时才加载\. 点/点

### 如何安装 @cloudpdf/viewer？

在项目目录运行 npm install @cloudpdf/viewer，或使用 pnpm add / yarn add / bun add。

### @cloudpdf/viewer 支持 TypeScript 吗？

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

### @cloudpdf/viewer 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @cloudpdf/viewer 可以商用吗？

@cloudpdf/viewer 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @cloudpdf/viewer 的下载量有多少？

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

### @cloudpdf/viewer 还在维护吗？

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