藍牙
搭配回溯相容的 API 使用 Android 平台的藍牙功能。
最近更新時間 | 穩定版 | 候選版 | 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。如果您發現新問題,或是有改進這個程式庫的建議,請告訴我們。回報新問題前,請先查看這個程式庫的現有問題。只要按一下星號按鈕,即可投票給現有的問題。
詳情請參閱 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
轉換為資料流 (Icef54) - 掃描失敗時擲回
ScanException
,並預設掃描器為setLegacy(false)
(Ib337c) - 導致廣告失敗並擲回
AdvertiseException
(I0e691) - 新增一般藍牙例外狀況,以便擷取 (I0130d)
- 將廣告轉換為 Flow,並變更時間長度上限 (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)
修正錯誤
- 擷取掃描功能 (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 介面、具有非同步和同步處理作業的清晰執行緒模型,並確保所有方法都能執行並提供結果。