此页面由 Cloud Translation API 翻译。

Core 超宽带 (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-alpha08"
}

Kotlin

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

如需详细了解依赖项，请参阅添加 build 依赖项。

反馈

您的反馈将帮助我们改进 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)
向 UWB 状态更改事件的监听器添加了新 API subscribeToUwbAvailability(observer: UwbAvailabilityCallback) 和 unsubscribeFromUwbAvailability()。添加了新接口 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 中包含这些提交内容。

bug 修复

修复了当中国设备安装了 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 文件和实验性 API 文件（I8cfee、b/278769092）
无，API 文件更改只是重新排列方法 (I5fa95)
迁移了 androidx.core 组以使用合并的公共 API 文件（Ifdef4、b/278769092）
将 minRangingInterval、supportedChannels 和 supportedConfigIds 添加到 rangingCapabilities 中作为新字段。(I2a204)

bug 修复

修复了无法在非 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)

bug 修复

修复了导致用户无法并行启动多个测距会话的 bug。

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

新功能

推出了新的测距配置文件“控制器”。具有控制器配置文件的 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 库提供了一组 API，供开发者与支持 UWB 的设备交互。该用例仅适用于相应合作伙伴的设备，这些设备已采用 UWB 范围会话的控制器配置文件，并且计划不久后还会支持控制器配置文件。该初始版本包含两个顶级 API Surface UwbManager 和 UwbClientSessionScope。