蓝牙

  
将 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")
}

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

反馈

您的反馈将帮助我们改进 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)
  • 将 serviceData 和 serviceSolicitationUuids 添加到了 ScanResult (I6d7f0)
  • 将 durationMillis 从 Long 更改为 Duration (I89d49)
  • 向 ScanResult 添加了 rssi 和 periodicAdvertisingInterval (I60b51)
  • 将 serviceSolicitationUuid 和 solicitationUuidMask 添加到了 ScanFilter (Ic2206)
  • 添加了 GattServerSessionScope#subscribedCharacteristics (I0edab)
  • 向 AdvertiseParams 添加了 serviceSolicitationUuids (Ic9aa7)
  • 将 AdvertiseParams.durationMillis 从 Int 更改为 Long (I6873f)
  • GattServerSessionScope#notify 不会返回，但如果失败会抛出异常 (Ifc26f)

bug 修复

版本 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 Surface，涵盖蓝牙 LE 扫描和广告以及 GATT 客户端和服务器用例。它提供了极小的 API Surface、带有异步和同步操作的清晰线程模型，并确保所有方法都能得到执行并提供结果。