# Visionkit-SampleCode-SheetExtractionDemo-ArkTS

**Repository Path**: harmonyos_samples/visionkit-samplecode-sheet-extraction-demo-arkts

## Basic Information

- **Project Name**: Visionkit-SampleCode-SheetExtractionDemo-ArkTS
- **Description**: 本示例通过提供拍摄表格并转换为表格文档的服务。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 2
- **Created**: 2025-04-24
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实现表格提取功能

## 介绍

本示例展示了使用视觉类AI能力中的表格提取能力。

本示例模拟了在应用里，跳转表格提取功能，获取到表格提取结果并展示出来。

需要使用文档扫描控件@hms.ai.DocumentScanner.d.ets。



## 效果预览

| 预览                           | 拍照                           | 表格提取                   |
|------------------------------|------------------------------|------------------------|
| ![](screenshots/preview.png) | ![](screenshots/capture.png) | ![](screenshots/sheetExtraction.png) |



使用说明：

1. 在手机的主屏幕，点击”SheetDemo“，启动应用。
2. 点击“SheetExtraction”按钮，跳转到文档扫描控件。
3. 将镜头对准一张表格，跳出”表格提取“气泡（必须保证是表格，否则无法出现入口）。
4. 点击”表格提取“气泡，进入表格提取拍摄页面。
5. 点击拍摄识别表格。



## 工程目录

```
├─entry/src/main/ets                         // 代码区  
│  ├─entryability
│  │  └─EntryAbility.ets                     // 入口Ability
│  └─pages
│     └─Index.ets                            // 应用主界面
│     └─SheetExtractionPage.ets              // 文档扫描主界面
└─entry/src/main/resources                  // 应用资源目录
```



## 具体实现

本示例展示的功能由@hms.ai.DocumentScanner.d.ets中定义的文档扫描控件提供：
```ts
/**
 * This is a ui component used for generating document scans.
 * @struct { DocumentScanner }
 * @syscap SystemCapability.AI.Component.DocScan
 * @atomicservice
 * @since 5.0.0(12)
 */
@Component
declare struct DocumentScanner {
    /**
     * config for document scanner.
     *
     * @type { DocumentScannerConfig }
     * @syscap SystemCapability.AI.Component.DocScan
     * @atomicservice
     * @since 5.0.0(12)
     */
    scannerConfig: DocumentScannerConfig;
    /**
     * @type { DocumentScannerResultCallback }
     * callback of the listened event, called when the Component is terminated.
     * @syscap SystemCapability.AI.Component.DocScan
     * @atomicservice
     * @since 5.0.0(12)
     */
    onResult: DocumentScannerResultCallback;
    /**
     * Constructor used to create a <b>DocumentScanner</b> object.
     * @syscap SystemCapability.AI.Component.DocScan
     * @atomicservice
     * @since 5.0.0(12)
     */
    build(): void;
}
```

业务使用时，需要先进行import导入DocumentScanner。
调用验证结果接口，接收处理返回的结果。



## 相关权限

不涉及。



## 依赖

不涉及。



## 约束与限制

1. 本实例仅支持标准系统上运行，支持设备：华为手机、华为平板。
2. HarmonyOS系统：HarmonyOS 5.0.0 Release及以上。
3. DevEco Studio版本：DevEco Studio 6.0.0 Release及以上。
4. HarmonyOS SDK版本：HarmonyOS 6.0.0 Release SDK及以上。