# 策展 · X (Twitter) 🔥

> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)

> 作者：Ahmed Hamdan (@AhmedJHamdan) · 平台：X (Twitter) · 日期：2026-05-25

> 原始來源：https://x.com/AhmedJHamdan/status/2058543574891761705

## 中文摘要

Flutter發布套件實現高精度超寬頻感測。

Ahmed Hamdan 所開發的 `flutter_uwb` 1.0.1 版本已正式上架至 [pub.dev](https://pub.dev/packages/flutter_uwb)，旨在簡化跨平台 UWB 應用的開發流程，讓開發者能輕鬆打造類似 Apple AirTag 的精確定位體驗。

**核心功能與技術特色**
該套件提供了一套統一的 Dart API，同時支援 Android 與 iOS 平台，具備以下關鍵能力：
- 距離與方向感測：支援公分級距離測量，並在硬體支援下提供方位角與仰角資訊。
- 內建發現與配對機制：透過 BLE 或 MultipeerConnectivity 進行裝置搜尋，並自動處理端到端 UWB token 交換，無需手動編寫 QR Code 或訊號傳輸邏輯。
- 靈活的連線控制：提供 `incomingRequests` 串流，讓應用程式在 UWB 啟動前決定是否接受配對請求。
- 支援 Apple FiRa 配件：在 iOS 上可與 Qorvo、NXP 等符合 FiRa 標準的標籤進行測距，並支援透過 ARKit 輔助的方向感測。
- 安全性設計：Android 裝置間採用 X25519 ECDH 與 HKDF-SHA256 進行加密通訊；iOS 則利用 Apple 原生的保護機制。
- 生產環境就緒：包含 `checkReadiness()` 與 `getDeviceCapabilities()` 等檢查機制，並透過 `Streams` 統一處理裝置發現、錯誤回報與生命週期管理。

**平台支援與限制**
目前支援的配對組合包括：iPhone 對 iPhone、Android 對 Android，以及 iPhone 對 Apple-FiRa 配件。需注意，目前不支援 iPhone 與 Android 裝置之間的跨平台互連。
- Android 需求：Pixel 6 Pro、Galaxy S21 Ultra 或任何具備 `FEATURE_UWB` 的裝置。
- iOS 需求：搭載 U1/U2 晶片的 iPhone（iPhone 11 及後續機型，不含 SE 2/3），且系統需為 iOS 16 以上。

**安裝與快速入門**
開發者可透過以下指令將套件加入專案：
```bash
flutter pub add flutter_uwb
```
在程式開發上，雙方裝置需執行相同的程式碼，並設定唯一的 `localName`。針對 Apple-FiRa 配件（僅限 iOS），需在 `startDiscovery` 前註冊廠商的 BLE 服務三元組（Service Triplet）。更多關於協定細節、token 格式及握手流程的技術架構說明，可參考 `` `doc/architecture.md` ``。

**開發資源**
開發者可參考 `` `example/` `` 資料夾中的範例應用，該範例展示了完整的發現、配對及即時距離與方位讀取功能。此外，套件亦提供針對 Android 與 iOS 搜尋問題、區域限制及詳細日誌記錄的疑難排解指南。本專案採用 MIT 授權。

## 標籤

SDK, 開源專案, iOS, Android, Flutter, Apple, Google