蓝牙

  
使用 Android 平台的蓝牙功能和向后兼容的 API。
最新更新 稳定版 候选版本 Beta 版 Alpha 版
2023 年 11 月 29 日 - - - 1.0.0-alpha02

声明依赖项

要添加对 Bluetooth 的依赖项，您必须将 Google Maven 存储库添加到您的项目中。阅读Google 的 Maven 存储库以了解更多信息。

在应用或模块的 build.gradle 文件中添加所需工件的依赖项

Groovy

dependencies {
    
    implementation "androidx.bluetooth:bluetooth:1.0.0-alpha02"
}

Kotlin

dependencies {
    
    implementation("androidx.bluetooth:bluetooth:1.0.0-alpha02")
}

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

反馈

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

创建新问题

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

此工件没有发行说明。

版本 1.0

版本 1.0.0-alpha02

2023 年 11 月 29 日

androidx.bluetooth:bluetooth:1.0.0-alpha02 和 androidx.bluetooth:bluetooth-testing:1.0.0-alpha02 已发布。 版本 1.0.0-alpha02 包含这些提交。

新功能

  • 将 minSdkVersion 降低到 21

API 更改

  • GattServerConnectFlow#updateServices 成为一个挂起函数 (I0237d)

  • 将 AdvertiseParams.durationMillis 更改为 Long 类型（If6771）
  • 将 openGattServer 转换为 Flow 类型（Icef54）
  • 扫描失败时抛出 ScanException 异常，并将扫描程序的 setLegacy(false) 属性默认为 false（Ib337c）
  • 广告发布失败时抛出 AdvertiseException 异常（I0e691）
  • 添加通用蓝牙异常捕获（I0130d）
  • 将广告发布转换为 Flow 类型并更改最大持续时间（I32fd8）
  • 在 ScanResult 中添加 serviceData 和 serviceSolicitationUuids 属性（I6d7f0）
  • 将 durationMillis 的类型从 Long 更改为 Duration（I89d49）
  • 在 ScanResult 中添加 rssi 和 periodicAdvertisingInterval 属性（I60b51）
  • 在 ScanFilter 中添加 serviceSolicitationUuid 和 solicitationUuidMask 属性（Ic2206）
  • 添加了 GattServerSessionScope#subscribedCharacteristics 属性（I0edab）
  • 在 AdvertiseParams 中添加 serviceSolicitationUuids 属性（Ic9aa7）
  • 将 AdvertiseParams.durationMillis 的类型从 Int 更改为 Long（I6873f）
  • GattServerSessionScope#notify 方法不再返回结果，如果失败则抛出异常（Ifc26f）

错误修复

  • 提取扫描功能（I4d43f）

版本 1.0.0-alpha01

2023年9月20日

androidx.bluetooth:bluetooth:1.0.0-alpha01 和 androidx.bluetooth:bluetooth-testing:1.0.0-alpha01 已发布。版本 1.0.0-alpha01 包含这些提交。

新功能

  • 这是 AndroidX Bluetooth API 的初始版本，它提供了一个 Kotlin API 表面，涵盖了蓝牙 LE 扫描和广告以及 GATT 客户端和服务器用例。它提供了一个最小的 API 表面、清晰的线程模型（包含异步和同步操作），并确保所有方法都能执行并提供结果。