鸿蒙（API 12 Beta3版）【通过字节数组生成码图】

news2024/9/25 21:27:59

基本概念

码图生成能力支持将字节数组转换为自定义格式的码图。

场景介绍

码图生成能力支持将字节数组转换为自定义格式的码图。

例如：调用码图生成能力, 将字节数组转换成交通一卡通二维码使用。

约束与限制

只支持QR Code生成，根据纠错水平不同对生成参数有不同的要求，参数限制可见下表

纠错水平	参数内容限制
LEVEL_L	字节数组长度限制建议不超过2048。
LEVEL_M	字节数组长度限制建议不超过2048。
LEVEL_Q	字节数组长度限制建议不超过1536。
LEVEL_H	字节数组长度限制建议不超过1024。

说明

生成码参数建议：

码图颜色和背景

建议使用默认颜色和背景：黑色码图、白色背景。如果码图颜色和背景对比度较小会影响识别率。
码图边距

建议使用默认边距1，单位：px，取值范围：[1, 10]。
码图大小

输入的width和height值相同且均大于等于200小于等于4096，否则生成的码图过小会影响识别。

业务流程

用户向应用发起生成码请求后，传入需要生成的码的信息，包括码的类型、宽高等。
应用通过调用Scan Kit的createBarcode接口启动码图生成能力。
Scan Kit通过将字节数组转换为码图并返回给应用。
应用向用户返回生成码结果。

接口说明

通过字节数组生成码图，以Promise形式生成码图。

接口名	接口描述
[createBarcode](content: ArrayBuffer, options: [CreateOptions]): Promise<image.[PixelMap]>	码图生成接口，返回image.PixelMap类型的参数，可以使用Image组件渲染成图片。使用Promise异步回调返回生成的码图。

开发步骤

码图生成根据传参内容直接生成所需码图，需要传入固定参数和可选参数。

以下示例为调用码图生成能力的createBarcode接口实现码图生成。

导入码图生成接口模块，该模块提供了码图生成的参数和方法，导入方法如下。

// 导入码图生成需要的图片模块、错误码模块
import { scanCore, generateBarcode } from '@kit.ScanKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { buffer } from '@kit.ArkTS';

调用码图生成能力的createBarcode接口实现码图生成。

通过Promise方式回调，获取生成的码图。

const TAG: string = 'Create barcode';

@Entry
@Component
struct Index {
  @State pixelMap: image.PixelMap | undefined = undefined
  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Button('generateBarcode Promise').onClick(() => {
        this.pixelMap = undefined;
        let content: string =
'0177C10DD10F7768600202312110000063458FD14112345678FFFFD381012610b746365409210201b66636540ad0200020000000000110e617003201000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000006645fbec664358ECF657CB40693c92da';
        let contentBuffer: ArrayBuffer = buffer.from(content, 'hex').buffer; // 通过包含十六进制字符的字符串创建Buffer
        let options: generateBarcode.CreateOptions = {
          scanType: scanCore.ScanType.QR_CODE,
          height: 400,
          width: 400
        }
        // 码图生成接口，成功返回PixelMap格式图片
        generateBarcode.createBarcode(contentBuffer, options).then((pixelMap: image.PixelMap) => {
          this.pixelMap = pixelMap;
          hilog.info(0x0001, TAG, 'Succeeded in creating barCode.');
        }).catch((error: BusinessError) => {
          hilog.error(0x0001, TAG, `Failed to createBarCode. Code: ${error.code}, message: ${error.message}`);
        })
      })
      // 获取生成码后显示
      if (this.pixelMap) {
        Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
      }
    }
    .width('100%')
    .height('100%')
  }
}

最后呢

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

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

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

在这里插入图片描述