OnlineDocumentViewer 使用 Doconut SDK 在浏览器中渲染文档
OnlineDocumentViewer 在任何网页中直接显示 PDF、Word 文件、CAD 图纸以及数十种其他格式。它通过将繁重的渲染工作委托给 Doconut SDK 来实现——这是一款服务器端渲染引擎,可将原始文件转换为像素级完美的图像流,然后通过轻量级 JavaScript 包装器将这些图像流式传输到浏览器。
Doconut SDK:每个预览背后的渲染核心
Doconut SDK 能够识别超过 50 种原生文件类型——PDF、DOCX、XLSX、PPTX、DWG、PSD、SVG 等等。当请求到达时,Doconut 解析源文档,解析字体和图层,并生成与原始布局像素对应的光栅化表示。由于转换在服务器上完成,客户端无需 Microsoft Office、AutoCAD 或任何其他桌面应用。
从令牌到像素:端到端请求流程
- 生成令牌签名的 URL – 您的后端调用 OnlineDocumentViewer REST API,传递文件标识符和可选标志,例如
disableDownload: true。API 返回一个短期 URL,其中嵌入加密令牌。 - 服务器调用 Doconut – OnlineDocumentViewer 服务将请求转发给 Doconut SDK,后者在沙箱环境中执行文件转换。
- 像素流返回 – Doconut 将渲染的页面以图像瓦片形式流式传输。SDK 将瓦片拼接成可滚动的画布,保留缩放级别和滚动位置。
- 查看器显示画布 – 前端呈现出无缝、无插件的预览,行为类似原生 PDF 查看器。
该流程同样适用于 .NET 后端、Node.js 服务或任何能够发起 HTTP 请求的平台,满足“跨平台”需求。
像素级完美保真:高保真渲染对您的 UI 意味着什么
高保真渲染确保每个字形、矢量形状和图层都完全按照源作者的意图呈现。对于包含嵌入 OpenType 字体的 PDF,Doconut 提取字体数据并在请求的缩放级别上光栅化每个字形,从而不会出现回退字体。对于 CAD 图纸(DWG),线宽、填充图案和图层可见性都被忠实再现且不失真。最终的预览与在原生桌面应用中打开文件的效果完全一致,消除了开发者常因视觉差异而转向截图的情况。
内置安全、隐私与 GDPR 合规
- 基于令牌的访问控制 – 每个预览 URL 都包含服务器在调用 Doconut 前会验证的签名令牌。如果令牌缺失或已过期,请求将被拒绝。
- 自动文件删除 – 渲染管道完成后,原始文件会从临时存储中删除,服务器上不保留持久副本。
- 端到端加密 – 您的前端、OnlineDocumentViewer 服务以及 Doconut 之间的所有通信均通过 TLS 加密。
- 域名限制 – 您可以将允许加载查看器的域名列入白名单,以防止点击劫持攻击。
这些防护措施使您能够在必须符合严格数据保护法规的 SaaS 产品中嵌入文档预览。
即使在大规模下也能实现亚秒级加载时间
由于 Doconut 在强大的云实例上执行转换,大多数文档的渲染时间均低于一秒,无论客户端是 Windows、macOS、Linux、iOS 还是 Android。查看器仅流式传输当前可见的瓦片,从而即使在移动网络上带宽使用也保持低水平。该架构为云原生:多个渲染服务实例在全局负载均衡器后自动扩展,全球范围内提供一致的延迟。
接下来可以尝试的操作
- 在 在线文档查看器 (https://onlinedocumentviewer.com) 注册并上传示例 PDF。
了解更多关于渲染引擎的信息,请访问 Doconut 网站:https://doconut.com。
获取更多集成指南,请访问 https://doconut.app。
