自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。
UWB
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
在 Android 13 中推出的超寬頻 (UWB) 模組，包含位於 HAL 介面之上的 UWB 堆疊，該堆疊是以 FiRa 規格為依據。
UWB 模組可為裝置製造商提供下列優勢：
- 可供 UWB 裝置使用的完整 Android 原生 UWB 堆疊
- 改善 Android 生態系統中 UWB 的品質和互通性
- 針對新的 FiRa 用途和規格更新提供更快速、更彈性的支援
詳細說明
以下是 UWB 模組的詳細資料：
- 在 Android 13 的 AOSP 中納入完整的 UWB 堆疊，該堆疊使用 FiRa 定義的 UCI 規格做為 HAL 介面。
- 允許系統應用程式佈建自訂設定檔。
- 包含系統 API 途徑，可讓系統應用程式在測距工作階段中使用自訂設定檔。
- 包含可公開 RRO 的基礎架構，可供裝置製造商用來自訂堆疊的行為。
UWB 堆疊架構
UWB 堆疊包含 UWB 主線模組，以及 UWB 晶片供應商提供的 HAL 實作項目。
圖 1. UWB 堆疊架構
模組邊界
模組程式碼位於以下位置：
UWB 模組 (com.google.android.uwb) 使用 APEX 格式。
依附元件
UWB 主線模組會依賴下列項目：
- UWB 晶片供應商的 HAL 實作項目。
- 所有 OOB 互動的藍牙堆疊。
- 安全元素，可用於所有安全服務互動。
- 用於 UWB 執行階段權限強制執行的核心架構。
這個頁面中的內容和程式碼範例均受《內容授權》中的授權所規範。Java 與 OpenJDK 是 Oracle 和/或其關係企業的商標或註冊商標。
上次更新時間：2025-07-27 (世界標準時間)。
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-27 (世界標準時間)。"],[],[],null,["# UWB\n\nThe ultra-wideband (UWB) module, introduced in Android 13, contains a UWB stack\nabove the HAL interface, which is based on the FiRa specification.\n\nThe UWB module provides the following benefits for device manufacturers:\n\n- A complete Android native UWB stack available for UWB capable devices\n- Improved quality and interoperability of UWB across the Android ecosystem\n- Faster and more flexible support for new FiRa use cases and specification updates\n\n### Details\n\nThe following are details of the UWB module:\n\n- Includes a complete UWB stack in AOSP in Android 13 that uses the UCI specification defined by FiRa as the HAL interface.\n- Allows system apps to provision custom profiles.\n- Includes a system API surface to allows system apps to use custom profiles in their ranging sessions.\n- Includes infrastructure to expose RROs that can be used by device manufacturers to customize the behavior of the stack.\n\nUWB stack architecture\n----------------------\n\nThe UWB stack consists of the UWB mainline module and the HAL implementation\nprovided by a UWB chip vendor.\n\n**Figure 1.** UWB stack architecture\n\nModule boundary\n---------------\n\nThe module code is in the following locations:\n\n- **UWB Mainline Apex** : `com.android.uwb`\n\n - UWB API surface (Java)\n\n - Code location: `packages/modules/Uwb/framework`\n - Process: `\u003cbootclasspath\u003e`\n - UwbService (Java)\n\n - Code location: `packages/modules/Uwb/service`\n - Process: `system_server`\n - Uwb Native stack (C++/Rust)\n\n - Code location: `external/uwb`\n - Process: `system_server`\n- **HAL interface and implementations (C++)**\n\n - Interface code location: `hardware/interfaces/uwb`\n - Implementation code location: `vendor/\u003cvendor-name\u003e/uwb`\n - Process: `\u003cvendor defined\u003e`\n\nPackage format\n--------------\n\nThe UWB module (`com.google.android.uwb`) uses the\n[APEX](/docs/core/ota/apex) format.\n\nDependencies\n------------\n\nThe UWB mainline module depends on the following:\n\n- HAL implementation from a UWB chip vendor.\n- Bluetooth stack for all OOB interactions.\n- Secure element for all secure service interactions.\n- Core framework for UWB runtime permission enforcement."]]
