本文主要是介绍鸿蒙(API 12 Beta3版)【识别图像数据】,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
基本概念
图像数据识码能力支持对相机预览流数据中的码图进行扫描识别,并获取信息。
场景介绍
图像数据识码能力支持对相机预览流数据中的条形码、二维码、MULTIFUNCTIONAL CODE进行识别,并获得码类型、码值、码位置信息和相机变焦比。该能力可用于一图单码和一图多码的识别,比如条形码、付款码等。
业务流程
- 用户向应用发起识码请求。
- 应用通过调用[Camera Kit]启动相机,获取预览流数据。
- 应用通过调用Scan Kit的decodeImage接口识别码图。
- Scan Kit通过回调返回识别结果。
- 应用向用户返回扫码结果。
接口说明
识别图像数据中的码图,以Promise形式返回识别结果。
接口名 | 描述 |
---|---|
[decodeImage](image: [ByteImage], options?: scanBarcode.[ScanOptions]): Promise<[DetectResult]> | 启动图像识码,通过ByteImage传入图像数据信息,使用Promise异步回调返回识码结果。 |
开发步骤
图像数据识码能力支持对相机预览流数据中的条形码、二维码、MULTIFUNCTIONAL CODE进行识别,并返回码图的值、类型、码的位置信息(码图最小外接矩形左上角和右下角的坐标,QR码支持返回四个点坐标)和相机变焦比。
以下示例为调用detectBarcode.decodeImage接口获取码图信息。
- 导入图像识码接口和相关接口模块,该模块提供了图像识码参数和方法,导入方法如下。
import { detectBarcode, scanBarcode, scanCore } from '@kit.ScanKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { camera } from '@kit.CameraKit';
import { image } from '@kit.ImageKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
-
使用Camera Kit启动相机能力,实现双路预览功能
-
通过ImageReceiver实时获取预览图像数据,调用detectBarcode.decodeImage接口解析图像数据。请在识别完成后再释放图像数据。
// 从ImageReceiver获取imgComponent: image.Component,预览流设置的宽高: width, height
function decodeImageBuffer(imgComponent: image.Component, width: number, height: number) {let byteImg: detectBarcode.ByteImage = {byteBuffer: imgComponent.byteBuffer,// 相机预览流数据旋转90°width: height,height: width,format: detectBarcode.ImageFormat.NV21};let options: scanBarcode.ScanOptions = {scanTypes: [scanCore.ScanType.ALL],enableMultiMode: true,enableAlbum: false};detectBarcode.decodeImage(byteImg, options).then((result: detectBarcode.DetectResult) => {hilog.info(0x0001, '[Scan Sample]', `Succeeded in getting DetectResult by promise with options, result is ${JSON.stringify(result)}`);}).catch((error: BusinessError) => {hilog.error(0x0001, '[Scan Sample]', `Failed to get DetectResult by promise with options. Code: ${error.code}, message: ${error.message}`);})
}
- detectBarcode.[DetectResult]中返回的cornerPoints可参考以下说明使用。
-
因为屏幕自然方向和摄像头传感器方向不同,所以cornerPoints四个点的坐标需按屏幕自然方向对应的坐标系转换。四个点的对应转换逻辑如下(假设创建的相机预览流宽高为1080 * 1920)。
-
右下角(x, y):(1080 - cornerPoints[0].y, cornerPoints[0].x)
-
左下角(x, y):(1080 - cornerPoints[1].y, cornerPoints[1].x)
-
左上角(x, y):(1080 - cornerPoints[2].y, cornerPoints[2].x)
-
右上角(x, y):(1080 - cornerPoints[3].y, cornerPoints[3].x)
-
当创建的相机预览流宽高和实际预览组件XComponent的宽高不一致时,cornerPoints四个点的坐标需按缩放比例转换。例如相机预览流宽高为1080 * 1920,Xcomponent的宽高为width * height,则坐标缩放比例ratio为:width / 1080, 最终转换后的坐标为(x * ratio, y * ratio)。
模拟器开发
暂不支持模拟器使用,调用会返回错误信息“Emulator is not supported.”
最后呢
很多开发朋友不知道需要学习那些鸿蒙技术?鸿蒙开发岗位需要掌握那些核心技术点?为此鸿蒙的开发学习必须要系统性的进行。
而网上有关鸿蒙的开发资料非常的少,假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料,少走很多弯路,节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(Harmony NEXT)技术知识点
如果你是一名Android、Java、前端等等开发人员,想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。
针对鸿蒙成长路线打造的鸿蒙学习文档。话不多说,我们直接看详细鸿蒙(OpenHarmony )手册(共计1236页)与鸿蒙(OpenHarmony )开发入门视频,帮助大家在技术的道路上更进一步。
- 《鸿蒙 (OpenHarmony)开发学习视频》
- 《鸿蒙生态应用开发V2.0白皮书》
- 《鸿蒙 (OpenHarmony)开发基础到实战手册》
- OpenHarmony北向、南向开发环境搭建
- 《鸿蒙开发基础》
- 《鸿蒙开发进阶》
- 《鸿蒙开发实战》
总结
鸿蒙—作为国家主力推送的国产操作系统。部分的高校已经取消了安卓课程,从而开设鸿蒙课程;企业纷纷跟进启动了鸿蒙研发。
并且鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,未来将会支持 50 万款的应用。那么这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行! 自↓↓↓拿
这篇关于鸿蒙(API 12 Beta3版)【识别图像数据】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!