Web SDK 11 版本获取本机字体弹窗相关操作指南

福昕PDF SDK 软件开发工具包 > 福昕PDF SDK(Web)

标签:
WebSDK,本机字体

Web SDK 11 版本获取本机字体弹窗相关操作指南

福昕知识库
2026-01-21

一、问题背景

在使用 PDF SDK 11 版本时，若需获取本机字体，会触发权限弹窗提示。本文档详细说明触发弹窗的配置步骤，以及跳过弹窗直接获取字体的方法。

https://devdocs.fuxinsoft.cn/development-guide/pdf-sdk-web/kb/font/access-local-fonts

二、显示获取本机字体弹窗的配置步骤

若需正常触发 “获取本机字体” 权限弹窗，需完成以下配置：

步骤 1：设置访问协议为 HTTPS

PDF SDK 11 版本获取本机字体的能力依赖浏览器的安全策略，必须使用 HTTPS 协议访问集成 SDK 的页面，HTTP 协议下无法触发弹窗且无法获取字体权限。

本地开发环境可配置 HTTPS 证书（如使用 mkcert 生成自签名证书）；
生产环境需部署有效的 HTTPS 证书（如 Let’s Encrypt 免费证书）。

步骤 2：配置 Service-Worker-Allowed 响应头

Service Worker 是获取本机字体的必要前置条件，需按以下文档配置Service-Worker-Allowed响应头：

参考链接：https://devdocs.fuxinsoft.cn/development-guide/pdf-sdk-web/kb/integrate-service-workers.html#%E9%85%8D%E7%BD%AE-service-worker-allowed-%E5%93%8D%E5%BA%94%E5%A4%B4

步骤 3：使用指定浏览器

仅支持以下浏览器触发本机字体权限弹窗，其他浏览器暂不支持：

Google Chrome；
Microsoft Edge。

三、跳过弹窗直接获取字体的方法

若希望不弹出权限提示，直接授予字体获取权限，可在pdfui初始化完成后，立即调用以下 API：

代码示例

javascript

// 初始化pdfui（示例代码，需替换为实际初始化逻辑）
const pdfui = new PDFUI({
  // 初始化配置项
});

// 初始化完成后调用权限授予接口
pdfui.grantQueryLocalFontsPermission("granted");//不弹框，直接获取字体
//pdfui.grantQueryLocalFontsPermission("denied");//不弹框，也不获取字体

接口说明

接口名称：grantQueryLocalFontsPermission；
参数值：固定传入"granted"，表示直接授予本机字体查询权限；
调用时机：必须在pdfui初始化完成后调用。

注意事项

该方法仅在已完成上述 HTTPS 和 Service Worker 配置的前提下生效；
若浏览器首次访问时未授予过权限，部分浏览器仍可能触发一次弹窗（后续访问不再弹出）。

四、常见问题

配置完成后仍不弹框？
- 检查协议是否为 HTTPS（本地localhost除外）；
- 确认 Service-Worker-Allowed 响应头配置正确；
- 验证浏览器版本是否符合要求。
调用grantQueryLocalFontsPermission无效果？
- 检查调用时机是否在pdfui初始化完成后；
- 确认参数是否为小写的"granted"（区分大小写）。

福昕高级PDF编辑器如何实现直接将文档合并同时保留签章外观

福昕高级PDF编辑器如何实现仅文档指定区域可编辑

福昕高级PDF编辑器如何实现本地备份文档

福昕高级PDF编辑器如何将文档保存为快速网页视图

福昕高级PDF编辑器Mac版如何使用FCT配置工具集成授权

另存选项取消勾选

动作向导批量加密文档并保存

动作向导批量转换文档并保存

新功能：PDF如何打马赛克？

RDK Android 如何设置单页上下滑动翻页？

福昕高级PDF编辑器如何实现直接将文档合并同时保留签章外观

福昕高级PDF编辑器如何实现仅文档指定区域可编辑

福昕高级PDF编辑器如何实现本地备份文档

福昕高级PDF编辑器如何将文档保存为快速网页视图

福昕高级PDF编辑器Mac版如何使用FCT配置工具集成授权

另存选项取消勾选

动作向导批量加密文档并保存

动作向导批量转换文档并保存

新功能：PDF如何打马赛克？

Web SDK 11 版本获取本机字体弹窗相关操作指南