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

##鸿蒙开发能力 ##HarmonyOS SDK应用服务##鸿蒙金融类应用 (金融理财# 一、前言

图(1-1) HarmonyOS 系统提供的核心场景化视觉服务,旨在帮助开发者快速实现移动端文档数字化功能。 其核心能力包括:扫描合同、票据、会议记录并保存为 PDF 分享。拍摄课堂 PPT、书籍章节生成图片存档。快速识别表格数据,减少手动录入成本。 在HarmonyOS 5.0 及以上系统的手机 / 平板(不支持模拟器)。 二、鸿蒙中的文档扫描都具备什么功能?

图(1-2) ** 文档扫描控件(DocumentScanner)** 是 AI Vision Kit。文档扫描控件提供拍摄文档并转换为高清扫描件的服务。

  1. 使用手机拍摄文档,即可自动裁剪和优化,并支持jpeg图片、PDF格式保存和分享。如图(1-1)所示。

  2. 支持拍摄拍照或图片识别表格,生成表格文档。如图(1-2)所示。 三、鸿蒙中的文档扫描怎么用?

  3. 导入依赖模块: import { DocType, DocumentScanner, DocumentScannerConfig, SaveOption, FilterId, ShootingMode, EditTab, DocumentScannerResultCallback } from "@kit.VisionKit";

  4. 配置扫描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 = true this.docScanConfig.editTabs = [] this.docScanConfig.maxShotCount = 3 this.docScanConfig.defaultFilterId = FilterId.ORIGINAL this.docScanConfig.defaultShootingMode = ShootingMode.MANUAL this.docScanConfig.isShareable = true this.docScanConfig.originalUris = [] }

  5. 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, saveType: SaveOption, uris: string[]) => { hilog.info(0x0001, TAG, result code: ${code}, save: ${saveType}) if (code === -1) { this.pathStack?.pop() } uris.forEach(uriString => { hilog.info(0x0001, TAG, uri: ${uriString}) }) this.docImageUris = uris } }) .size({ width: '100%', height: '100%' }) 源码示例分享

// MainPage.ets - 扫描入口页面

import { NavPathStack } from '@ohos.router'; import { DocDemoPage } from './DocDemoPage'; // 引入扫描实现页

@Entry @Component struct MainPage { // 导航栈管理页面跳转 private pathStack: NavPathStack = new NavPathStack()

build() { Navigation(this.pathStack) { Column({ space: 20 }) { // 标题 Text('文档扫描Demo').fontSize(24).fontWeight(500);

    // 扫描入口按钮
    Button('开始扫描文档', { type: ButtonType.Capsule, stateEffect: true })
      .width('60%')
      .height(50)
      .onClick(() => {
        // 跳转到扫描页面
        this.pathStack.pushPath({ name: 'documentScanner' });
      });
  }
  .justifyContent(FlexAlign.Center)
  .width('100%')
  .height('100%');
}
.navDestination(this.PageMap)
.mode(NavigationMode.Stack)
.title('文档扫描示例');

} } // DocDemoPage.ets - 扫描功能实现与结果展示

import { DocType, DocumentScanner, DocumentScannerConfig, SaveOption, FilterId, ShootingMode, EditTab } from "@kit.VisionKit"; import { hilog, LogLevel } from '@ohos.hilog'; // 日志工具

const TAG = 'DocScannerDemo'; // 日志标签

@Entry @Component export struct DocDemoPage { @State scanResults: string[] = []; // 保存扫描结果URI private pathStack: NavPathStack | null = null;

// 扫描配置初始化 private docScanConfig = new DocumentScannerConfig();

// 页面加载时配置扫描参数 aboutToAppear() { this.docScanConfig.supportType = [DocType.DOC, DocType.SHEET]; // 支持文档和表格识别 this.docScanConfig.maxShotCount = 3; // 最多拍摄3张 this.docScanConfig.isGallerySupported = true; // 允许从图库选图 this.docScanConfig.defaultFilterId = FilterId.STRENGTHEN; // 默认增强滤镜 this.docScanConfig.defaultShootingMode = ShootingMode.MANUAL; // 手动拍摄模式 this.docScanConfig.editTabs = [EditTab.ROTATE_TAB, EditTab.RESHOOT_TAB]; // 显示旋转和重拍按钮 this.docScanConfig.saveOptions = [SaveOption.JPG, SaveOption.PDF, SaveOption.EXCEL]; // 支持三种保存格式 this.docScanConfig.isShareable = true; // 开启分享功能 }

build() { NavDestination({ name: 'documentScanner' }) { Stack() { // 扫描结果展示区域 Column() { if (this.scanResults.length > 0) { Text('扫描结果').fontSize(18).fontWeight(500).margin({ top: 20 }); Grid() { ForEach(this.scanResults, (uri, index) => { // 展示缩略图,点击可预览(示例中简化为日志输出) Image(uri) .objectFit(ImageFit.Contain) .width(150) .height(150) .margin(10) .onClick(() => hilog.info(LogLevel.INFO, TAG, 预览图片:${uri})); }) .columnsTemplate('1fr 1fr') // 两行布局 .rowGap(10) .columnGap(10); } } .width('100%') .padding(20);

    // 文档扫描控件主体
    DocumentScanner({
      scannerConfig: this.docScanConfig,
      onResult: (code: number, saveType: SaveOption, uris: string[]) => {
        hilog.info(LogLevel.INFO, TAG, `扫描结果:code=${code}, 格式=${SaveOption[saveType]}`);
        switch (code) {
          case 200: // 成功
            this.scanResults = uris; // 更新结果列表
            hilog.info(LogLevel.INFO, TAG, `保存路径:${uris.join(', ')}`);
            break;
          case -1: // 用户取消
            this.pathStack.pop(); // 返回上一页
            break;
          case 1008601001: // URI无效(5.0.5+支持)
            hilog.error(LogLevel.ERROR, TAG, '传入的图片规格不符合要求');
            break;
        }
      }
    })
    .size({ width: '100%', height: '100%' })
    .margin({ top: 80 }); // 留出结果展示区域空间
  }
  .width('100%')
  .height('100%')
  .hideTitleBar(true); // 隐藏导航栏
  .onReady((context: NavDestinationContext)=>{
          this.pathStack = context?.pathStack;
    })

} } 注意 originalUris图片 ● 单边长度:224px ≤ 长/宽 ≤ 8000px。
● 宽高乘积:≤ 6000×8000 px²。
● 宽高比:≤ 3(即最长边/最短边 ≤ 3)。

评论

暂无评论