鸿蒙（API 12 Beta5版）【通过文本生成码图】

基本概念

码图生成能力支持将字符串转换为自界说格式的码图。
场景介绍

码图生成能力支持将字符串转换为自界说格式的码图，包罗条形码、二维码生成。
可以将字符串转成接洽人码图，手机克隆码图，例如将"HUAWEI"字符串生成码图使用。
约束与限制

支持十三种码图生成，每种码图对生成参数有差别的要求，码图限制可见下表
生成码范例参数发起内容QR Code支持中文，不超过512字符长度，假如内容过长会导致码复杂，影响辨认。Aztec支持中文，不超过512字符长度，假如内容过长会导致码复杂，影响辨认。PDF417支持中文，不超过512字符长度，假如内容过长会导致码复杂，影响辨认。Data Matrix不超过512字符长度，假如内容过长会导致码复杂，影响辨认。UPC-A支持11位数字输入，只支持数字，生成包罗12位数字的码图，包罗最后一位校验数字。UPC-E支持7位数字输入，只支持数字，首位必要是0或1，生成包罗8位数字的码图，包罗最后一位校验数字。ITF-14支持80位以内数字输入，并且必要是偶数位，只支持数字，生成包罗偶数位数字的码图，假如内容过长会导致码复杂，影响辨认。EAN-8支持7位数字输入，只支持数字，生成包罗8位数字的码图，包罗最后一位校验数字。EAN-13支持12位数字输入，只支持数字，首位不可以是0，生成包罗13位数字的码图，包罗最后一位校验数字Code 39不超过80字节长度，字符集可以是数字、大小写字母和- . $ / + % * SPACE英文格式符号（请注意：一个小写字母占用2个字节）。Code 93不超过80字节长度，字符集可以是数字、大小写字母和- . $ / + % * SPACE英文格式符号（请注意：一个小写字母占用2个字节）。Code 128不超过80字节长度，字符集可以是数字、大小写字母和- . $ / + % * SPACE英文格式符号（请注意：一个小写字母占用1个字节）。Codabar不超过512字符长度，起始/终止符可以是ABCD中的任一个（特殊环境下，TN*E也会编码成ABCD，推荐使用ABCD）。其他字符可以是数字和- . $ / : +英文格式符号。 说明
生成码参数发起：

• 码图颜色和背景
  发起使用默认颜色和背景：黑色码图、白色背景。假如码图颜色和背景对比度较小会影响辨认率。
  
• 码图边距
  发起使用默认边距1，单元：px，取值范围：[1, 10]。
  
• 码图大小
  
  
  
  • 生成QR Code、Data Matrix、Aztec范例的码图时，输入的width和height值雷同且均大于即是200小于即是4096，否则生成的码图过小会影响辨认。
    
  • 生成EAN-8、EAN-13、UPC-A、UPC-E、Codabar、Code 39、Code 93、Code 128、ITF-14、PDF417范例的码图时，发起输入的width和height值比例为2:1，并且width值需大于400，否则生成的码图会过小影响辨认。
    
  
  

业务流程

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

接口说明

接口返回值有两种返回形式：Callback和Promise回调。下表中为码图生成能力的Callback和Promise形式接口，Callback和Promise只是返回值方式不一样，功能雷同。
接口名接口形貌[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接口实现码图生成。

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

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

复制代码

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

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

1. @Entry
2. @Component
3. struct Index {
4.   @State pixelMap: image.PixelMap | undefined = undefined
6.   build() {
7.     Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
8.       Button('generateBarcode Promise').onClick(() => {
9.         // 以QR码为例，码图生成参数
10.         this.pixelMap = undefined;
11.         let content: string = 'huawei';
12.         let options: generateBarcode.CreateOptions = {
13.           scanType: scanCore.ScanType.QR_CODE,
14.           height: 400,
15.           width: 400
16.         }
17.         // 码图生成接口，成功返回PixelMap格式图片
18.         generateBarcode.createBarcode(content, options).then((pixelMap: image.PixelMap) => {
19.           this.pixelMap = pixelMap;
20.         }).catch((error: BusinessError) => {
21.           hilog.error(0x0001, '[generateBarcode]', `Failed to get PixelMap by promise with options. Code: ${error.code}, message: ${error.message}`);
22.         })
23.       })
24.       // 获取生成码后显示
25.       if (this.pixelMap) {
26.         Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
27.       }
28.     }
29.     .width('100%')
30.     .height('100%')
31.   }
32. }

复制代码

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

1. @Entry
2. @Component
3. struct Index {
4.   @State pixelMap: image.PixelMap | undefined = undefined
6.   build() {
7.     Flex({ direction: FlexDirection.Column, alignItems: ItemAlign.Center, justifyContent: FlexAlign.Center }) {
8.       Button('generateBarcode Callback').onClick(() => {
9.         // 以QR码为例，码图生成参数
10.         let content = 'huawei';
11.         let options: generateBarcode.CreateOptions = {
12.           scanType: scanCore.ScanType.QR_CODE,
13.           height: 400,
14.           width: 400
15.         }
16.         // 码图生成接口，成功返回PixelMap格式图片
17.         generateBarcode.createBarcode(content, options, (error: BusinessError, pixelMap: image.PixelMap) => {
18.           if (error) {
19.             hilog.error(0x0001, '[generateBarcode]', `Failed to get PixelMap by callback with options. Code: ${error.code}, message: ${error.message}`);
20.             return;
21.           }
22.           this.pixelMap = pixelMap;
23.         })
24.       })
25.       // 获取生成码后显示
26.       if (this.pixelMap) {
27.         Image(this.pixelMap).width(300).height(300).objectFit(ImageFit.Contain)
28.       }
29.     }
30.     .width('100%')
31.     .height('100%')
32.   }
33. }

复制代码

最后呢

很多开辟朋侪不知道必要学习那些鸿蒙技能？鸿蒙开辟岗位必要掌握那些核心技能点？为此鸿蒙的开辟学习必须要系统性的举行。
而网上有关鸿蒙的开辟资料非常的少，假如你想学好鸿蒙的应用开辟与系统底层开辟。你可以参考这份资料，少走很多弯路，节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开辟文档》内里内容包罗了（ArkTS、ArkUI开辟组件、Stage模子、多端部署、分布式应用开辟、音频、视频、WebGL、OpenHarmony多媒体技能、Napi组件、OpenHarmony内核、Harmony南向开辟、鸿蒙项目实战等等）鸿蒙（Harmony NEXT）技能知识点
假如你是一名Android、Java、前端等等开辟职员，想要转入鸿蒙方向发展。可以直接领取这份资料辅助你的学习。下面是鸿蒙开辟的学习路线图。

针对鸿蒙发展路线打造的鸿蒙学习文档。话不多说，我们直接看详细鸿蒙（OpenHarmony ）手册（共计1236页）与鸿蒙（OpenHarmony ）开辟入门视频，帮助大家在技能的门路上更进一步。

• 《鸿蒙 (OpenHarmony)开辟学习视频》
  
• 《鸿蒙生态应用开辟V2.0白皮书》
  
• 《鸿蒙 (OpenHarmony)开辟基础到实战手册》
  
• OpenHarmony北向、南向开辟环境搭建
  
• 《鸿蒙开辟基础》
  
• 《鸿蒙开辟进阶》
  
• 《鸿蒙开辟实战》
  

总结

鸿蒙—作为国家主力推送的国产操纵系统。部分的高校已经取消了安卓课程，从而开设鸿蒙课程；企业纷纷跟进启动了鸿蒙研发。
并且鸿蒙是完全具备无与伦比的机会和潜力的；预计到年底将有 5,000 款的应用完成原生鸿蒙开辟，未来将会支持 50 万款的应用。那么这么多的应用必要开辟，也就意味着必要有更多的鸿蒙人才。鸿蒙开辟工程师也将会迎来爆发式的增长，学习鸿蒙势在必行！ 自↓↓↓拿

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。