蓝牙

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

声明依赖项

要添加对蓝牙的依赖项，您必须将 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)(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)

错误修复

版本 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 表面，清晰的线程模型（包含异步和同步操作），并确保所有方法都被执行并提供结果。