【HarmonyOS 5】鸿蒙应用实现发票扫描、文档扫描输出PDF图片或者表格的功能

【HarmonyOS 5】鸿蒙应用实现发票扫描、文档扫描输出PDF图片或者表格的功能

一、前言

图（1-1）

HarmonyOS 系统提供的核心场景化视觉服务，旨在帮助开发者快速实现移动端文档数字化功能。

其核心能力包括：扫描合同、票据、会议记录并保存为 PDF 分享。拍摄课堂 PPT、书籍章节生成图片存档。快速识别表格数据，减少手动录入成本。

在HarmonyOS 5.0 及以上系统的手机 / 平板（不支持模拟器）。

二、鸿蒙中的文档扫描都具备什么功能？

图（1-2）

** 文档扫描控件（DocumentScanner）** 是 AI Vision Kit。文档扫描控件提供拍摄文档并转换为高清扫描件的服务。

1. 使用手机拍摄文档，即可自动裁剪和优化，并支持jpeg图片、PDF格式保存和分享。如图（1-1）所示。
2. 支持拍摄拍照或图片识别表格，生成表格文档。如图（1-2）所示。

三、鸿蒙中的文档扫描怎么用？

1. 导入依赖模块：

import { DocType, DocumentScanner, DocumentScannerConfig, SaveOption, FilterId, ShootingMode, EditTab, DocumentScannerResultCallback } from "@kit.VisionKit";

2. 配置扫描config对象：
定义扫描参数（如拍摄模式、识别类型、滤镜等）。

名称	类型	可选	说明
maxShotCount	number	是	最大拍摄张数，范围[1,50]，默认1。
supportType	DocType[]	否	支持的识别类型（文档/表格），默认[DocType.DOC]，部分机型仅支持文档。
isGallerySupported	boolean	是	是否支持从图库选图，默认true。
defaultFilterId	FilterId	是	初始滤镜（原图/黑白/增强），默认增强（STRENGTHEN）。
editTabs	EditTab[]	是	Tab栏功能按钮（旋转/删除/重拍），默认全部显示。
defaultShootingMode	ShootingMode	是	拍摄模式（自动/手动），默认手动（MANUAL）。
isShareable	boolean	是	是否支持分享，默认true。
saveOptions	SaveOption[]	是	保存格式（JPG/PDF/EXCEL），默认[JPG, EXCEL]。
originalUris	string[]	是	初始图片URI列表（用于直接跳转编辑页），最大长度50，需符合尺寸规格。

  private docScanConfig = new DocumentScannerConfig()setDocScanConfig() {this.docScanConfig.supportType = [DocType.DOC, DocType.SHEET]this.docScanConfig.isGallerySupported = truethis.docScanConfig.editTabs = []this.docScanConfig.maxShotCount = 3this.docScanConfig.defaultFilterId = FilterId.ORIGINALthis.docScanConfig.defaultShootingMode = ShootingMode.MANUALthis.docScanConfig.isShareable = truethis.docScanConfig.originalUris = []}

3. UI布局中添加DocumentScanner
将第二步配置创建好的scannerConfig对象进行赋值。
并且处理onResult回调，当扫描处理成功后会返回Uris。

参数名	类型	说明
code	number	状态码： -1=取消/ 200=成功/ 1008601001=URI无效（5.0.5+）
saveType	SaveOption	保存格式（JPG/PDF/EXCEL）
uris	string[]	生成的文件URI列表（扫描结果或表格文档）

        //文档扫描DocumentScanner({scannerConfig: this.docScanConfig,onResult: (code: number, sav