二维码
Zion 平台支持二维码的生成与扫码功能，助力开发者在应用中灵活集成二维码相关能力。本文将详细介绍二维码的生成、参数配置、背景图设置及扫码功能的实现方法。
包括：
- 生成二维码
- 扫描二维码
- 生成小程序码
生成二维码
作用
点击触发后生成一个二维码，二维码内容可为纯文本或携带参数，并支持设置二维码背景图。
行为配置
添加页面变量
生成的二维码需暂存于页面变量。请在页面中添加类型为“图片”的页面变量，建议为多个变量合理命名以区分用途。
添加行为
在需要生成二维码的组件交互中，添加“二维码 - 生成二维码”行为，并将生成的二维码赋值给页面变量。
| 配置行为1 | 配置行为2 |
|---|---|
 |  |
配置参数
-
打开纯文本模式：仅设置一个数据，可为文本、网址、图片、文件或视频链接。
- 文本：扫码后显示文字内容。
- 网址（https 开头）：扫码后跳转至网页。
- 图片 URL：扫码后显示图片。
- 文件 URL（word、ppt、pdf 等）：扫码后可浏览文件内容。
- 视频 URL（MP4 等）：扫码后可播放视频。
-
关闭纯文本模式：二维码参数为 JSON 对象。
- 例如配置 seat_id（整数）和 web_link（文本），扫码后数据为：
{"seat_id":10,"web_link":"https://www.functorz.com/"}
- 典型场景：
- 扫码点餐：参数绑定餐桌 ID，扫码后自动识别桌号。
- 设备巡检：参数绑定设备 ID，扫码后自动关联设备。
- 例如配置 seat_id（整数）和 web_link（文本），扫码后数据为：
设置背景图
如需设置二维码背景图，可在行为配置中打开背景图片设置，调整二维码与背景图的相对位置。
- 例如背景图 400×400px，二维码 300×300px，居中时二维码相对位置为 X:50, Y:50。
绑定页面变量到图片组件
生成二维码后，建议通过显示弹窗行为，在弹窗中添加图片组件并绑定页面变量以展示二维码。
| 配置行为3 | 配置行为4 |
|---|---|
 |  |
配置效果
扫描二维码
作用
点击后打开手机相机扫描二维码，扫码结果可赋值到页面变量，便于后续业务逻辑处理。
配置指南
添加页面变量
请根据扫码结果类型（如整数、文本等）添加对应类型的页面变量。
添加行为
一般为按钮组件配置“二维码 - 扫描二维码”行为，扫码成功后可配置提示行为。
解码指引
可前往草料二维码 - 解码 页面上传二维码图片，查看二维码数据类型，便于在 Zion 中设计扫码参数配置。
注意：扫码行为仅支持小程序端。
生成小程序码
作用
生成可扫码进入小程序指定页面的二维码，支持参数与背景图设置，适用于页面分享、商家/商品详情页等场景。
行为配置
添加页面变量
同二维码生成，需添加类型为“图片”的页面变量。
添加行为
- 在组件交互中添加“二维码 - 生成小程序码”行为。
- 无需参数时，类型选“微信”，指定跳转页面并赋值给页面变量。
- 需参数时，类型选“自定义”，如分享者 ID、商户 ID 等，页面需添加同名页面入参。
| 配置行为1 | 配置行为2 | 配置行为3 |
|---|---|---|
|  |  |
设置背景图
如需设置背景图，配置方式同二维码生成。
注意事项
- “自定义”类型生成的小程序码永久有效，数量上限 100,000。
- “微信”类型生成的小程序码永久有效，数量暂无限制。
微信公众平台生成小程序码
登录微信公众平台，选择“工具-生成小程序码”，按提示操作。
- 点击“获取更多页面路径”，仅有权限的开发者可复制页面路径。
- 输入开发者微信号，完成权限配置。
- 点击小程序右上角“更多”，进入页面复制路径。
- 复制后粘贴至生成页面码。
常见问题
- 如何显示不同商家页面？路径后拼接参数，如
/index?shopid=1。
特殊说明
- 仅微信审核通过并上线的小程序可扫码进入指定页面。
- 仅企业认证小程序账号支持扫码进入指定页面。
- 相关行为仅支持小程序端。
Last updated on