当前位置：首页 > news >正文

鸿蒙（API 12 Beta3版）【识别本地图片】

news 2025/7/5 21:18:48

基本概念

图片识码能力支持对图库中的码图进行扫描识别，并获取信息。

场景介绍

图片识码能力支持对图库中的条形码、二维码、MULTIFUNCTIONAL CODE进行识别，并获得码类型、码值、码位置信息。该能力可用于一图单码和一图多码的识别，比如条形码、付款码等。

业务流程

用户向开发者的应用发起图片识码请求。
应用通过调用Scan Kit的decode接口启动图片识码。
Scan Kit通过回调返回图片识码结果。
应用向用户返回扫码结果。

接口说明

接口返回值有两种返回形式：Callback和Promise回调。下表中为启动图片识码Callback和Promise形式接口，Callback和Promise只是返回值方式不一样，功能相同。

接口名	描述
[decode](inputImage: [InputImage], options?: scanBarcode.[ScanOptions]): Promise<Array<scanBarcode.[ScanResult]>>	启动图片识码，通过InputImage传入图片信息，通过ScanOptions进行识码参数设置（options为可选参数），使用Promise异步回调返回识码结果。
[decode](inputImage: InputImage, options: scanBarcode.ScanOptions, callback: AsyncCallback<Array<scanBarcode.ScanResult>>): void	启动图片识码，通过InputImage传入图片信息，通过ScanOptions进行识码参数设置，使用Callback异步回调返回识码结果。
[decode](inputImage: InputImage, callback: AsyncCallback<Array<scanBarcode.ScanResult>>): void	启动图片识码，通过InputImage传入图片信息，使用Callback异步回调返回识码结果。

开发步骤

图片识码接口支持识别图库中的条形码，二维码以及MULTIFUNCTIONAL CODE，并返回图片中码图的值，类型以及码的位置信息（码图最小外接矩形左上角和右下角的坐标）。

以下示例为调用图片识码的detectBarcode.decode接口获取码图信息。

导入图片识码接口和相关接口模块，该接口提供了图片识码参数和方法，导入方法如下。

// 导入图片识码需要的日志和picker模块
import { scanCore, scanBarcode, detectBarcode } from '@kit.ScanKit';
import { photoAccessHelper } from '@kit.MediaLibraryKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { BusinessError } from '@kit.BasicServicesKit';

调用detectBarcode.decode接口解析码图。

通过Promise回调函数得到扫码结果，InputImage对象中uri参数推荐通过[picker]方式获取。

@Entry
@Component
struct DetectPage {build() {Column() {Button('Promise with options').backgroundColor('#0D9FFB').fontSize(20).fontColor('#FFFFFF').fontWeight(FontWeight.Normal).align(Alignment.Center).type(ButtonType.Capsule).width('90%').height(40).margin({ top: 5, bottom: 5 }).onClick(() => {// 定义识码参数optionslet options: scanBarcode.ScanOptions = {scanTypes: [scanCore.ScanType.ALL],enableMultiMode: true,}// 通过picker拉起图库的图片let photoOption = new photoAccessHelper.PhotoSelectOptions();photoOption.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE;photoOption.maxSelectNumber = 1;let photoPicker = new photoAccessHelper.PhotoViewPicker();photoPicker.select(photoOption).then((result) => {// 定义识码参数inputImage，其中uri为picker选择图片let inputImage: detectBarcode.InputImage = { uri: result.photoUris[0] }// 调用图片识码接口detectBarcode.decode(inputImage, options).then((result: Array<scanBarcode.ScanResult>) => {hilog.info(0x0001, '[Scan Sample]', `Succeeded in getting ScanResult by promise with options, result is ${JSON.stringify(result)}`);}).catch((error: BusinessError) => {hilog.error(0x0001, '[Scan Sample]', `Failed to get ScanResult by promise with options. Code: ${error.code}, message: ${error.message}`);});})});}.width('100%').height('100%').alignItems(HorizontalAlign.Center).justifyContent(FlexAlign.Center)}
}

通过Callback回调函数得到扫码结果，InputImage对象中uri参数推荐通过[picker]方式获取。

@Entry
@Component
struct DetectPage {build() {Column() {Button('Callback with options').backgroundColor('#0D9FFB').fontSize(20).fontColor('#FFFFFF').fontWeight(FontWeight.Normal).align(Alignment.Center).type(ButtonType.Capsule).width('90%').height(40).margin({ top: 5, bottom: 5 }).onClick(() => {// 定义识码参数optionslet options: scanBarcode.ScanOptions = {scanTypes: [scanCore.ScanType.ALL],enableMultiMode: true,enableAlbum: true}// 通过选择模式拉起photoPicker界面，用户可以选择一个图片let photoOption = new photoAccessHelper.PhotoSelectOptions();photoOption.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE;photoOption.maxSelectNumber = 1;let photoPicker = new photoAccessHelper.PhotoViewPicker();photoPicker.select(photoOption).then((result) => {// 定义识码参数inputImage，其中uri为picker选择图片let inputImage: detectBarcode.InputImage = { uri: result.photoUris[0] }// 调用图片识码接口detectBarcode.decode(inputImage, options, (error: BusinessError, result: Array<scanBarcode.ScanResult>) => {if (error && error.code) {hilog.error(0x0001, '[Scan Sample]', `Failed to get ScanResult by callback with options. Code: ${error.code}, message: ${error.message}`);return;}hilog.info(0x0001, '[Scan Sample]', `Succeeded in getting ScanResult by callback with options, result is ${JSON.stringify(result)}`);});})});}.width('100%').height('100%').alignItems(HorizontalAlign.Center).justifyContent(FlexAlign.Center)}
}

最后呢

很多开发朋友不知道需要学习那些鸿蒙技术？鸿蒙开发岗位需要掌握那些核心技术点？为此鸿蒙的开发学习必须要系统性的进行。

而网上有关鸿蒙的开发资料非常的少，假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技术知识点

如果你是一名Android、Java、前端等等开发人员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开发的学习路线图。

在这里插入图片描述