华为HarmonyOS 快速构建各种文本识别应用 -- 通用文字识别

news2025/1/9 14:32:40

适用场景

通用文字识别，是通过拍照、扫描等光学输入方式，将各种票据、卡证、表格、报刊、书籍等印刷品文字转化为图像信息，再利用文字识别技术将图像信息转化为计算机等设备可以使用的字符信息的技术。

可以对文档翻拍、街景翻拍等图片进行文字检测和识别，也可以集成于其他应用中，提供文字检测、识别的功能，并根据识别结果提供翻译、搜索等相关服务。
可以处理来自相机、图库等多种来源的图像数据，提供一个自动检测文本、识别图像中文本位置以及文本内容功能的开放能力。
支持特定角度范围内的文本倾斜、拍摄角度倾斜、复杂光照条件以及复杂文本背景等场景的文字识别。

开发步骤

在使用通用文字识别时，将实现文字识别的相关的类添加至工程。
1. import { textRecognition } from '@kit.CoreVisionKit';
简单配置页面的布局，并在Button组件添加点击事件，拉起图库，选择图片。
1. Button('选择图片')
2. .type(ButtonType.Capsule)
3. .fontColor(Color.White)
4. .alignSelf(ItemAlign.Center)
5. .width('80%')
6. .margin(10)
7. .onClick(() => {
8. // 拉起图库，获取图片资源
9. this.selectImage();
10. })
通过图库获取图片资源，将图片转换为PixelMap，并添加初始化和释放方法。
1. async aboutToAppear(): Promise<void> {
2. const initResult = await textRecognition.init();
3. hilog.info(0x0000, 'OCRDemo', `OCR service initialization result:${initResult}`);
4. }
6. async aboutToDisappear(): Promise<void> {
7. await textRecognition.release();
8. hilog.info(0x0000, 'OCRDemo', 'OCR service released successfully');
9. }
11. private async selectImage() {
12. let uri = await this.openPhoto();
13. if (uri === undefined) {
14. hilog.error(0x0000, 'OCRDemo', "Failed to get uri.");
15. return;
16. }
17. this.loadImage(uri);
18. }
20. private openPhoto(): Promise<string> {
21. return new Promise<string>((resolve) => {
22. let photoPicker: photoAccessHelper.PhotoViewPicker = new photoAccessHelper.PhotoViewPicker();
23. photoPicker.select({
24. MIMEType: photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE,
25. maxSelectNumber: 1
26. }).then((res: photoAccessHelper.PhotoSelectResult) => {
27. resolve(res.photoUris[0]);
28. }).catch((err: BusinessError) => {
29. hilog.error(0x0000, 'OCRDemo', `Failed to get photo image uri. code：${err.code}，message：${err.message}`);
30. resolve('');
31. })
32. })
33. }
35. private loadImage(name: string) {
36. setTimeout(async () => {
37. let imageSource: image.ImageSource | undefined = undefined;
38. let fileSource = await fileIo.open(name, fileIo.OpenMode.READ_ONLY);
39. imageSource = image.createImageSource(fileSource.fd);
40. this.chooseImage = await imageSource.createPixelMap();
41. }, 100)
42. }
实例化VisionInfo对象，并传入待检测图片的PixelMap。
VisionInfo为待OCR检测识别的入参项，目前仅支持PixelMap类型的视觉信息。
1. let visionInfo: textRecognition.VisionInfo = {
2. pixelMap: this.chooseImage
3. };
配置通用文本识别的配置项TextRecognitionConfiguration，用于配置是否支持朝向检测。
1. let textConfiguration: textRecognition.TextRecognitionConfiguration = {
2. isDirectionDetectionSupported: false
3. };
调用textRecognition的recognizeText接口，对识别到的结果进行处理。

当调用成功时，获取文字识别的结果；调用失败时，将返回对应错误码。
recognizeText接口提供了三种调用形式，当前以其中一种作为示例，其他方式可参考API文档。
1. textRecognition.recognizeText(visionInfo, textConfiguration)
2. .then((data: textRecognition.TextRecognitionResult) => {
3. // 识别成功，获取对应的结果
4. let recognitionString = JSON.stringify(data);
5. hilog.info(0x0000, 'OCRDemo', `Succeeded in recognizing text：${recognitionString}`);
6. // 将结果更新到Text中显示
7. this.dataValues = data.value;
8. })
9. .catch((error: BusinessError) => {
10. hilog.error(0x0000, 'OCRDemo', `Failed to recognize text. Code: ${error.code}, message: ${error.message}`);
11. this.dataValues = `Error: ${error.message}`;
12. });

开发实例

点击按钮，识别一张图片的文字内容，并通过日志打印。

import { textRecognition } from '@kit.CoreVisionKit'
import { image } from '@kit.ImageKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { fileIo } from '@kit.CoreFileKit';
import { photoAccessHelper } from '@kit.MediaLibraryKit';
@Entry
@Component
struct Index {
private imageSource: image.ImageSource | undefined = undefined;
@State chooseImage: PixelMap | undefined = undefined;
@State dataValues: string = '';
async aboutToAppear(): Promise<void> {
const initResult = await textRecognition.init();
hilog.info(0x0000, 'OCRDemo', `OCR service initialization result:${initResult}`);
}
async aboutToDisappear(): Promise<void> {
await textRecognition.release();
hilog.info(0x0000, 'OCRDemo', 'OCR service released successfully');
}
build() {
Column() {
Image(this.chooseImage)
.objectFit(ImageFit.Fill)
.height('60%')
Text(this.dataValues)
.copyOption(CopyOptions.LocalDevice)
.height('15%')
.margin(10)
.width('60%')
Button('选择图片')
.type(ButtonType.Capsule)
.fontColor(Color.White)
.alignSelf(ItemAlign.Center)
.width('80%')
.margin(10)
.onClick(() => {
// 拉起图库，获取图片资源
this.selectImage();
})
Button('开始识别')
.type(ButtonType.Capsule)
.fontColor(Color.White)
.alignSelf(ItemAlign.Center)
.width('80%')
.margin(10)
.onClick(async () => {
this.textRecognitionTest();
})
}
.width('100%')
.height('100%')
.justifyContent(FlexAlign.Center)
}
private textRecognitionTest() {
if (!this.chooseImage) {
return;
}
// 调用文本识别接口
let visionInfo: textRecognition.VisionInfo = {
pixelMap: this.chooseImage
};
let textConfiguration: textRecognition.TextRecognitionConfiguration = {
isDirectionDetectionSupported: false
};
textRecognition.recognizeText(visionInfo, textConfiguration)
.then((data: textRecognition.TextRecognitionResult) => {
// 识别成功，获取对应的结果
let recognitionString = JSON.stringify(data);
hilog.info(0x0000, 'OCRDemo', `Succeeded in recognizing text：${recognitionString}`);
// 将结果更新到Text中显示
this.dataValues = data.value;
})
.catch((error: BusinessError) => {
hilog.error(0x0000, 'OCRDemo', `Failed to recognize text. Code: ${error.code}, message: ${error.message}`);
this.dataValues = `Error: ${error.message}`;
});
}
private async selectImage() {
let uri = await this.openPhoto();
if (uri === undefined) {
hilog.error(0x0000, 'OCRDemo', "Failed to get uri.");
return;
}
this.loadImage(uri);
}
private openPhoto(): Promise<string> {
return new Promise<string>((resolve) => {
let photoPicker: photoAccessHelper.PhotoViewPicker = new photoAccessHelper.PhotoViewPicker();
photoPicker.select({
MIMEType: photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE,
maxSelectNumber: 1
}).then((res: photoAccessHelper.PhotoSelectResult) => {
resolve(res.photoUris[0]);
}).catch((err: BusinessError) => {
hilog.error(0x0000, 'OCRDemo', `Failed to get photo image uri. Code：${err.code}，message：${err.message}`);
resolve('');
})
})
}
private loadImage(name: string) {
setTimeout(async () => {
let fileSource = await fileIo.open(name, fileIo.OpenMode.READ_ONLY);
this.imageSource = image.createImageSource(fileSource.fd);
this.chooseImage = await this.imageSource.createPixelMap();
}, 100)
}
}