藍牙
搜尋附近嘅藍牙低功耗（BLE）裝置，檢查訊號強度同廣播資料，瀏覽 GATT 服務同特徵，並即時睇到已連接周邊裝置嘅數據。
概覽
藍牙工具利用 Apple 嘅 CoreBluetooth 框架，作為 BLE（藍牙低功耗）中央裝置，搜尋附近周邊裝置。會顯示所有發現到嘅裝置，包括即時訊號強度（RSSI）、廣播資料同連接狀態。你可以連接可連接嘅周邊裝置，瀏覽佢哋嘅 GATT 服務同特徵、讀取數值、訂閱通知，以及檢查製造商資料。
目錄
概覽畫面
概覽畫面係藍牙工具嘅主頁面，包含搜尋欄、帶有掃描控制嘅狀態卡，以及可捲動嘅已發現裝置清單。
搜尋欄
畫面頂部有個文字欄，可以根據名稱篩選裝置清單。輸入關鍵字即時縮窄清單，只顯示廣播名稱或周邊名稱包含搜尋文字（不分大小寫）嘅裝置。當欄位唔係空時會顯示清除按鈕。
藍牙狀態卡
狀態卡會顯示：
- 藍牙狀態 標籤，顯示目前無線電狀態，並以顏色區分：
- 已開啟（綠色）— 藍牙已啟動，可以進行掃描。
- 已關閉（紅色）— 藍牙無線電已關閉。
- 未授權（橙色）— 用戶拒絕咗應用程式使用藍牙權限。
- 不支援（紅色）— 裝置硬件唔支援藍牙。
- 未知 / 重設中（灰色）— 系統仍然判斷緊藍牙狀態。
- 掃描控制按鈕（只會喺藍牙已開啟時顯示）：
- 停止掃描（紅色）— 停止進行中嘅掃描。
- 開始掃描（綠色）— 開始搜尋附近周邊裝置。
打開工具並且藍牙已開啟時，會自動開始掃描。
裝置清單
已發現嘅裝置會以可捲動清單顯示，按 RSSI 排序（訊號最強排最前）。清單會即時更新，當有新裝置出現或現有裝置更新廣播資料時都會反映。
裝置列
每個裝置會以卡片形式顯示，內容包括：
- 一個藍牙圖示，包圍喺圓形徽章內。圓圈上有白色弧線，根據裝置訊號強度（0–100%）比例填滿。
- 裝置名稱 — 廣播本地名稱或周邊名稱。冇名稱嘅裝置會顯示為
[No Name]。 - RSSI — 接收訊號強度，以 dB 顯示（例如
RSSI: -43 dB）。 - 左下角有狀態指示，顯示以下其中一項：
- 已連接（綠色）— 裝置目前已連接。
- 可連接（藍色）— 裝置廣播接受連接。
- 服務：N — 裝置廣播嘅 GATT 服務數量（只會喺有服務但未連接時顯示）。
- (無標籤) — 裝置唔可連接，亦冇廣播服務。
- 右側有尾部指示：
- 如果裝置已連接，顯示綠色剔號圖示。
- 如果裝置可連接，顯示箭咀（
>），可點擊進入詳情。 - 如果裝置唔接受連接，顯示不可連接文字。
點擊任何裝置列可進入裝置詳情畫面。
空狀態
概覽畫面會根據情況顯示不同空狀態：
- 掃描中 — 初次掃描時未發現裝置，會顯示放大鏡圖示同載入動畫。
- 藍牙關閉 / 不支援 — 顯示斜線藍牙圖示、目前狀態及提示開啟藍牙。
- 已停止掃描 — 當藍牙已開啟但手動停止掃描且清單冇裝置時，顯示藍牙圖示同開始掃描按鈕。
裝置詳情畫面
點擊裝置列會打開專屬詳情畫面。畫面分為標題區、訊號強度儀表及三個內容分頁。
標題及連接
標題區包括：
- 返回按鈕（
< 裝置），返回概覽畫面。 - 明顯顯示裝置名稱。
- 連接狀態指示 — 彩色圓點加標籤：
- 已連接（綠色）
- 連接中（橙色）
- 已斷線（紅色）
- 斷線中（橙色）
- 連接 / 斷線按鈕（只會喺可連接裝置顯示）：
- 連接（藍色）— 發起 BLE 連接。建立連接時會顯示載入動畫。
- 連接中...（藍色，停用）— 連接過程中顯示。
- 斷線（紅色）— 終止現有連線。
成功連接後，工具會自動發現所有 GATT 服務及其特徵。可讀特徵會即時讀取，支援通知嘅特徵會自動訂閱。
訊號強度儀表
訊號強度區域提供裝置無線電訊號嘅詳細即時視圖：
-
圓形儀表 — 弧線由 0% 填至 100%，以角度漸變（紅至橙至黃至綠）。中央顯示目前 RSSI（dBm）。
-
大約距離 — 根據 RSSI 計算嘅人類可讀估算：
RSSI 範圍 標籤 -30 至 -50 dBm 極近 -51 至 -65 dBm 接近 -66 至 -80 dBm 中等 -81 至 -90 dBm 遙遠 低於 -90 dBm 非常遠 -
訊號條 — 5 格訊號指示，根據訊號強度百分比填滿。
-
訊號質素 — 文字標籤：極佳（>80%）、良好（>60%）、一般（>40%）、較差（>20%）、極差（<=20%）。
-
RSSI — 原始 dBm 數值。
-
TX Power — 發射功率（dBm），如裝置有廣播。此值代表距離發射器 1 米時嘅訊號強度，可用作估算距離。
-
訊號歷史 — 最近 20 次 RSSI 讀數嘅滾動長條圖，按顏色區分（綠 >= -60，黃 >= -75，紅 < -75）。有助視覺化訊號穩定性。
資訊分頁
資訊分頁顯示裝置一般資料，以鍵值列方式排列：
| 欄位 | 說明 |
|---|---|
| 名稱 | 廣播或周邊名稱（或 [No Name]）。 |
| 識別碼 | CoreBluetooth 指派嘅周邊 UUID。只係本地識別碼，唔係實際 MAC 地址。 |
| RSSI | 目前接收訊號強度（dB）。 |
| TX Power | 發射功率（dBm，僅裝置有廣播時顯示）。 |
| 可連接 | 裝置是否接受 BLE 連接（是 / 否）。 |
| 狀態 | 目前連接狀態（已連接、連接中、已斷線、斷線中）。 |
| 發現時間 | 本次掃描期間首次見到裝置嘅時間戳。 |
| 最後更新 | 最近一次廣播或 RSSI 更新嘅時間戳。 |
鍵值列下方，若裝置有提供相關資料，會顯示兩個額外區域：
- 廣播服務 — 裝置廣播封包內包含嘅 GATT 服務 UUID 清單。已知標準服務會顯示人類可讀名稱（例如
180F (Battery Service)、180A (Device Information)）。完 整清單見已識別服務。 - 製造商資料 — 廣播內原始製造商專屬資料，以十六進制字串顯示。首兩個位元組為 Bluetooth SIG 公司識別碼（小端序）。
服務分頁
只限裝置已連接時可用。顯示連接期間發現嘅完整 GATT 服務及特徵樹。
每個服務以可展開列顯示：
- 彩色圖示，代表服務類型：
- 藍色 — 通用服務（Generic Access
1800、Generic Attribute1801） - 綠色 — 電池服務（
180F） - 橙色 — 裝置資訊（
180A） - 紫色 — 廠商專屬服務（UUID 以
FE開頭） - 灰色 — 其他／未知服務
- 藍色 — 通用服務（Generic Access
- 服務名稱（如屬已知服務會由 UUID 解析），及原始 UUID 字串。
- 徽章，顯示該服務下特徵數量。
- 箭咀，展開時會旋轉。
已識別服務
| UUID | 服務名稱 |
|---|---|
1800 | Generic Access |
1801 | Generic Attribute |
180A | Device Information |
180F | Battery Service |
1812 | HID（人機介 面裝置） |
1813 | 掃描參數 |
1819 | 位置與導航 |
181C | 用戶資料 |
FE59 | Apple Notification Center |
展開服務後會顯示其特徵。每個特徵列顯示：
- 根據主要屬性顯示彩色圖示（紫色：可讀寫，藍色：只讀，綠色：只寫，橙色：只通知，灰色：其他）。
- 特徵名稱（如屬已知 GATT 特徵會由 UUID 解析），及原始 UUID 字串。
- 屬性標籤 — 每個支援屬性以小色塊標示：
- Read（藍色）— 可隨時讀取數值。
- Write（綠色）— 可寫入並獲確認。
- Write No Response（淺綠）— 可寫入但唔需確認。
- Notify（橙色）— 特徵可主動推送更新。
- Indicate（淺橙）— 類似 Notify，但有確認。
- Auth（紫色）— 需認證簽名寫入。
- 眼睛切換按鈕（有數值時顯示）。點擊可顯示特徵目前數值，並以多種格式展示：
- Hex — 原始位元組序列。
- String — 若位元組為有效文字，則以 UTF-8 解讀。
- Numeric — 根據位元組長度自動解讀：
- 1 byte：UInt8 數值
- 2 bytes：UInt16 數值
- 4 bytes：UInt32 數值及 Float 數值
已識別特徵
| UUID | 特徵名稱 |
|---|---|
2A00 | Device Name |
2A01 | Appearance |
2A04 | Peripheral Preferred Connection Parameters |
2A05 | Service Changed |
2A19 | Battery Level |
2A23 | System ID |
2A24 | Model Number String |
2A25 | Serial Number String |
2A26 | Firmware Revision String |
2A27 | Hardware Revision String |
2A28 | Software Revision String |
2A29 | Manufacturer Name String |
2A2A | IEEE 11073-20601 Regulatory Certification Data List |
2A50 | PnP ID |
數據分頁
數據分頁顯示已連接裝置嘅即時解讀數據。若裝置未連接，會顯示提示同連接按鈕（如可連接）或資訊訊息。
連接後，分頁會顯示最多三張卡片：
-
製造商資料 — 廣播內製造商專屬負載：
- 製造商 ID — 由製造商資料首兩個位元組（小端序）解析。已知 ID 包括 Apple（
0x004C）、Microsoft（0x0006）、Samsung（0x0075）、Xiaomi（0x038F）、Bosch（0x01D7）。未知 ID 以十六進制顯示（如ID: 0x1234）。 - 原始數據 — 製造商資料位元組完整十六進制轉儲。
- 位元組視覺化 — 橫向長條圖，每條代表一個位元組。高度按位元組值（0–255）比例顯示，方便快速辨識數據特徵。
- 製造商 ID — 由製造商資料首兩個位元組（小端序）解析。已知 ID 包括 Apple（
-
特徵數值 — 所有可讀特徵清單。每項顯示：
- 特徵名稱（或未知時顯示 UUID）。
- 解讀後數值（根據數據長度以位元組、UInt16、UInt32/Float、UTF-8 字串或十六進制顯示）。
- 最多 8 位元組時會有小型長條圖，條形按數值大小上色（藍 < 30%，綠 < 60%，黃 < 80%，紅 >= 80%）。
- 支援通知嘅特徵會自動更新數值。
-
連接資訊 — 時間及訊號元數據：
- 發現時間 — 首次見到裝置時間，並顯示自發現以來經過時間。
- 最後更新 — 最近一次數據更新時間，如有 TX Power 亦會顯示。
權限與需求
- 藍牙權限 — CoreBluetooth 需要用戶授權藍牙存取。如權限被拒絕，Lirum 會顯示權限畫面，並有按鈕打開 iOS 設定，方便用戶重新啟用。
- 藍牙無線電 — 如藍牙已關閉，工具仍可進入，但掃描控制會停用，並顯示提示開啟藍牙。此情況下唔會顯示權限閘。
- 藍牙權限由系統管理，冇明確「請求權限」按鈕。首次初始化 CoreBluetooth 時，系統會自動彈出授權提示。
技術細節
- 工具以 BLE Central 身份運作，使用
CBCentralManager。會搜尋所有附近周邊裝置（scanForPeripherals(withServices: nil)），即無論裝置廣播咩服務都會發現。 - RSSI（接收訊號強度指示）一般介乎 -30 dBm（極強，裝置極近）至 -100 dBm（極弱，裝置遠或有阻隔）。工具會用公式
(RSSI + 100) / 70將此範圍正規化為 0–100%。 - 對已連接裝置，每 2 秒輪詢一次 RSSI（
readRSSI()）。小於 2 dB 嘅變化會被濾除，以減少畫面跳動。 - 連接時，工具會呼叫
discoverServices(nil)列出所有 GATT 服務，再對每個服務呼叫discoverCharacteristics(nil, for:)。可讀特徵會自動用readValue(for:)讀取，支援通知嘅特徵會用setNotifyValue(true, for:)訂閱。 - TX Power（
CBAdvertisementDataTxPowerLevelKey）代表距離發射器 1 米時嘅訊號強度。如同時有 TX Power 同 RSSI，可用兩者差值估算路徑損耗及大約距離。 - 製造商資料（
CBAdvertisementDataManufacturerDataKey）遵循 Bluetooth SIG 格式：首兩個位元組為公司識別碼（小端序），其後為廠商專屬負載。 - 資訊分頁顯示嘅周邊識別碼係 CoreBluetooth 喺本機指派嘅 UUID。對同一裝置，跨應用啟動都會穩定，但唔係實際藍牙 MAC 地址（iOS 唔會公開）。
注意事 項與限制
- 你見到嘅資料取決於每個周邊裝置廣播咩內容，以及 iOS 透過 CoreBluetooth 釋出咩資料。有啲裝置只廣播最基本資料。
- 好多裝置會顯示為
[No Name]，因為佢哋冇喺廣播封包內包含本地名稱。 - 距離估算只係根據 RSSI 門檻嘅大概指引。實際距離會因環境、障礙物、天線方向、發射功率等大幅變化。
- 並非所有可連接裝置都一定能成功連接。有啲需要先喺 iOS 設定配對，有啲可能會拒絕第三方中央裝置連接。
- 傳統藍牙裝置（非 BLE）唔會經 CoreBluetooth 顯示，亦唔會出現喺掃描結果。
- RSSI 數值會因多徑干擾、人體吸收等環境因素快速波動。訊號歷史圖有助視覺上平滑變化。
疑難排解
- 搵唔到裝置 — 請確保藍牙已開啟，停留喺藍牙畫面幾秒，如已停止掃描請點擊開始掃描。
- 權限被拒 — 請喺權限畫面點擊打開設定，再於 iOS 私隱設定為 Lirum 重新啟用藍牙存取。
- 連接失敗 — 裝置可能需要先喺 iOS 設定配對，或者唔支援第三方應用連接，或已離開範圍。
- 服務分頁冇內容 — 有啲裝置冇公開服務，或服務發現有延遲。連接後等幾秒。如仍然冇服務，裝置可能唔支援標準 GATT 配置。
- 特徵數值只顯示十六進制 — 工具會嘗試將數值解讀為 UTF-8 文字及常見數值型別。如無法解讀，會顯示原始十六進制轉儲。