Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit ea54b75c authored by Rahul Sabnis's avatar Rahul Sabnis
Browse files

Updating docs for BluetoothDevice#disconnect as-per API council feedback 

Tag: #feature
Bug: 202102309
Test: Manual
Ignore-AOSP-First: Original change is only in internal branches
Change-Id: I9afe1e4701690bed0f27fba912abd5e696030878
parent 6c5e19d9

framework/java/android/bluetooth/BluetoothDevice.java

+6 −2
Original line number Diff line number Diff line
@@ -2002,10 +2002,14 @@ public final class BluetoothDevice implements Parcelable, Attributable { 


    /**

     * Disconnects all connected bluetooth profiles between the local and remote device.

     * Disconnection is asynchronous and you should listen to each profile's broadcast intent

     * Disconnection is asynchronous, so you should listen to each profile's broadcast intent

     * ACTION_CONNECTION_STATE_CHANGED to verify whether disconnection was successful. For example,

     * to verify a2dp is disconnected, you would listen for

     * {@link BluetoothA2dp#ACTION_CONNECTION_STATE_CHANGED}

     * {@link BluetoothA2dp#ACTION_CONNECTION_STATE_CHANGED}. Once all profiles have disconnected,

     * the ACL link should come down and {@link #ACTION_ACL_DISCONNECTED} should be broadcast.

     * <p>

     * In the rare event that one or more profiles fail to disconnect, call this method again to

     * send another request to disconnect each connected profile.

     *

     * @return whether the messages were successfully sent to try to disconnect all profiles

     * @throws IllegalArgumentException if the device address is invalid