PDF 标注接口：创建、修改与数据提取

标注看起来只是「在页面上画一笔」，实际要处理三件事：创建（支持哪些类型）、修改（颜色、透明度、线宽、外观）、数据提取（把标注的内容与属性读出来）。第三件才是产品差异化的地方。

三件事分别对应什么需求

• 创建：用户在你的应用里高亮、画框、写批注。
• 修改：样式调整与删除。
• 数据提取：把标注的属性与内容读出来——让别人写的批注也能被你处理。

为什么「提取」最关键

批注协同、审核流转、评审汇总，靠的都是提取：

• 把一份文档里的所有批注列成清单（谁在第几页说了什么）。
• 把批注同步到你的服务端，让多个审阅人共享同一份意见。
• 把批注导出成一份独立的评审记录。

只做「画上去」，标注就是死的；能提取，它才是数据。

接口规模说明了一切

ipdf_annots 是 SDK 里方法数最多的一组：创建、读取、修改、删除各类注解，并提取注解数据，共 2 个类、104 个方法——标注类型多、可调属性多，接口自然就多。见标注的接口文档。

常见问题

支持全部 PDF 标注类型吗？

公开口径是创建支持全部标注类型；具体清单以接口文档为准。

能读取别人写的批注吗？

能。读取与提取是这一层的独立能力，不是创建功能的附带品。

坐标怎么算？

标注挂在页面上，与文本定位用的是同一套页面坐标系。

怎么开始？

申请试用之后，先用「列出一份文档的所有批注」把提取这条链路跑通——它比创建更能说明这一层的能力。

来源：知叶PDF 官方文档。能力范围以 SDK 接口文档为准，更新于 2026 年 9 月。