为了触发自动入网连接,二维码有效载荷必须遵循由 ZXing 项目发起并已在 Android 和 iOS 上广泛普及的标准 WIFI: URI 方案。
标准语法规则
该语法定义了由分号分隔并以双分号结尾的五个键值参数:
WIFI:T:<AuthenticationType>;S:<SSID>;P:<Password>;H:<IsHidden>;;
T:认证协议。支持的参数包括WPA(涵盖 WPA、WPA2-PSK 与 WPA3-SAE)、WEP(传统 WEP 加密)或nopass(开放无密码网络)。S:服务集标识符(网络广播名称/SSID)。区分大小写。P:预共享密钥(网络密码)。当T:nopass时留空。H:隐藏网络标识。取值为true或false。
具体配置示例
标准 WPA2/WPA3 家庭或办公室网络:
WIFI:T:WPA;S:StudioHQ_Guest;P:Precision2026!;H:false;;
开放式餐饮公共热点:
WIFI:T:nopass;S:Cafe_Open_5G;P:;H:false;;
含保留特殊字符的隐藏网络:
WIFI:T:WPA;S:Lab\;Corp\,East;P:Secret\:Key\\99;H:true;;
字符转义要求
由于分号(;)、冒号(:)、逗号(,)和反斜杠(\)在协议解析器中作为结构分隔符,因此当实际 SSID 或密码字符串中出现这些字符时,必须在前面加上反斜杠(\)进行转义。Utiliome 会在浏览器本地自动处理此类字符转义。