鸿蒙实现默认界面的扫码

HarmonyOS提供了scanBarcode模块实现扫码功能，支持二维码/条形码识别。开发者只需配置ScanOptions参数（如识别类型、多图模式等），调用startScanForResult方法即可打开扫码界面并获取结果。示例代码展示了如何创建扫码按钮，通过Promise处理扫码结果或错误，支持识别内容自动跳转链接。该功能可快速集成到应用中，实现高效便捷的扫码体验。

ShuiShenHuoLe

460人浏览 · 2025-12-04 23:01:33

ShuiShenHuoLe · 2025-12-04 23:01:33 发布

scanBarcode (默认界面扫码)

扫描二维码/条形码是许多应用中的常见功能。在 HarmonyOS 中，可以通过 scanBarcode 模块提供的 API 来实现。

步骤

编写 options 配置参数
scanBarcode.startScanForResult(context,options)打开扫码界面

开启默认界面扫码可以省略 options 参数，直接调用 startScanForResult 方法即可。

// 扫码的配置项
const options: scanBarcode.ScanOptions = {
  scanTypes: [scanCore.ScanType.ALL], //识别的类型 一般识别所有类型
  enableMultiMode: true, //是否支持多图识别
  enableAlbum: false, //是否支持图库
};

// 调用startScanForResult方法开始扫码
scanBarcode
  .startScanForResult(this.context, options)
  .then((result: scanBarcode.ScanResult) => {
    hilog.info(0x0001, "[scan simple]", "success");
    const context: common.UIAbilityContext =
      this.getUIContext().getHostContext() as common.UIAbilityContext;

    // result.originalValue为二维码的内容
    context.openLink(result.originalValue);
  })
  .catch((error: BusinessError) => {
    hilog.error(0x0001, "[scan simple]", `err errcode${error.code}`);
  });

真实案例

import { scanBarcode, scanCore } from '@kit.ScanKit'
import { common } from '@kit.AbilityKit'
import hilog from '@ohos.hilog'

@Entry
@Component
struct Index {
  build() {
    Column() {
      Button("scan code")
        .onClick((event: ClickEvent) => {
          const option:scanBarcode.ScanOptions = {
            scanTypes:[scanCore.ScanType.ALL],
            enableMultiMode:true,
            enableAlbum:true
          }
          const context:common.UIAbilityContext = this.getUIContext().getHostContext() as common.UIAbilityContext
          scanBarcode.startScanForResult(context,option)
            .then((result:scanBarcode.ScanResult)=>{
              context.openLink(result.originalValue)
            })
            .catch((error:BusinessError)=>{
              hilog.error(0x0000,'[scan code err]',`errorcode:${error.code} errorMessage:${error.message}`)
            })
        })
    }
  }
}