鸿蒙NEXT开发实战往期必看文章：

一分钟了解”纯血版！鸿蒙HarmonyOS Next应用开发！

“非常详细的” 鸿蒙HarmonyOS Next应用开发学习路线！（从零基础入门到精通）

HarmonyOS NEXT应用开发案例实践总结合（持续更新......）

HarmonyOS NEXT应用开发性能优化实践总结（持续更新......）

基本概念

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

场景介绍

码图生成能力支持将字符串转换为自定义格式的码图，包含条形码、二维码生成。

可以将字符串转成联系人码图，手机克隆码图，例如将"HUAWEI"字符串生成码图使用。

约束与限制

支持十三种码图生成，每种码图对生成参数有不同的要求，码图限制可见下表，具体接口参数限制信息请参见CreateOptions。

说明

生成码参数建议：

• 码图颜色和背景

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

• 码图边距

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

• 码图大小
  1. 生成QR Code、Data Matrix、Aztec类型的码图时，输入的width和height值相同且均大于等于200小于等于4096，否则生成的码图过小会影响识别。
  2. 生成EAN-8、EAN-13、UPC-A、UPC-E、Codabar、Code 39、Code 93、Code 128、ITF-14、PDF417类型的码图时，建议输入的width和height值比例为2:1，并且width值需大于400，否则生成的码图会过小影响识别。

业务流程

1. 用户向应用发起生成码请求后，输入需要生成的码的信息，包括码的类型、宽高等。
2. 应用通过调用Scan Kit的createBarcode接口启动码图生成能力。
3. Scan Kit通过将字符串转换为所需格式的码图并返回给应用。
4. 应用向用户返回生成码结果。

接口说明

接口返回值有两种返回形式：Callback和Promise回调。下表中为码图生成能力的Callback和Promise形式接口，Callback和Promise只是返回值方式不一样，功能相同。具体API说明详见接口文档。

开发步骤

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

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

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

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

2. 调用码图生成能力的createBarcode接口实现码图生成。
   • 通过Promise方式回调，获取生成的码图。

     @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(() => {
             // 以QR码为例，码图生成参数
             this.pixelMap = undefined;
             let content: string = 'huawei';
             let options: generateBarcode.CreateOptions = {
               scanType: scanCore.ScanType.QR_CODE,
               height: 400,
               width: 400
             }
             try {
               // 码图生成接口，成功返回PixelMap格式图片
               generateBarcode.createBarcode(content, options).then((pixelMap: image.PixelMap) => {
                 this.pixelMap = pixelMap;
               }).catch((error: BusinessError) => {
                 hilog.error(0x0001, '[generateBarcode]',
                   `Failed to get PixelMap by promise with options. Code: ${error.code}, message: ${error.message}`);
               })
             } catch (error) {
               hilog.error(0x0001, '[generateBarcode]',
                 `Failed to createBarcode by promise with options. Code: ${error.code}, message: ${error.message}`);
             }
     
           })
           // 获取生成码后显示
           if (this.pixelMap) {
             Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
           }
         }
         .width('100%')
         .height('100%')
       }
     }

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

     @Entry
     @Component
     struct Index {
       @State pixelMap: image.PixelMap | undefined = undefined
     
       build() {
         Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
           Button('generateBarcode Callback').onClick(() => {
             // 以QR码为例，码图生成参数
             let content = 'huawei';
             let options: generateBarcode.CreateOptions = {
               scanType: scanCore.ScanType.QR_CODE,
               height: 400,
               width: 400
             }
             try {
               // 码图生成接口，成功返回PixelMap格式图片
               generateBarcode.createBarcode(content, options, (error: BusinessError, pixelMap: image.PixelMap) => {
                 if (error) {
                   hilog.error(0x0001, '[generateBarcode]',
                     `Failed to get PixelMap by callback with options. Code: ${error.code}, message: ${error.message}`);
                   return;
                 }
                 this.pixelMap = pixelMap;
               })
             } catch (error) {
               hilog.error(0x0001, '[generateBarcode]',
                 `Failed to createBarcode by callback with options. Code: ${error.code}, message: ${error.message}`);
             }
           })
           // 获取生成码后显示
           if (this.pixelMap) {
             Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
           }
         }
         .width('100%')
         .height('100%')
       }
     }

模拟器开发

暂不支持模拟器使用，调用会返回错误信息“Emulator is not supported.”