Skip to main content

​
适用场景

Wi-Fi QR 码让手机摄像头自动加入无线网络——无需手动输入 SSID 或密码。它是一种 Quick Code：一种没有落地页的直接动作型 QR，由一个小表单构建而成，而不是 Page Builder。应用中它的卡片文案是 “Connect visitors to your Wi-Fi network instantly.”（让访客瞬间连接到您的 Wi-Fi 网络）。
Wi-Fi 仅支持 Static——此类型没有 Dynamic 选项。一旦发布，编码后的网络凭据将无法编辑或追踪；如需更改，请创建一个新的 QR 码。

​
创建一个 Wi-Fi QR 码

1

打开 Create QR Code 并选择 Quick Code

在侧边栏中，进入 QR Codes，然后点击 Create QR Code（或前往 /qr/create）。点击 Quick Code 卡片。
2

选择 Wi-Fi

在 Quick Code 类型网格中，点击 Static Only 分区下 Wi-Fi 下方的 Configure。这会打开 /qr/quick/wifi 处的表单。
3

输入网络名称

在 Network name (SSID) 中输入网络的 SSID——这是唯一的必填字段。占位符显示 “My Network”。
4

选择安全类型

Security type 下拉菜单默认选中 WPA2，同时也提供 WPA、WEP 和 None (open network) 选项。选择 None 会完全隐藏 Password 字段，因为开放网络没有密码需要编码。
Wi-Fi Quick Code 表单，Security type 下拉菜单展开，展示 WPA2（已选中）、WPA、WEP 和 None (open network) 选项

展开的 Security type 下拉菜单，展示 WPA2、WPA、WEP 和 None (open network)

5

输入密码和隐藏网络设置

对于除 None 之外的任何安全类型，请在 Password 字段中输入网络密码。如果该网络不广播其 SSID，请打开 Hidden network (SSID is not broadcast)，以便扫描设备知道需要通过名称加入网络，而不是从可见列表中选择。
Wi-Fi Quick Code 表单，已填写网络名称 docs-v2-Guest-WiFi、WPA2 安全类型、一个密码，Hidden network 开关已开启——已出现 QR 预览，Publish 按钮现已启用

已填写完成的 Wi-Fi Quick Code 表单，带有实时 QR 预览，Publish 已启用

6

发布

点击 Publish。会弹出一个面板，用于确认或重命名 QR 码（默认使用 “Wi-Fi: <network name>”）、分配文件夹或标签，并在确认前调整 QR 码设计。

​
通过 API 创建

若要通过 API 而非界面创建 Wi-Fi QR 码，请使用类别 ID 6（标记为 WiFi，allowed_qr_types: "st"——qr_type 只能取 "st"），其 info 负载结构如下：
authentication 接受 WPA、WPA2、WEP 或 none；password 和 hidden 均为可选字段（hidden 默认值为 false）。完整的请求结构请参见 Create QR Code。
Category List 参考表目前尚未列出 WiFi（以及本页其他仅限 Quick Code 的类别）——上述 ID 是直接对照实际的 /qr/category/ 端点确认得到的。

​
相关内容