鸿蒙NEXT开发案例：二维码的生成与辨认

【弁言】
在本篇文章中，我们将探讨如何在鸿蒙NEXT平台上实现二维码的生成与辨认功能。通过使用ArkUI组件库和相关的媒体库，我们将创建一个简单的应用步伐，用户可以生成二维码并扫描辨认。
【环境准备】
• 操纵体系：Windows 10
• 开发工具：DevEco Studio NEXT Beta1 Build Version: 5.0.3.806
• 目标设备：华为Mate60 Pro
• 开发语言：ArkTS
• 框架：ArkUI
• API版本：API 12
• 权限：ohos.permission.WRITE_IMAGEVIDEO（为实现将图片保存至相册功能）
【项目介绍】
1. 项目结构

我们首先界说一个名为QrCodeGeneratorAndScanner的组件，使用@Component装饰器进行标记。该组件包含多个状态变量和方法，用于处置惩罚二维码的生成、辨认和剪贴板操纵。
2. 组件状态

组件的状态包括：

• buttonOptions: 界说分段按钮的选项，用于切换生成和辨认二维码的功能。
  
• inputText: 用户输入的文本，用于生成二维码。
  
• scanResult: 扫描结果文本。
  
• scanResultObject: 存储扫描结果的对象。
  

3. 用户界面构建

在build方法中，我们使用Column和Row布局来构建用户界面。重要包含以下部分：

• 分段按钮：用户可以选择生成二维码或辨认二维码。
  
• 输入地区：用户可以输入文本并生成二维码。
  
• 二维码显示：根据输入文本生成二维码。
  
• 扫描地区：用户可以通过相机扫描二维码或从图库选择图片进行辨认。
  

4. 二维码生成

二维码生成使用QRCode组件，输入文本通过this.inputText传递。用户输入后，二维码会实时更新。
5. 二维码辨认

二维码辨认功能通过scanBarcode模块实现。用户可以点击“扫一扫”按钮，启动相机进行扫描，或选择图库中的图片进行辨认。辨认结果将显示在界面上，并提供复制功能。
6. 剪贴板操纵

用户可以将扫描结果复制到剪贴板，使用pasteboard模块实现。点击“复制”按钮后，扫描结果将被复制，用户会收到提示。
【完整代码】
填写权限使用声明字符串：src/main/resources/base/element/string.json

1. {
2.   "string": [
3.     {
4.       "name": "module_desc",
5.       "value": "module description"
6.     },
7.     {
8.       "name": "EntryAbility_desc",
9.       "value": "description"
10.     },
11.     {
12.       "name": "EntryAbility_label",
13.       "value": "label"
14.     },
15.     {
16.       "name": "WRITE_IMAGEVIDEO_info",
17.       "value": "保存功能需要该权限"
18.     }
19.   ]
20. }

复制代码

设置权限：src/main/module.json5

1. {
2.   "module": {
3.     "requestPermissions": [
4.       {
5.         "name": 'ohos.permission.WRITE_IMAGEVIDEO',
6.         "reason": "$string:WRITE_IMAGEVIDEO_info",
7.         "usedScene": {
9.         }
10.       }
11.     ],
12. //... ...

复制代码

示例代码：src/main/ets/pages/Index.ets

1. import {
2.   componentSnapshot, // 组件快照
3.   promptAction, // 提示操作
4.   SegmentButton, // 分段按钮
5.   SegmentButtonItemTuple, // 分段按钮项元组
6.   SegmentButtonOptions // 分段按钮选项
7. } from '@kit.ArkUI'; // 引入 ArkUI 组件库
9. import { photoAccessHelper } from '@kit.MediaLibraryKit'; // 引入 MediaLibraryKit 中的照片访问助手
10. import { common } from '@kit.AbilityKit'; // 引入 AbilityKit 中的通用功能
11. import { fileIo as fs } from '@kit.CoreFileKit'; // 引入 CoreFileKit 中的文件 I/O 模块
12. import { image } from '@kit.ImageKit'; // 引入 ImageKit 中的图像处理模块
13. import { BusinessError, pasteboard } from '@kit.BasicServicesKit'; // 引入 BasicServicesKit 中的业务错误和剪贴板操作
14. import { hilog } from '@kit.PerformanceAnalysisKit'; // 引入 PerformanceAnalysisKit 中的性能分析模块
15. import { detectBarcode, scanBarcode } from '@kit.ScanKit'; // 引入 ScanKit 中的条形码识别模块
17. @Entry
18.   // 入口标记
19. @Component
20.   // 组件标记
21. struct QrCodeGeneratorAndScanner { // 定义二维码生成与识别组件
22.   @State private buttonOptions: SegmentButtonOptions = SegmentButtonOptions.capsule({
23.     // 定义分段按钮选项
24.     buttons: [{ text: '生成二维码' }, { text: '识别二维码' }] as SegmentButtonItemTuple, // 按钮文本
25.     multiply: false, // 不允许多选
26.     fontColor: Color.White, // 字体颜色为白色
27.     selectedFontColor: Color.White, // 选中字体颜色为白色
28.     selectedBackgroundColor: Color.Orange, // 选中背景颜色为橙色
29.     backgroundColor: "#d5d5d5", // 背景颜色
30.     backgroundBlurStyle: BlurStyle.BACKGROUND_THICK // 背景模糊样式
31.   })
32.   @State private sampleText: string = 'hello world'; // 示例文本
33.   @State private inputText: string = ""; // 输入文本
34.   @State private scanResult: string = ""; // 扫描结果
35.   @State @Watch('selectIndexChanged') selectIndex: number = 0 // 选择索引
36.   @State @Watch('selectedIndexesChanged') selectedIndexes: number[] = [0]; // 选中索引数组
37.   private qrCodeId: string = "qrCodeId" // 二维码 ID
38.   @State private scanResultObject: scanBarcode.ScanResult = ({} as scanBarcode.ScanResult) // 扫描结果对象
39.   @State private textColor: string = "#2e2e2e"; // 文本颜色
40.   @State private shadowColor: string = "#d5d5d5"; // 阴影颜色
41.   @State private basePadding: number = 30; // 基础内边距
43.   selectedIndexesChanged() { // 选中索引改变事件
44.     console.info(`this.selectedIndexes[0]:${this.selectedIndexes[0]}`)
45.     this.selectIndex = this.selectedIndexes[0]
46.   }
48.   selectIndexChanged() { // 选择索引改变事件
49.     console.info(`selectIndex:${this.selectIndex}`)
50.     this.selectedIndexes[0] = this.selectIndex
51.   }
53.   private copyToClipboard(text: string): void { // 复制文本到剪贴板
54.     const pasteboardData = pasteboard.createData(pasteboard.MIMETYPE_TEXT_PLAIN, text); // 创建剪贴板数据
55.     const systemPasteboard = pasteboard.getSystemPasteboard(); // 获取系统剪贴板
56.     systemPasteboard.setData(pasteboardData); // 设置数据
57.     promptAction.showToast({ message: '已复制' }); // 弹出提示消息
58.   }
60.   build() { // 构建界面
61.     Column() { // 列布局
62.       SegmentButton({ // 分段按钮
63.         options: this.buttonOptions, // 选项
64.         selectedIndexes: this.selectedIndexes // 选中索引
65.       }).width('400lpx').margin({ top: 20 }) // 设置宽度和外边距
66.       Tabs({ index: this.selectIndex }) { // 选项卡
67.         TabContent() { // 选项卡内容
68.           Scroll() { // 滚动视图
69.             Column() { // 列布局
70.               Column() { // 列布局
71.                 Row() { // 行布局
72.                   Text('示例') // 文本
73.                     .fontColor("#5871ce") // 字体颜色
74.                     .fontSize(16) // 字体大小
75.                     .padding(`${this.basePadding / 2}lpx`) // 内边距
76.                     .backgroundColor("#f2f1fd") // 背景颜色
77.                     .borderRadius(5) // 边框圆角
78.                     .clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 点击效果
79.                     .onClick(() => { // 点击事件
80.                       this.inputText = this.sampleText; // 设置输入文本为示例文本
81.                     });
82.                   Blank(); // 空白占位
83.                   Text('清空') // 清空按钮
84.                     .fontColor("#e48742") // 字体颜色
85.                     .fontSize(16) // 字体大小
86.                     .padding(`${this.basePadding / 2}lpx`) // 内边距
87.                     .clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 点击效果
88.                     .backgroundColor("#ffefe6") // 背景颜色
89.                     .borderRadius(5) // 边框圆角
90.                     .onClick(() => { // 点击事件
91.                       this.inputText = ""; // 清空输入文本
92.                     });
93.                 }
94.                 .height(45) // 设置高度
95.                 .justifyContent(FlexAlign.SpaceBetween) // 主轴对齐方式
96.                 .width('100%'); // 设置宽度
98.                 Divider(); // 分隔线
99.                 TextArea({ text: $$this.inputText, placeholder: `请输入内容` }) // 文本输入框
100.                   .width(`${650 - this.basePadding * 2}lpx`) // 设置宽度
101.                   .height(100) // 设置高度
102.                   .fontSize(16) // 字体大小
103.                   .caretColor(this.textColor) // 光标颜色
104.                   .fontColor(this.textColor) // 字体颜色
105.                   .margin({ top: `${this.basePadding}lpx` }) // 外边距
106.                   .padding(0) // 内边距
107.                   .backgroundColor(Color.Transparent) // 背景颜色
108.                   .borderRadius(0) // 边框圆角
109.                   .textAlign(TextAlign.JUSTIFY); // 文本对齐方式
110.               }
111.               .alignItems(HorizontalAlign.Start) // 交叉轴对齐方式
112.               .width('650lpx') // 设置宽度
113.               .padding(`${this.basePadding}lpx`) // 内边距
114.               .borderRadius(10) // 边框圆角
115.               .backgroundColor(Color.White) // 背景颜色
116.               .shadow({ // 阴影
117.                 radius: 10, // 阴影半径
118.                 color: this.shadowColor, // 阴影颜色
119.                 offsetX: 0, // X 轴偏移
120.                 offsetY: 0 // Y 轴偏移
121.               });
123.               Row() { // 行布局
124.                 QRCode(this.inputText) // 二维码组件
125.                   .width('300lpx') // 设置宽度
126.                   .aspectRatio(1) // 设置宽高比
127.                   .id(this.qrCodeId) // 设置 ID
128.                 SaveButton() // 保存按钮
129.                   .onClick(async (_event: ClickEvent, result: SaveButtonOnClickResult) => { // 点击事件
130.                     if (result === SaveButtonOnClickResult.SUCCESS) { // 如果保存成功
131.                       const context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext; // 获取上下文
132.                       let helper = photoAccessHelper.getPhotoAccessHelper(context); // 获取照片访问助手
133.                       try { // 尝试
134.                         let uri = await helper.createAsset(photoAccessHelper.PhotoType.IMAGE, 'jpg'); // 创建图片资源
135.                         let file = await fs.open(uri, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE); // 打开文件
136.                         componentSnapshot.get(this.qrCodeId).then((pixelMap) => { // 获取二维码快照
137.                           let packOpts: image.PackingOption = { format: 'image/png', quality: 100 } // 打包选项
138.                           const imagePacker: image.ImagePacker = image.createImagePacker(); // 创建图像打包器
139.                           return imagePacker.packToFile(pixelMap, file.fd, packOpts).finally(() => { // 打包并保存文件
140.                             imagePacker.release(); // 释放打包器
141.                             fs.close(file.fd); // 关闭文件
142.                             promptAction.showToast({ // 弹出提示消息
143.                               message: '图片已保存至相册', // 提示内容
144.                               duration: 2000 // 持续时间
145.                             });
146.                           });
147.                         })
148.                       } catch (error) { // 捕获错误
149.                         const err: BusinessError = error as BusinessError; // 转换为业务错误
150.                         console.error(`Failed to save photo. Code is ${err.code}, message is ${err.message}`); // 打印错误信息
151.                       }
153.                     } else { // 如果保存失败
154.                       promptAction.showToast({ // 弹出提示消息
155.                         message: '设置权限失败！', // 提示内容
156.                         duration: 2000 // 持续时间
157.                       });
158.                     }
159.                   })
160.               }
161.               .visibility(this.inputText ? Visibility.Visible : Visibility.Hidden) // 根据输入文本设置可见性
162.               .justifyContent(FlexAlign.SpaceBetween) // 主轴对齐方式
163.               .width('650lpx') // 设置宽度
164.               .padding(`${this.basePadding}lpx`) // 内边距
165.               .margin({ top: `${this.basePadding}lpx` }) // 外边距
166.               .borderRadius(10) // 边框圆角
167.               .backgroundColor(Color.White) // 背景颜色
168.               .shadow({ // 阴影
169.                 radius: 10, // 阴影半径
170.                 color: this.shadowColor, // 阴影颜色
171.                 offsetX: 0, // X 轴偏移
172.                 offsetY: 0 // Y 轴偏移
173.               });
174.             }.padding({ top: 20, bottom: 20 }) // 设置内边距
175.             .width('100%') // 设置宽度
176.           }.scrollBar(BarState.Off) // 禁用滚动条
177.           .align(Alignment.Top) // 顶部对齐
178.           .height('100%') // 设置高度
179.         }
180.         TabContent() { // 第二个选项卡内容
181.           Scroll() { // 滚动视图
182.             Column() { // 列布局
183.               Row() { // 行布局
184.                 Text('扫一扫') // 扫一扫文本
185.                   .fontSize(20) // 字体大小
186.                   .textAlign(TextAlign.Center) // 文本居中对齐
187.                   .fontColor("#5871ce") // 字体颜色
188.                   .backgroundColor("#f2f1fd") // 背景颜色
189.                   .clickEffect({ scale: 0.8, level: ClickEffectLevel.LIGHT }) // 点击效果
190.                   .borderRadius(10) // 边框圆角
191.                   .height('250lpx') // 设置高度
192.                   .layoutWeight(1) // 布局权重
193.                   .onClick(() => { // 点击事件
194.                     if (canIUse('SystemCapability.Multimedia.Scan.ScanBarcode')) { // 检查是否支持扫描
195.                       try { // 尝试
196.                         scanBarcode.startScanForResult(getContext(this), { // 开始扫描
197.                           enableMultiMode: true, // 启用多模式
198.                           enableAlbum: true // 启用相册选择
199.                         },
200.                           (error: BusinessError, result: scanBarcode.ScanResult) => { // 扫描结果回调
201.                             if (error) { // 如果发生错误
202.                               hilog.error(0x0001, '[Scan CPSample]', // 记录错误日志
203.                                 `Failed to get ScanResult by callback with options. Code: ${error.code}, message: ${error.message}`);
204.                               return; // 退出
205.                             }
206.                             hilog.info(0x0001, '[Scan CPSample]', // 记录成功日志
207.                               `Succeeded in getting ScanResult by callback with options, result is ${JSON.stringify(result)}`);
208.                             this.scanResultObject = result; // 设置扫描结果对象
209.                             this.scanResult = result.originalValue ? result.originalValue : '无法识别'; // 设置扫描结果文本
210.                           });
211.                       } catch (error) { // 捕获错误
212.                         hilog.error(0x0001, '[Scan CPSample]', // 记录错误日志
213.                           `Failed to start the scanning service. Code:${error.code}, message: ${error.message}`);
214.                       }
215.                     } else { // 如果不支持扫描
216.                       promptAction.showToast({ message: '当前设备不支持二维码扫描' }); // 弹出提示消息
217.                     }
218.                   });
220.                 Line().width(`${this.basePadding}lpx`).aspectRatio(1); // 分隔线
222.                 Text('图库选') // 图库选择文本
223.                   .fontSize(20) // 字体大小
224.                   .textAlign(TextAlign.Center) // 文本居中对齐
225.                   .fontColor("#e48742") // 字体颜色
226.                   .backgroundColor("#ffefe6") // 背景颜色
227.                   .borderRadius(10) // 边框圆角
228.                   .clickEffect({ scale: 0.8, level: ClickEffectLevel.LIGHT }) // 点击效果
229.                   .height('250lpx') // 设置高度
230.                   .layoutWeight(1) // 布局权重
231.                   .onClick(() => { // 点击事件
232.                     if (canIUse('SystemCapability.Multimedia.Scan.ScanBarcode')) { // 检查是否支持扫描
233.                       let photoOption = new photoAccessHelper.PhotoSelectOptions(); // 创建照片选择选项
234.                       photoOption.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE; // 设置 MIME 类型
235.                       photoOption.maxSelectNumber = 1; // 设置最大选择数量
236.                       let photoPicker = new photoAccessHelper.PhotoViewPicker(); // 创建照片选择器
237.                       photoPicker.select(photoOption).then((result) => { // 选择照片
238.                         let inputImage: detectBarcode.InputImage = { uri: result.photoUris[0] }; // 获取选中的图片 URI
239.                         try { // 尝试
240.                           detectBarcode.decode(inputImage, // 解码条形码
241.                             (error: BusinessError, result: Array<scanBarcode.ScanResult>) => { // 解码结果回调
242.                               if (error && error.code) { // 如果发生错误
243.                                 hilog.error(0x0001, '[Scan Sample]', // 记录错误日志
244.                                   `Failed to get ScanResult by callback. Code: ${error.code}, message: ${error.message}`);
245.                                 return; // 退出
246.                               }
247.                               hilog.info(0x0001, '[Scan Sample]', // 记录成功日志
248.                                 `Succeeded in getting ScanResult by callback, result is ${JSON.stringify(result, null, '\u00A0\u00A0')}`);
249.                               if (result.length > 0) { // 如果有结果
250.                                 this.scanResultObject = result[0]; // 设置扫描结果对象
251.                                 this.scanResult = result[0].originalValue ? result[0].originalValue : '无法识别'; // 设置扫描结果文本
252.                               } else { // 如果没有结果
253.                                 this.scanResult = '不存在二维码'; // 设置结果文本
254.                               }
255.                             });
256.                         } catch (error) { // 捕获错误
257.                           hilog.error(0x0001, '[Scan Sample]', // 记录错误日志
258.                             `Failed to detect Barcode. Code: ${error.code}, message: ${error.message}`);
259.                         }
260.                       });
261.                     } else { // 如果不支持扫描
262.                       promptAction.showToast({ message: '当前设备不支持二维码扫描' }); // 弹出提示消息
263.                     }
264.                   });
265.               }
266.               .justifyContent(FlexAlign.SpaceEvenly) // 主轴对齐方式
267.               .width('650lpx') // 设置宽度
268.               .padding(`${this.basePadding}lpx`) // 内边距
269.               .borderRadius(10) // 边框圆角
270.               .backgroundColor(Color.White) // 背景颜色
271.               .shadow({ // 阴影
272.                 radius: 10, // 阴影半径
273.                 color: this.shadowColor, // 阴影颜色
274.                 offsetX: 0, // X 轴偏移
275.                 offsetY: 0 // Y 轴偏移
276.               });
278.               Column() { // 列布局
279.                 Row() { // 行布局
280.                   Text(`解析结果：\n${this.scanResult}`) // 显示解析结果文本
281.                     .fontColor(this.textColor) // 设置字体颜色
282.                     .fontSize(18) // 设置字体大小
283.                     .layoutWeight(1) // 设置布局权重
284.                   Text('复制') // 复制按钮文本
285.                     .fontColor(Color.White) // 设置字体颜色为白色
286.                     .fontSize(16) // 设置字体大小
287.                     .padding(`${this.basePadding / 2}lpx`) // 设置内边距
288.                     .backgroundColor("#0052d9") // 设置背景颜色
289.                     .borderRadius(5) // 设置边框圆角
290.                     .clickEffect({ level: ClickEffectLevel.LIGHT, scale: 0.8 }) // 设置点击效果
291.                     .onClick(() => { // 点击事件
292.                       this.copyToClipboard(this.scanResult); // 复制扫描结果到剪贴板
293.                     });
294.                 }.constraintSize({ minHeight: 45 }) // 设置最小高度约束
295.                 .justifyContent(FlexAlign.SpaceBetween) // 设置主轴对齐方式
296.                 .width('100%'); // 设置宽度为100%
298.               }
299.               .visibility(this.scanResult ? Visibility.Visible : Visibility.Hidden) // 根据扫描结果设置可见性
300.               .alignItems(HorizontalAlign.Start) // 设置交叉轴对齐方式
301.               .width('650lpx') // 设置宽度
302.               .padding(`${this.basePadding}lpx`) // 设置内边距
303.               .margin({ top: `${this.basePadding}lpx` }) // 设置外边距
304.               .borderRadius(10) // 设置边框圆角
305.               .backgroundColor(Color.White) // 设置背景颜色为白色
306.               .shadow({ // 设置阴影
307.                 radius: 10, // 设置阴影半径
308.                 color: this.shadowColor, // 设置阴影颜色
309.                 offsetX: 0, // 设置X轴偏移
310.                 offsetY: 0 // 设置Y轴偏移
311.               });
313.               Column() { // 列布局
314.                 Row() { // 行布局
315.                   Text(`完整结果：`).fontColor(this.textColor).fontSize(18).layoutWeight(1) // 显示完整结果文本
316.                 }.constraintSize({ minHeight: 45 }) // 设置最小高度约束
317.                 .justifyContent(FlexAlign.SpaceBetween) // 设置主轴对齐方式
318.                 .width('100%'); // 设置宽度为100%
320.                 Divider().margin({ top: 2, bottom: 15 }); // 添加分隔线并设置外边距
322.                 Row() { // 行布局
323.                   Text(`${JSON.stringify(this.scanResultObject, null, '\u00A0\u00A0')}`) // 显示完整扫描结果
324.                     .fontColor(this.textColor) // 设置字体颜色
325.                     .fontSize(18) // 设置字体大小
326.                     .layoutWeight(1) // 设置布局权重
327.                     .copyOption(CopyOptions.LocalDevice); // 设置复制选项
328.                 }.constraintSize({ minHeight: 45 }) // 设置最小高度约束
329.                 .justifyContent(FlexAlign.SpaceBetween) // 设置主轴对齐方式
330.                 .width('100%'); // 设置宽度为100%
332.               }
333.               .visibility(this.scanResult ? Visibility.Visible : Visibility.Hidden) // 根据扫描结果设置可见性
334.               .alignItems(HorizontalAlign.Start) // 设置交叉轴对齐方式
335.               .width('650lpx') // 设置宽度
336.               .padding(`${this.basePadding}lpx`) // 设置内边距
337.               .margin({ top: `${this.basePadding}lpx` }) // 设置外边距
338.               .borderRadius(10) // 设置边框圆角
339.               .backgroundColor(Color.White) // 设置背景颜色为白色
340.               .shadow({ // 设置阴影
341.                 radius: 10, // 设置阴影半径
342.                 color: this.shadowColor, // 设置阴影颜色
343.                 offsetX: 0, // 设置X轴偏移
344.                 offsetY: 0 // 设置Y轴偏移
345.               });
347.             }
348.             .padding({ top: 20, bottom: 20 }) // 设置内边距
349.             .width('100%') // 设置宽度为100%
350.           }.scrollBar(BarState.Off) // 禁用滚动条
351.           .align(Alignment.Top) // 顶部对齐
352.           .height('100%') // 设置高度为100%
353.         }
354.       }
355.       .barHeight(0) // 设置选项卡条高度为0
356.       .tabIndex(this.selectIndex) // 设置当前选中的索引
357.       .width('100%') // 设置宽度为100%
358.       .layoutWeight(1) // 设置布局权重
359.       .onChange((index: number) => { // 选项卡变化事件
360.         this.selectIndex = index; // 更新选择的索引
361.       });
362.     }
363.     .height('100%') // 设置高度为100%
364.     .width('100%') // 设置宽度为100%
365.     .backgroundColor("#f4f8fb"); // 设置背景颜色
366.   }
367. }

复制代码

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