logo
积分中心
鸿蒙开发——基于视觉服务实现文档扫描
头像 蓝亭书序 2026-11-18 14:44:06    发布
1 浏览 0 收藏

鸿蒙SDK为我们提供了丰富的视觉服务API,可以方便的实现各种基于摄像头的视觉能力,例如:文档扫描,AI识图等,本文针对文档扫描做介绍。

1、鸿蒙视觉服务

鸿蒙的场景化视觉服务是由Vision Kit套件提供,Vision Kit套件集成了丰富的视觉类的AI能力,文档扫描(DocumentScanner)是其中能力之一。

文档扫描控件提供拍摄文档并转换为高清扫描件的服务。仅需使用手机拍摄文档,即可自动裁剪和优化,并支持jpeg图片保存和分享;同时支持拍摄拍照或图片识别表格,生成表格文档。

效果示意如下:

图片

2、DocumentScanner

在鸿蒙SDK中,DocumentScanner用于提供文档扫描能力,集成此控件可以实现文档扫描。其接口定义如下:


declare struct DocumentScanner {
    // 文档扫描能力配置
    scannerConfig: DocumentScannerConfig;
    // 文档扫描结果回调
    onResult: DocumentScannerResultCallback;
}


  • scannerConfig

其中scannerConfig用于配置扫描组件,其定义如下:


declare class DocumentScannerConfig {
    // 文档扫描最大支持张数,默认为1,最大为50
    maxShotCount?: number;

    // 支持识别的文件类型:DocType.DOC、DocType.SHEET
    supportType: DocType[];

    // 是否支持从图库进行选图。true:支持。false:不支持。默认值:true。
    isGallerySupported?: boolean;

    // 初始滤镜效果。默认为增强,支持的枚举如下:
    // ORIGINAL:原图滤镜
    // MONOCHROME:黑白滤镜
    // STRENGTHEN:增强滤镜
    defaultFilterId?: FilterId;

    // Tab栏中展示的功能按钮。默认全部显示。
    editTabs?: EditTab[];

    // 初始拍摄模式。默认手动拍摄,支持的枚举如下:
    // AUTO,自动拍照模式
    // MANUAL,手动拍照模式
    defaultShootingMode?: ShootingMode;

    // 是否支持分享功能。true:支持。false:不支持。默认支持。
    isShareable?: boolean;

    // 保存选项。默认值:[SaveOption.JPG, SaveOption.EXCEL]。可选值有:
    // JPG,jpg图片
    // EXCEL,excel文件
    // PDF,pdf文件
    saveOptions?: SaveOption[];
}


其中FilterId有三种滤镜效果,示意分别如下:

图片

  • DocumentScannerResultCallback

DocumentScannerResultCallback用于文档扫描结果回调。类型定义如下:


type DocumentScannerResultCallback = (code: number, saveType: SaveOption, uris: string[]) => void;


其中:

code:参数表示返回状态,-1表示无结果返回;

saveType:表示返回的格式,前文中我们已经介绍过,目前格式分为JPG/EXCEL/PDF;

uris:表示扫描到的结果数据列表。

3、案 例

我们实现一个简单的调起扫描服务,并获取结果的案例,效果如下:

图片

完整示例代码如下:


import {
  DocType,
  DocumentScanner,
  DocumentScannerConfig,
  SaveOption,
  FilterId,
  ShootingMode
} from "@kit.VisionKit"
@Entry
@Component
struct DemoPage {
  @Provide('pathStack') pathStack: NavPathStack = new NavPathStack()
  @Builder
  PageMap(name: string) {
    if (name === 'docScannerPage') {
      DocScannerPage()
    }
  }
  onScanClick() {
    this.pathStack.pushPath({ name: 'docScannerPage' })
  }
  build() {
    Navigation(this.pathStack) {
      Button('启动文档扫描服务')
        .onClick(this.onScanClick.bind(this))
    }
    .title('文档扫描')
    .navDestination(this.PageMap)
    .mode(NavigationMode.Stack)
  }
}

@Component
export struct DocScannerPage {
  @State result: string = '';
  @Consume('pathStack') pathStack: NavPathStack
  private docScanConfig = new DocumentScannerConfig()
  initDocScannerConfig() {
    this.docScanConfig.supportType = [DocType.DOC, DocType.SHEET]
    this.docScanConfig.isGallerySupported = true
    this.docScanConfig.editTabs = []
    this.docScanConfig.maxShotCount = 1
    this.docScanConfig.defaultFilterId = FilterId.MONOCHROME
    this.docScanConfig.defaultShootingMode = ShootingMode.MANUAL
    this.docScanConfig.isShareable = false
  }
  aboutToAppear() {
    this.initDocScannerConfig();
  }
  scannerCallback(code: number, saveType: SaveOption, uris: string[]) {
    if (code === -1) {
      this.pathStack.pop()
    }
    this.result = uris[0]; // 由于我们配置的最大扫描数为1,因此只取第一个即可。
  }
  build() {
    NavDestination() {
      Column() {
        Text(`扫描结果如下:\n uri: ${this.result}\n图片如下:`)
        Image(this.result)
          .objectFit(ImageFit.Contain)
          .width(100)
          .height(100)
          .width('100%')
          .height('100%')
        DocumentScanner({
          scannerConfig: this.docScanConfig,
          onResult: this.scannerCallback.bind(this)
        })
          .size({ width: '100%', height: '100%' })
      }
      .width('100%')
      .height('100%')
    }
    .width('100%')
    .height('100%')
    .hideTitleBar(true)
  }
}


尾 巴

【🙋🏻‍♀️动手试试】

使用上方的Demo代码,我们试试扫描一张excel表格。

【📚扩充一下】

如果我们想要提取图片中的文字,鸿蒙SDK提供的使用textRecognition服务鸿蒙开发——提取图片中的文字




©本站发布的所有内容,包括但不限于文字、图片、音频、视频、图表、标志、标识、广告、商标、商号、域名、软件、程序等,除特别标明外,均来源于网络或用户投稿,版权归原作者或原出处所有。我们致力于保护原作者版权,若涉及版权问题,请及时联系我们进行处理。
分类
HarmonyOS

暂无评论数据

加载中...

发布

地址:北京市朝阳区北三环东路三元桥曙光西里甲1号第三置业A座1508室 电话:13391790444或(010)62178877
版权所有:电脑商情信息服务集团 北京赢邦策略咨询有限责任公司
声明:本媒体部分图片、文章来源于网络,版权归原作者所有,我司致力于保护作者版权,如有侵权,请与我司联系删除

京ICP备:2022009079号-2

京公网安备:11010502051901号

ICP证:京B2-20230255