Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update BluetoothAdapter and BluetoothDevice documentation

Browse Source 
Update BluetoothAdapter#startDiscovery and
BluetoothDevice#fetchUuidsWithSdp documentation to
indicate that it queues the request if a device is
currently bonding

Tag: #feature
Bug: 187165224
Test: Manual
Change-Id: I3dbcdacff062f6c33c2fdc8d64170bf60b2fbf6f
This commit is contained in:
Rahul Sabnis
2021-05-19 21:18:59 -07:00
committed by Etienne Ruffieux
parent da9b4de8f0
commit d748e6ec7a
2 changed files with 6 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
core/java/android/bluetooth/BluetoothAdapter.java
View File

@@ -1698,9 +1698,10 @@ public final class BluetoothAdapter {
* <i>discoverable</i> (inquiry scan enabled). Many Bluetooth devices are
* not discoverable by default, and need to be entered into a special mode.
* <p>If Bluetooth state is not {@link #STATE_ON}, this API
* will return false. After turning on Bluetooth,
* wait for {@link #ACTION_STATE_CHANGED} with {@link #STATE_ON}
* to get the updated value.
* will return false. After turning on Bluetooth, wait for {@link #ACTION_STATE_CHANGED}
* with {@link #STATE_ON} to get the updated value.
* <p>If a device is currently bonding, this request will be queued and executed once that
* device has finished bonding. If a request is already queued, this request will be ignored.
*
* @return true on success, false on error
*/

3
core/java/android/bluetooth/BluetoothDevice.java
View File

@@ -1608,7 +1608,8 @@ public final class BluetoothDevice implements Parcelable {
* in getting the SDP records or if the process takes a long time, or the device is bonding and
* we have its UUIDs cached, {@link #ACTION_UUID} intent is sent with the UUIDs that is
* currently present in the cache. Clients should use the {@link #getUuids} to get UUIDs
* if service discovery is not to be performed.
* if service discovery is not to be performed. If there is an ongoing bonding process,
* service discovery or device inquiry, the request will be queued.
*
* @return False if the check fails, True if the process of initiating an ACL connection
* to the remote device was started or cached UUIDs will be broadcast.