このページは Cloud Translation API によって翻訳されました。

Bluetooth

API リファレンス
androidx.bluetooth

下位互換性のある API で Android プラットフォームの Bluetooth 機能を使用します。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
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 に含まれる commit については、こちらをご覧ください。

新機能

minSdkVersion を 21 に下げる

API の変更

GattServerConnectFlow#updateServices が suspend 関数になりました。（I0237d）
AdvertiseParams.durationMillis を Long に変更（If6771）
openGattServer をフローに変換（Icef54）
スキャン失敗時に ScanException をスローし、デフォルトでスキャナを setLegacy(false) に設定（Ib337c）
広告掲載の失敗時に AdvertiseException をスローします。（I0e691）
キャッチする一般的な Bluetooth 例外を追加しました。（I0130d）
広告をフローに変換し、最大再生時間を変更（I32fd8）
serviceData と serviceSolicitationUuids を ScanResult に追加しました。（I6d7f0）
durationMillis を「Long」から「Duration」に変更しました。（I89d49）
rssi と periodicAdvertisingInterval を ScanResult に追加しました。（I60b51）
serviceSolicitationUuid と solicitationUuidMask を ScanFilter に追加しました。（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 に含まれる commit については、こちらをご覧ください。

新機能

これは、Bluetooth LE スキャンとアドバタイズ、GATT クライアントとサーバーのユースケースをカバーする Kotlin API サーフェスを提供する AndroidX Bluetooth API の初回リリースです。最小限の API サーフェスと、非同期オペレーションと同期オペレーションを備えた明確なスレッドモデルを提供し、すべてのメソッドが実行され、結果が提供されるようにします。