核心超寬頻 (UWB)

  
在支援的裝置上實作 UWB (超寬頻)。
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2024 年 12 月 11 日 - - - 1.0.0-alpha10

宣告依附元件

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

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

Groovy

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

Kotlin

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-alpha10androidx.core.uwb:uwb-rxjava3:1.0.0-alpha10。1.0.0-alpha10 版包含這些修訂項目

API 變更

  • 新增 UWB 狀態變更的理由代碼 STATE_CHANGE_REASON_UNKNOWNSTATE_CHANGE_REASON_SYSTEM_POLICYSTATE_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-alpha09androidx.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-alpha08androidx.core.uwb:uwb-rxjava3:1.0.0-alpha081.0.0-alpha08 版包含此連結所列的修訂項目。

API 變更

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

1.0.0-alpha07 版本

2023 年 8 月 23 日

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

修正錯誤

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

1.0.0-alpha06 版本

2023 年 7 月 26 日

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

新功能

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

API 變更

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

修正錯誤

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

1.0.0-alpha05 版本

2023 年 4 月 5 日

發布 androidx.core.uwb:uwb:1.0.0-alpha05androidx.core.uwb:uwb-rxjava3:1.0.0-alpha051.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-alpha04androidx.core.uwb:uwb-rxjava3:1.0.0-alpha041.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-alpha03androidx.core.uwb:uwb-rxjava3:1.0.0-alpha031.0.0-alpha03 版包含此連結所列的修訂項目

新功能

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

API 變更

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

1.0.0-alpha02 版本

2022 年 6 月 29 日

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

新功能

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

1.0.0-alpha02 版本

2022 年 6 月 15 日

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

新功能

  • 隆重推出公開 UWB_CONFIG_ID_1

API 變更

  • RangingResultPosition 的距離現在可為空值

1.0.0-alpha01 版本

2022 年 6 月 1 日

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

新功能

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