核心超宽带 (UWB)

在支持的设备上实现 UWB（超宽带）。

最新更新	稳定版	发布候选版	Beta 版	Alpha 版
2024 年 12 月 11 日	-	-	-	1.0.0-alpha10

声明依赖项

要添加对 core 的依赖项，您必须将 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-alpha10"
}

Kotlin

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

有关依赖项的更多信息，请参阅添加构建依赖项。

反馈

您的反馈有助于改进 Jetpack。如果您发现新问题或有改进此库的建议，请告诉我们。在创建新问题之前，请查看此库中的现有问题。您可以通过点击星形按钮为现有问题投票。

创建新问题

有关更多信息，请参阅问题跟踪器文档。

版本 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 包含这些提交。

新功能

添加对 Provisioned STS 的支持。如果设备支持 Provisioned STS，用户现在可以选择 Provisioned STS 进行 UWB 测距。(I19812)

API 更改

将 subSessionId 和 subSessionKeyInfo 添加到 rangingParameters。添加新的配置 ID 以支持 Provisioned STS。(I19812)
合并公共和实验性 API 文件，用于 a,b,c 路径 (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 将尝试使用通过 AOSP 平台分发给 OEM 的 AOSP UWB 后端服务。(‍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 的距离现在可以是 null

版本 1.0.0-alpha01

2022 年 6 月 1 日

androidx.core.uwb:uwb:1.0.0-alpha01 已发布。版本 1.0.0-alpha01 包含这些提交。

新功能

UWB 库为开发者提供了一组与支持 UWB 的设备交互的 API。用例将仅限于已采用 UWB 测距会话控制器配置文件的合作设备，并计划在不久的将来支持控制器配置文件。此初始版本包含两个顶级 API 接口：UwbManager 和 UwbClientSessionScope。