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

开发步骤

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

为了方便开发者接入，我们提供了详细的样例工程供参考，推荐参考示例工程接入。

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

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

收起
自动换行
深色代码主题
复制
// 导入码图生成需要的图片模块、错误码模块
import { scanCore, generateBarcode } from '@kit.ScanKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { image } from '@kit.ImageKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
GenerateBarcodePromise.ets

调用码图生成能力的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')
        .backgroundColor($r('sys.color.ohos_id_color_button_normal'))
        .fontColor($r('sys.color.ohos_id_color_text_primary_activated'))
        .align(Alignment.Center)
        .type(ButtonType.Capsule)
        .width('90%')
        .margin({ bottom: 12 })
        .onClick(() => {
          // 以QR码为例，码图生成参数
          const content: string = 'huawei';
          const 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((err: BusinessError) => {
              hilog.error(0x0001, '[generateBarcode]',
                `Failed to get PixelMap by promise with options. Code: ${err.code}, message: ${err.message}`);
            });
          } catch (err) {
            hilog.error(0x0001, '[generateBarcode]',
              `Failed to createBarcode by promise with options. Code: ${err.code}, message: ${err.message}`);
          }
        })
      // 获取生成码图后显示
      if (this.pixelMap) {
        Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
      }
    }
    .width('100%')
    .height('100%')
  }
}
GenerateBarcodePromise.ets

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

收起
自动换行
深色代码主题
复制
@Entry
@Component
struct Index {
  @State pixelMap: image.PixelMap | undefined = undefined;

  build() {
    Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
      Button('generateBarcode')
        .backgroundColor($r('sys.color.ohos_id_color_button_normal'))
        .fontColor($r('sys.color.ohos_id_color_text_primary_activated'))
        .align(Alignment.Center)
        .type(ButtonType.Capsule)
        .width('90%')
        .margin({ bottom: 12 })
        .onClick(() => {
          // 以QR码为例，码图生成参数
          const content: string = 'huawei';
          const options: generateBarcode.CreateOptions = {
            scanType: scanCore.ScanType.QR_CODE,
            height: 400,
            width: 400
          };
          try {
            // 码图生成接口，成功返回PixelMap格式图片
            generateBarcode.createBarcode(content, options, (err: BusinessError, pixelMap: image.PixelMap) => {
              if (err) {
                hilog.error(0x0001, '[generateBarcode]',
                  `Failed to get PixelMap by callback with options. Code: ${err.code}, message: ${err.message}`);
                return;
              }
              this.pixelMap = pixelMap;
            });
          } catch (err) {
            hilog.error(0x0001, '[generateBarcode]',
              `Failed to createBarcode by callback with options. Code: ${err.code}, message: ${err.message}`);
          }
        })
      // 获取生成码图后显示
      if (this.pixelMap) {
        Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
      }
    }
    .width('100%')
    .height('100%')
  }
}
GenerateBarcodeCallback.ets

模拟器开发

暂不支持模拟器开发，调用接口会返回错误信息“The capability is not supported on the emulator at this time.”

码图生成

通过字节数组生成码图

意见反馈

以上内容对您是否有帮助？

意见反馈

如果您有其他疑问，您也可以通过开发者社区问答频道来和我们联系探讨。

社区提问智能客服提问