核心超寬頻 (UWB)

宣告依附元件

如要新增核心的依附元件，您必須將 Google Maven 存放區新增至專案。詳情請參閱「Google 的 Maven 存放區」一節。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation "androidx.core.uwb:uwb:1.0.0-alpha08"
}

dependencies {
    // Use to implement UWB (ultra-wideband) on supported devices
    implementation("androidx.core.uwb:uwb:1.0.0-alpha08")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 說明文件。

1.0 版本

1.0.0-alpha10 版本

2024 年 12 月 11 日

發布 androidx.core.uwb:uwb:1.0.0-alpha10 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂項目。

API 變更

• 新增 UWB 狀態變更的理由代碼 STATE_CHANGE_REASON_UNKNOWN、STATE_CHANGE_REASON_SYSTEM_POLICY 和 STATE_CHANGE_REASON_COUNTRY_CODE_ERROR。(I43e36)。
• 新增 API RangingResult#RangingResultInitialized，在初始化測距工作階段時傳送事件。(I386bb)
• 將新的 API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) 和 unsubscribeFromUwbAvailability() 新增至 UWB 狀態變更事件的事件監聽器。新增介面 UwbAvailabilityCallback，讓使用者在觀察到 UWB 狀態變更事件時，定義回呼函式。(I37191)。

1.0.0-alpha09 版本

2024 年 10 月 16 日

發布 androidx.core.uwb:uwb:1.0.0-alpha09 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha09。1.0.0-alpha09 版包含這些修訂項目。

API 變更

• 新增 API isAvailable()，用於檢查 UWB 可用性。(If6fc6)
• 新增 API addControleeWithSessionParams，以支援新增控制項 p-sts 個別鍵的情況。(Ie7849)

1.0.0-alpha08 版本

2024 年 1 月 24 日

發布 androidx.core.uwb:uwb:1.0.0-alpha08 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha08。1.0.0-alpha08 版包含此連結所列的修訂項目。

API 變更

• 新增功能和參數，讓第三方應用程式可設定測距間隔、時段長度，以及啟用/停用 AoA。新增 API，支援重新設定測距間隔和測距資料通知。(Iebd18)。

1.0.0-alpha07 版本

2023 年 8 月 23 日

發布 androidx.core.uwb:uwb:1.0.0-alpha07 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha07。1.0.0-alpha07 版包含此連結所列的修訂項目。

修正錯誤

• 修正了當中國裝置安裝 Google Play 服務時，系統不會使用 AOSP 後端的問題。

1.0.0-alpha06 版本

2023 年 7 月 26 日

發布 androidx.core.uwb:uwb:1.0.0-alpha06 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha06。1.0.0-alpha06 版包含此連結所列的修訂項目。

新功能

• 新增對已佈建 STS 的支援。如今，如果裝置支援已佈建的 STS，使用者就能選擇使用已佈建的 STS 進行 UWB 測距。(I19812)。

API 變更

• 將 subSessionId 和 subSessionKeyInfo 新增至 rangingParameters。新增設定 ID 以支援已佈建的 STS。(I19812)。
• 針對 a、b、c 路徑合併公開和實驗性 API 檔案 (I8cfee、b/278769092)
• 不適用，API 檔案變更只是重新排序方法 (I5fa95)
• 已遷移 androidx.core 群組，以便使用已合併的公開 API 檔案 (Ifdef4、b/278769092)
• 將 minRangingInterval、supportedChannels 和 supportedConfigIds 新增至 rangingCapabilities 做為新欄位。(I2a204)

修正錯誤

• 修正在非 gms 區域中無法建立 UWB 用戶端的問題。

1.0.0-alpha05 版本

2023 年 4 月 5 日

發布 androidx.core.uwb:uwb:1.0.0-alpha05 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha05。1.0.0-alpha05 版包含此連結所列的修訂項目。

API 變更

• 將 RangingParameters#CONFIG_ID_1 重新命名為 CONFIG_UNICAST_DS_TWR。
• 新增設定 ID RangingParameters#CONFIG_MULTICAST_DS_TWR。(I2f1b7)

修正錯誤

• 修正使用者無法同時啟動多個測距工作階段的錯誤。

1.0.0-alpha04 版本

2022 年 12 月 7 日

發布了 androidx.core.uwb:uwb:1.0.0-alpha04 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha04。1.0.0-alpha04 版包含此連結所列的修訂項目。

新功能

• 在不支援 GMS 的情況下，AndroidX API 會嘗試使用 Android 開放原始碼計畫 UWB 後端服務，該服務是透過 Android 開放原始碼計畫平台發布給原始設備製造商 (OEM) (532de0)。

API 變更

• 新增 @JvmDefaultWithCompatibility 註解 (I8f206)

1.0.0-alpha03 版本

2022 年 8 月 10 日

發布 androidx.core.uwb:uwb:1.0.0-alpha03 和 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha03。1.0.0-alpha03 版包含此連結所列的修訂項目。

新功能

• 推出新的測距設定檔 Controller。具有 Controller 設定檔的 UWB 裝置可以決定兩台裝置測距時使用的測距頻道。

API 變更

• 新增 UWB 控制器支援 (I52a71)。

1.0.0-alpha02 版本

2022 年 6 月 29 日

發布 androidx.core.uwb:uwb-rxjava3:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

• 推出適用於 uwb 模組的 Java 互通性構件。新構件需要 rxjava3 才能運作，且將成為 Java 用戶端的消耗項。

1.0.0-alpha02 版本

2022 年 6 月 15 日

發布 androidx.core.uwb:uwb:1.0.0-alpha02。1.0.0-alpha02 版包含此連結所列的修訂項目。

新功能

• 隆重推出公開 UWB_CONFIG_ID_1

API 變更

• RangingResultPosition 的距離現在可為空值

1.0.0-alpha01 版本

2022 年 6 月 1 日

發布 androidx.core.uwb:uwb:1.0.0-alpha01。1.0.0-alpha01 版包含此連結所列的修訂項目。

新功能

• UWB 程式庫提供一組 API，可讓開發人員與支援 UWB 的裝置進行互動。其用途將僅限於特定的聯合裝置，這類裝置已取得 UWB 測距工作階段的 Controller 設定檔，預計將於不久後正式支援Controller 設定檔。此初始版本包含兩個頂層 API 介面：UwbManager 和 UwbClientSessionScope。