二维码生成使用指导

二维码生成使用指导

二维码生成把一段文字编码成二维码，直接画在指定组件（布局、图像等）的背景上，不需要联网。文字可以是网址、名片、WiFi 连接信息或任意内容；中文按 UTF-8 编码，微信等主流扫码软件都能识别。

工作原理

生成二维码（文本，组件）（GenerateQRCode）(文本, 组件)：把二维码画在组件的背景上；
成功触发生成成功时（OnSuccess），失败（如文本为空）触发出错时（消息）（OnError）；
目标组件要有固定的宽和高，正方形最好，二维码会铺满它；
前景色（BlackColor）、背景色（WhiteColor）默认黑白，可以改，但对比要足够大才扫得出来。

快速上手

放一个垂直布局（宽、高都设为 250 像素）、一个文本输入框和一个按钮：

when 按钮1.Click() {
  二维码生成1.GenerateQRCode(文本输入框1.Text, 垂直布局1)
}

输入 https://www.fun123.cn 点按钮，布局里出现二维码，用手机扫一扫就能打开网址。

案例一：手机名片二维码

用 MECARD 格式，扫码后手机会提示「添加联系人」：

when 按钮_生成名片.Click() {
  二维码生成1.GenerateQRCode(join("MECARD:N:", 文本输入框_姓名.Text, ";TEL:", 文本输入框_电话.Text, ";EMAIL:", 文本输入框_邮箱.Text, ";;"), 垂直布局_二维码)
}

案例二：WiFi 连接二维码

来访客人扫码即可连上 WiFi（安卓相机和大多数扫码软件支持）：

when 按钮_生成WiFi.Click() {
  二维码生成1.GenerateQRCode(join("WIFI:T:WPA;S:", 文本输入框_名称.Text, ";P:", 文本输入框_密码.Text, ";;"), 垂直布局_二维码)
}

没有密码的开放网络写成 WIFI:T:nopass;S:名称;;。

案例三：彩色二维码与出错提示

when Screen1.Initialize() {
  二维码生成1.BlackColor = &HFF1565C0
  二维码生成1.WhiteColor = &HFFFFFFFF
}

when 按钮1.Click() {
  二维码生成1.GenerateQRCode(文本输入框1.Text, 图像1)
}

when 二维码生成1.OnSuccess() {
  标签1.Text = "已生成，扫一扫试试"
}

when 二维码生成1.OnError(消息) {
  标签1.Text = join("生成失败：", 消息)
}

前景用深色、背景用浅色，不要反过来（很多扫码软件认不出反色二维码）。

案例四：与扫码器配合

一台手机生成，另一台手机用条码扫描器扫出内容，常用于签到、配对：

when 按钮_扫码.Click() {
  条码扫描器1.DoScan()
}

when 条码扫描器1.AfterScan(返回结果) {
  标签_结果.Text = join("扫到：", 返回结果)
}

常见问题

现象	原因与处理
二维码没显示	目标组件没有设固定宽高（「自动」时尺寸为 0）；看是否触发了生成出错时
扫不出来	前景和背景颜色对比不够；二维码太小；内容太长导致码点太密，可先缩短（如换短网址）
二维码被拉伸变形	目标组件不是正方形，把宽高设成一样
生成出错：文本为空	输入框没填内容

平台说明

安卓与鸿蒙都支持；鸿蒙使用系统扫码服务的生成能力。

完整 .aia 源码与操作指导

下载 .aia 源码

无需账号、相机权限或网络即可生成二维码。启动展示真实站点网址，可改成中文、设备编号。生成目标为固定方形布局，用另一台手机扫码核对。颜色保持深色前景和浅色背景，便于识别。

导入 QRCodeGeneratorAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

API / 功能	操作入口	预期结果
BlackColor / WhiteColor 设计器配置与读取	导入初始化	显示深蓝前景、浅色背景，属性区读取实际色值
GenerateQRCode / OnSuccess	初始化或点生成	260×260布局显示二维码；成功次数增加，显示实际内容
BlackColor / WhiteColor 设置	点配色	切换黑白与深蓝浅色并重新生成；原文本不变
OnError	点空内容	明确失败原因，错误次数增加，保留原输入；旧图不冒充新生成结果
中文、网址与设备编号	修改内容后生成并扫码	扫描结果与输入一致；生成无需网络，打开网址需网络

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。