API-REVIEW: add detail in codec switch javadoc

Fix: 222434921
Test: no test for doc
Tag: #refactor
Change-Id: Icc11f11cdb95f71705c7c82b69bc957b86fedfd4

1 files changed, 9 insertions, 1 deletions

diff --git a/framework/java/android/bluetooth/BluetoothA2dp.java b/framework/java/android/bluetooth/BluetoothA2dp.java
index 6c15925d53..1d18b70acb 100644
--- a/framework/java/android/bluetooth/BluetoothA2dp.java
+++ b/framework/java/android/bluetooth/BluetoothA2dp.java
@@ -839,6 +839,10 @@ public final class BluetoothA2dp implements BluetoothProfile {
      *
      * If the given device supports another codec type than
      * {@link BluetoothCodecConfig.SOURCE_CODEC_TYPE_SBC}, this will switch to it.
+     * Switching from one codec to another will create a short audio drop.
+     * In case of multiple applications calling the method, the last call will be taken into
+     * account, overriding any previous call
+     *
      * See {@link #setOptionalCodecsEnabled} to enable optional codecs by default
      * when the given device is connected.
      *
@@ -856,10 +860,14 @@ public final class BluetoothA2dp implements BluetoothProfile {
     }
 
     /**
-     * Disables the optional codecs for the given device.
+     * Disables the optional codecs for the given device for this connection.
      *
      * When optional codecs are disabled, the device will use the default
      * Bluetooth audio codec type.
+     * Switching from one codec to another will create a short audio drop.
+     * In case of multiple applications calling the method, the last call will be taken into
+     * account, overriding any previous call
+     *
      * See {@link BluetoothCodecConfig.SOURCE_CODEC_TYPE_SBC}.
      * See {@link #setOptionalCodecsEnabled} to disable optional codecs by default
      * when the given device is connected.