藍牙

  
使用 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。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

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)
  • 將廣告轉換為流程並變更時間長度上限 (I32fd8)
  • 將 serviceData 和 serviceSolicitationUuids 新增至 ScanResult (I6d7f0)
  • 將 durationMillis 從 Long 變更為 Duration (I89d49)
  • 將 rssi 和 periodicAdvertisingInterval 新增至 ScanResult (I60b51)
  • 將 serviceSolicitationUuid 和 solicitationUuidMask 新增至 ScanFilter (Ic2206)
  • 新增了 GattServerSessionScope#subscribedCharacteristics (I0edab)
  • 將 serviceSolicitationUuids 新增至 AdvertiseParams (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 介面，涵蓋 Bluetooth LE 掃描和廣告，以及 GATT 用戶端和伺服器用途。它提供最少的 API 介面、具有非同步和同步作業的明確執行緒模型，並確保所有方法都會執行並提供結果。