為觸發行動裝置自動加入網路,QR Code 承載資料必須遵循由 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 會在瀏覽器本機自動完成此跳脫程序。