| /* | |
| * Copyright 2021 HIMSA II K/S - www.himsa.com. | |
| * Represented by EHIMA - www.ehima.com | |
| * | |
| * Licensed under the Apache License, Version 2.0 (the "License"); | |
| * you may not use this file except in compliance with the License. | |
| * You may obtain a copy of the License at | |
| * | |
| * http://www.apache.org/licenses/LICENSE-2.0 | |
| * | |
| * Unless required by applicable law or agreed to in writing, software | |
| * distributed under the License is distributed on an "AS IS" BASIS, | |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
| * See the License for the specific language governing permissions and | |
| * limitations under the License. | |
| */ | |
| package android.bluetooth; | |
| import static android.Manifest.permission.BLUETOOTH_CONNECT; | |
| import static android.Manifest.permission.BLUETOOTH_PRIVILEGED; | |
| import static android.bluetooth.BluetoothProfile.CONNECTION_POLICY_FORBIDDEN; | |
| import static android.bluetooth.BluetoothProfile.STATE_DISCONNECTED; | |
| import static android.bluetooth.BluetoothUtils.callServiceIfEnabled; | |
| import static android.bluetooth.BluetoothUtils.enforcePermissionInFramework; | |
| import static android.bluetooth.BluetoothUtils.executeFromBinder; | |
| import static java.util.Objects.requireNonNull; | |
| import android.annotation.CallbackExecutor; | |
| import android.annotation.Hide; | |
| import android.annotation.IntRange; | |
| import android.annotation.NonNull; | |
| import android.annotation.Nullable; | |
| import android.annotation.RequiresNoPermission; | |
| import android.annotation.RequiresPermission; | |
| import android.annotation.SdkConstant; | |
| import android.annotation.SdkConstant.SdkConstantType; | |
| import android.annotation.SuppressLint; | |
| import android.annotation.SystemApi; | |
| import android.bluetooth.annotations.RequiresBluetoothConnectPermission; | |
| import android.content.AttributionSource; | |
| import android.content.Context; | |
| import android.os.IBinder; | |
| import android.os.RemoteException; | |
| import android.util.CloseGuard; | |
| import android.util.Log; | |
| import com.android.internal.annotations.GuardedBy; | |
| import java.util.Arrays; | |
| import java.util.Collections; | |
| import java.util.HashMap; | |
| import java.util.List; | |
| import java.util.Map; | |
| import java.util.concurrent.Executor; | |
| import java.util.function.Consumer; | |
| /** | |
| * This class provides the public APIs to control the Bluetooth Volume Control service. | |
| * | |
| * <p>BluetoothVolumeControl is a proxy object for controlling the Bluetooth VC Service via IPC. Use | |
| * {@link BluetoothAdapter#getProfileProxy} to get the BluetoothVolumeControl proxy object. | |
| */ | |
| @Hide | |
| @SystemApi | |
| public final class BluetoothVolumeControl implements BluetoothProfile, AutoCloseable { | |
| private static final String TAG = BluetoothVolumeControl.class.getSimpleName(); | |
| private final CloseGuard mCloseGuard; | |
| private final Context mContext; | |
| @GuardedBy("mCallbackExecutorMap") | |
| private final Map<Callback, Executor> mCallbackExecutorMap = new HashMap<>(); | |
| /** | |
| * This class provides a callback that is invoked when volume offset value changes on the remote | |
| * device. | |
| * | |
| * <p>In order to balance volume on the group of Le Audio devices, Volume Offset Control Service | |
| * (VOCS) shall be used. User can verify if the remote device supports VOCS by calling {@link | |
| * #isVolumeOffsetAvailable(device)}. | |
| */ | |
| @Hide | |
| @SystemApi | |
| public interface Callback { | |
| /** | |
| * Callback invoked when callback is registered and when volume offset changes on the remote | |
| * device. Change can be triggered autonomously by the remote device or after volume offset | |
| * change on the user request done by calling {@link #setVolumeOffset(device, volumeOffset)} | |
| * | |
| * @param device remote device whose volume offset changed | |
| * @param volumeOffset latest volume offset for this device | |
| * @deprecated Use new callback which give information about a VOCS instance ID | |
| */ | |
| @Hide | |
| @Deprecated | |
| @SystemApi | |
| default void onVolumeOffsetChanged( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = -255, to = 255) int volumeOffset) {} | |
| /** | |
| * Callback invoked when callback is registered and when volume offset changes on the remote | |
| * device. Change can be triggered autonomously by the remote device or after volume offset | |
| * change on the user request done by calling {@link #setVolumeOffset(device, instanceId, | |
| * volumeOffset)} | |
| * | |
| * @param device remote device whose volume offset changed | |
| * @param instanceId identifier of VOCS instance on the remote device | |
| * @param volumeOffset latest volume offset for this VOCS instance | |
| */ | |
| @Hide | |
| @SystemApi | |
| default void onVolumeOffsetChanged( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = 1, to = 255) int instanceId, | |
| @IntRange(from = -255, to = 255) int volumeOffset) { | |
| if (instanceId == 1) { | |
| onVolumeOffsetChanged(device, volumeOffset); | |
| } | |
| } | |
| /** | |
| * Callback invoked when callback is registered and when audio location changes on the | |
| * remote device. Change can be triggered autonomously by the remote device. | |
| * | |
| * @param device remote device whose audio location changed | |
| * @param instanceId identifier of VOCS instance on the remote device | |
| * @param audioLocation latest audio location for this VOCS instance | |
| */ | |
| @Hide | |
| @SystemApi | |
| default void onVolumeOffsetAudioLocationChanged( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = 1, to = 255) int instanceId, | |
| @IntRange(from = -255, to = 255) int audioLocation) {} | |
| /** | |
| * Callback invoked when callback is registered and when audio description changes on the | |
| * remote device. Change can be triggered autonomously by the remote device. | |
| * | |
| * @param device remote device whose audio description changed | |
| * @param instanceId identifier of VOCS instance on the remote device | |
| * @param audioDescription latest audio description for this VOCS instance | |
| */ | |
| @Hide | |
| @SystemApi | |
| default void onVolumeOffsetAudioDescriptionChanged( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = 1, to = 255) int instanceId, | |
| @NonNull String audioDescription) {} | |
| /** | |
| * Callback for le audio connected device volume level change | |
| * | |
| * <p>The valid volume range is [0, 255], as defined in 2.3.1.1 Volume_Setting field of | |
| * Volume Control Service, Version 1.0. | |
| * | |
| * @param device remote device whose volume changed | |
| * @param volume level | |
| */ | |
| @Hide | |
| @SystemApi | |
| default void onDeviceVolumeChanged( | |
| @NonNull BluetoothDevice device, @IntRange(from = 0, to = 255) int volume) {} | |
| } | |
| private final IBluetoothVolumeControlCallback mCallback = | |
| new VolumeControlNotifyCallback(mCallbackExecutorMap); | |
| private class VolumeControlNotifyCallback extends IBluetoothVolumeControlCallback.Stub { | |
| private final Map<Callback, Executor> mCallbackMap; | |
| VolumeControlNotifyCallback(Map<Callback, Executor> callbackMap) { | |
| mCallbackMap = callbackMap; | |
| } | |
| private void forEach(Consumer<BluetoothVolumeControl.Callback> consumer) { | |
| synchronized (mCallbackMap) { | |
| mCallbackMap.forEach( | |
| (callback, executor) -> | |
| executeFromBinder(executor, () -> consumer.accept(callback))); | |
| } | |
| } | |
| @Override | |
| public void onVolumeOffsetChanged( | |
| @NonNull BluetoothDevice device, int instanceId, int volumeOffset) { | |
| Attributable.setAttributionSource(device, mAttributionSource); | |
| forEach((cb) -> cb.onVolumeOffsetChanged(device, instanceId, volumeOffset)); | |
| } | |
| @Override | |
| public void onVolumeOffsetAudioLocationChanged( | |
| @NonNull BluetoothDevice device, int instanceId, int audioLocation) { | |
| Attributable.setAttributionSource(device, mAttributionSource); | |
| forEach( | |
| (cb) -> | |
| cb.onVolumeOffsetAudioLocationChanged( | |
| device, instanceId, audioLocation)); | |
| } | |
| @Override | |
| public void onVolumeOffsetAudioDescriptionChanged( | |
| @NonNull BluetoothDevice device, int instanceId, String audioDescription) { | |
| Attributable.setAttributionSource(device, mAttributionSource); | |
| forEach( | |
| (cb) -> | |
| cb.onVolumeOffsetAudioDescriptionChanged( | |
| device, instanceId, audioDescription)); | |
| } | |
| @Override | |
| public void onDeviceVolumeChanged(@NonNull BluetoothDevice device, int volume) { | |
| Attributable.setAttributionSource(device, mAttributionSource); | |
| forEach((cb) -> cb.onDeviceVolumeChanged(device, volume)); | |
| } | |
| } | |
| /** | |
| * Intent used to broadcast the change in connection state of the Volume Control profile. | |
| * | |
| * <p>This intent will have 3 extras: | |
| * | |
| * <ul> | |
| * <li>{@link #EXTRA_STATE} - The current state of the profile. | |
| * <li>{@link #EXTRA_PREVIOUS_STATE}- The previous state of the profile. | |
| * <li>{@link BluetoothDevice#EXTRA_DEVICE} - The remote device. | |
| * </ul> | |
| * | |
| * <p>{@link #EXTRA_STATE} or {@link #EXTRA_PREVIOUS_STATE} can be any of {@link | |
| * #STATE_DISCONNECTED}, {@link #STATE_CONNECTING}, {@link #STATE_CONNECTED}, {@link | |
| * #STATE_DISCONNECTING}. | |
| */ | |
| @Hide | |
| @SystemApi | |
| @SuppressLint("ActionValue") | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(BLUETOOTH_CONNECT) | |
| @SdkConstant(SdkConstantType.BROADCAST_INTENT_ACTION) | |
| public static final String ACTION_CONNECTION_STATE_CHANGED = | |
| "android.bluetooth.volume-control.profile.action.CONNECTION_STATE_CHANGED"; | |
| private final BluetoothAdapter mAdapter; | |
| private final AttributionSource mAttributionSource; | |
| private IBluetoothVolumeControl mService; | |
| /** | |
| * Create a BluetoothVolumeControl proxy object for interacting with the local Bluetooth Volume | |
| * Control service. | |
| */ | |
| /*package*/ BluetoothVolumeControl(Context context, BluetoothAdapter adapter) { | |
| mAdapter = adapter; | |
| mContext = context; | |
| mAttributionSource = adapter.getAttributionSource(); | |
| mService = null; | |
| mCloseGuard = new CloseGuard(); | |
| mCloseGuard.open("close"); | |
| } | |
| @RequiresPermission(BLUETOOTH_PRIVILEGED) | |
| @SuppressWarnings("Finalize") // TODO(b/314811467) | |
| protected void finalize() { | |
| if (mCloseGuard != null) { | |
| mCloseGuard.warnIfOpen(); | |
| } | |
| close(); | |
| } | |
| /** {@inheritDoc} */ | |
| @Hide | |
| @Override | |
| @SystemApi | |
| public void close() { | |
| Log.v(TAG, "close()"); | |
| mAdapter.closeProfileProxy(this); | |
| } | |
| @Hide | |
| @Override | |
| @RequiresNoPermission | |
| public void onServiceConnected(IBinder service) { | |
| mService = IBluetoothVolumeControl.Stub.asInterface(service); | |
| // re-register the service-to-app callback | |
| synchronized (mCallbackExecutorMap) { | |
| if (mCallbackExecutorMap.isEmpty()) { | |
| return; | |
| } | |
| try { | |
| mService.registerCallback(mCallback, mAttributionSource); | |
| } catch (RemoteException e) { | |
| Log.e(TAG, "onBluetoothServiceUp: Failed to register VolumeControl callback", e); | |
| } | |
| } | |
| } | |
| @Hide | |
| @Override | |
| @RequiresNoPermission | |
| public void onServiceDisconnected() { | |
| mService = null; | |
| } | |
| private IBluetoothVolumeControl getService() { | |
| return mService; | |
| } | |
| @Hide | |
| @Override | |
| @RequiresNoPermission | |
| public BluetoothAdapter getAdapter() { | |
| return mAdapter; | |
| } | |
| /** | |
| * Get the list of connected devices. Currently at most one. | |
| * | |
| * @return list of connected devices | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public @NonNull List<BluetoothDevice> getConnectedDevices() { | |
| Log.d(TAG, "getConnectedDevices()"); | |
| List<BluetoothDevice> defaultValue = Collections.emptyList(); | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> | |
| Attributable.setAttributionSource( | |
| s.getConnectedDevices(mAttributionSource), mAttributionSource), | |
| defaultValue); | |
| } | |
| /** {@inheritDoc} */ | |
| @Hide | |
| @Override | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public List<BluetoothDevice> getDevicesMatchingConnectionStates(int[] states) { | |
| Log.d(TAG, "getDevicesMatchingStates(" + Arrays.toString(states) + ")"); | |
| List<BluetoothDevice> defaultValue = Collections.emptyList(); | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> | |
| Attributable.setAttributionSource( | |
| s.getDevicesMatchingConnectionStates(states, mAttributionSource), | |
| mAttributionSource), | |
| defaultValue); | |
| } | |
| /** {@inheritDoc} */ | |
| @Hide | |
| @Override | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(BLUETOOTH_CONNECT) | |
| public int getConnectionState(BluetoothDevice device) { | |
| int defaultValue = STATE_DISCONNECTED; | |
| if (!isValidDevice(device)) { | |
| return defaultValue; | |
| } | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.getConnectionState(device, mAttributionSource), | |
| defaultValue); | |
| } | |
| /** | |
| * Register a {@link Callback} that will be invoked during the operation of this profile. | |
| * | |
| * <p>Repeated registration of the same <var>callback</var> object after the first call to this | |
| * method will result with IllegalArgumentException being thrown, even when the | |
| * <var>executor</var> is different. API caller must call {@link #unregisterCallback(Callback)} | |
| * with the same callback object before registering it again. | |
| * | |
| * @param executor an {@link Executor} to execute given callback | |
| * @param callback user implementation of the {@link Callback} | |
| * @throws NullPointerException if a null executor, or callback is given, or | |
| * IllegalArgumentException if the same <var>callback<var> is already registered. | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public void registerCallback( | |
| @NonNull @CallbackExecutor Executor executor, @NonNull Callback callback) { | |
| requireNonNull(executor); | |
| requireNonNull(callback); | |
| Log.d(TAG, "registerCallback"); | |
| enforcePermissionInFramework(mContext, BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED); | |
| synchronized (mCallbackExecutorMap) { | |
| if (!mAdapter.isEnabled()) { | |
| /* If Bluetooth is off, just store callback and it will be registered | |
| * when Bluetooth is on | |
| */ | |
| mCallbackExecutorMap.put(callback, executor); | |
| return; | |
| } | |
| // Adds the passed in callback to our map of callbacks to executors | |
| if (mCallbackExecutorMap.containsKey(callback)) { | |
| throw new IllegalArgumentException("This callback has already been registered"); | |
| } | |
| final IBluetoothVolumeControl service = getService(); | |
| if (service == null) { | |
| return; | |
| } | |
| try { | |
| /* If the callback map is empty, we register the service-to-app callback. | |
| * Otherwise, callback is registered in mCallbackExecutorMap and we just notify | |
| * user over callback with current values. | |
| */ | |
| boolean isRegisterCallbackRequired = mCallbackExecutorMap.isEmpty(); | |
| mCallbackExecutorMap.put(callback, executor); | |
| if (isRegisterCallbackRequired) { | |
| service.registerCallback(mCallback, mAttributionSource); | |
| } else { | |
| service.notifyNewRegisteredCallback( | |
| new VolumeControlNotifyCallback(Map.of(callback, executor)), | |
| mAttributionSource); | |
| } | |
| } catch (RemoteException e) { | |
| Log.e(TAG, e.toString() + "\n" + Log.getStackTraceString(new Throwable())); | |
| } | |
| } | |
| } | |
| /** | |
| * Unregister the specified {@link Callback}. | |
| * | |
| * <p>The same {@link Callback} object used when calling {@link #registerCallback(Executor, | |
| * Callback)} must be used. | |
| * | |
| * <p>Callbacks are automatically unregistered when the application process goes away | |
| * | |
| * @param callback user implementation of the {@link Callback} | |
| * @throws IllegalArgumentException when callback is null or when no callback is registered | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public void unregisterCallback(@NonNull Callback callback) { | |
| requireNonNull(callback); | |
| Log.d(TAG, "unregisterCallback"); | |
| enforcePermissionInFramework(mContext, BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED); | |
| synchronized (mCallbackExecutorMap) { | |
| if (mCallbackExecutorMap.remove(callback) == null) { | |
| throw new IllegalArgumentException("This callback has not been registered"); | |
| } | |
| if (!mCallbackExecutorMap.isEmpty()) { | |
| return; | |
| } | |
| } | |
| // If the callback map is empty, we unregister the service-to-app callback | |
| try { | |
| final IBluetoothVolumeControl service = getService(); | |
| if (service != null) { | |
| service.unregisterCallback(mCallback, mAttributionSource); | |
| } | |
| } catch (IllegalStateException | RemoteException e) { | |
| Log.e(TAG, e.toString() + "\n" + Log.getStackTraceString(new Throwable())); | |
| } | |
| } | |
| /** | |
| * Tells the remote device to set a volume offset to the absolute volume. | |
| * | |
| * @param device {@link BluetoothDevice} representing the remote device | |
| * @param volumeOffset volume offset to be set on the remote device | |
| * @deprecated Use new method which allows for choosing a VOCS instance. This method will always | |
| * use the first instance. | |
| */ | |
| @Hide | |
| @Deprecated | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public void setVolumeOffset( | |
| @NonNull BluetoothDevice device, @IntRange(from = -255, to = 255) int volumeOffset) { | |
| final int defaultInstanceId = 1; | |
| setVolumeOffsetInternal(device, defaultInstanceId, volumeOffset); | |
| } | |
| /** | |
| * Tells the remote device to set a volume offset to the absolute volume. One device might have | |
| * multiple VOCS instances. This instances could be i.e. different speakers or sound types as | |
| * media/voice/notification. | |
| * | |
| * @param device {@link BluetoothDevice} representing the remote device | |
| * @param instanceId identifier of VOCS instance on the remote device. Identifiers are numerated | |
| * from 1. Number of them was notified by callbacks and it can be read using {@link | |
| * #getNumberOfVolumeOffsetInstances(BluetoothDevice)}. Providing non existing instance ID | |
| * will be ignored | |
| * @param volumeOffset volume offset to be set on VOCS instance | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public void setVolumeOffset( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = 1, to = 255) int instanceId, | |
| @IntRange(from = -255, to = 255) int volumeOffset) { | |
| setVolumeOffsetInternal(device, instanceId, volumeOffset); | |
| } | |
| /** | |
| * INTERNAL HELPER METHOD, DO NOT MAKE PUBLIC | |
| * | |
| * <p>Tells the remote device to set a volume offset to the absolute volume. One device might | |
| * have multiple VOCS instances. This instances could be i.e. different speakers or sound types | |
| * as media/voice/notification. | |
| * | |
| * @param device {@link BluetoothDevice} representing the remote device | |
| * @param instanceId identifier of VOCS instance on the remote device. Identifiers are numerated | |
| * from 1. Number of them was notified by callbacks and it can be read using {@link | |
| * #getNumberOfVolumeOffsetInstances(BluetoothDevice)}. Providing non existing instance ID | |
| * will be ignored | |
| * @param volumeOffset volume offset to be set on VOCS instance | |
| */ | |
| @Hide | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| private void setVolumeOffsetInternal( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = 1, to = 255) int instanceId, | |
| @IntRange(from = -255, to = 255) int volumeOffset) { | |
| Log.d(TAG, "setVolumeOffset(" + device + ", " + instanceId + ", " + volumeOffset + ")"); | |
| requireNonNull(device); | |
| if (!isValidDevice(device)) { | |
| return; | |
| } | |
| enforcePermissionInFramework(mContext, BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED); | |
| callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.setVolumeOffset(device, instanceId, volumeOffset, mAttributionSource)); | |
| } | |
| /** | |
| * Provides information about the possibility to set volume offset on the remote device. If the | |
| * remote device supports Volume Offset Control Service, it is automatically connected. | |
| * | |
| * @param device {@link BluetoothDevice} representing the remote device | |
| * @return {@code true} if volume offset function is supported and available to use on the | |
| * remote device. When Bluetooth is off, the return value should always be {@code false}. | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public boolean isVolumeOffsetAvailable(@NonNull BluetoothDevice device) { | |
| Log.d(TAG, "isVolumeOffsetAvailable(" + device + ")"); | |
| final boolean defaultValue = false; | |
| requireNonNull(device); | |
| if (!isValidDevice(device)) { | |
| return defaultValue; | |
| } | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.isVolumeOffsetAvailable(device, mAttributionSource), | |
| defaultValue); | |
| } | |
| /** | |
| * Provides information about the number of volume offset instances | |
| * | |
| * @param device {@link BluetoothDevice} representing the remote device | |
| * @return number of VOCS instances. When Bluetooth is off, the return value is 0. | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public int getNumberOfVolumeOffsetInstances(@NonNull BluetoothDevice device) { | |
| Log.d(TAG, "getNumberOfVolumeOffsetInstances(" + device + ")"); | |
| final int defaultValue = 0; | |
| requireNonNull(device); | |
| if (!isValidDevice(device)) { | |
| return defaultValue; | |
| } | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.getNumberOfVolumeOffsetInstances(device, mAttributionSource), | |
| defaultValue); | |
| } | |
| /** | |
| * Set connection policy of the profile | |
| * | |
| * <p>The device should already be paired. Connection policy can be one of {@link | |
| * #CONNECTION_POLICY_ALLOWED}, {@link #CONNECTION_POLICY_FORBIDDEN}, {@link | |
| * #CONNECTION_POLICY_UNKNOWN} | |
| * | |
| * @param device Paired bluetooth device | |
| * @param connectionPolicy is the connection policy to set to for this profile | |
| * @return true if connectionPolicy is set, false on error | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public boolean setConnectionPolicy( | |
| @NonNull BluetoothDevice device, @ConnectionPolicy int connectionPolicy) { | |
| Log.d(TAG, "setConnectionPolicy(" + device + ", " + connectionPolicy + ")"); | |
| boolean defaultValue = false; | |
| if (isValidDevice(device) && BluetoothProfile.isValidConnectionPolicy(connectionPolicy)) { | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.setConnectionPolicy(device, connectionPolicy, mAttributionSource), | |
| defaultValue); | |
| } | |
| return defaultValue; | |
| } | |
| /** | |
| * Get the connection policy of the profile. | |
| * | |
| * @param device Bluetooth device | |
| * @return connection policy of the device | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public @ConnectionPolicy int getConnectionPolicy(@NonNull BluetoothDevice device) { | |
| Log.v(TAG, "getConnectionPolicy(" + device + ")"); | |
| int defaultValue = CONNECTION_POLICY_FORBIDDEN; | |
| if (!isValidDevice(device)) { | |
| return defaultValue; | |
| } | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.getConnectionPolicy(device, mAttributionSource), | |
| defaultValue); | |
| } | |
| /** | |
| * Set volume for the le audio device | |
| * | |
| * <p>This provides volume control for connected remote device directly by volume control | |
| * service. The valid volume range is [0, 255], as defined in 2.3.1.1 Volume_Setting field of | |
| * Volume Control Service, Version 1.0. | |
| * | |
| * <p>For le audio unicast devices volume control, application should consider to use {@link | |
| * BluetoothLeAudio#setVolume} instead to control active device volume. | |
| * | |
| * @param device {@link BluetoothDevice} representing the remote device | |
| * @param volume level to set | |
| * @param isGroupOperation {@code true} if Application wants to perform this operation for all | |
| * coordinated set members throughout this session. Otherwise, caller would have to control | |
| * individual device volume. | |
| * @throws IllegalArgumentException if volume is not in the range [0, 255]. | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public void setDeviceVolume( | |
| @NonNull BluetoothDevice device, | |
| @IntRange(from = 0, to = 255) int volume, | |
| boolean isGroupOperation) { | |
| requireNonNull(device); | |
| if (!isValidDevice(device)) { | |
| return; | |
| } | |
| if (volume < 0 || volume > 255) { | |
| throw new IllegalArgumentException("illegal volume " + volume); | |
| } | |
| enforcePermissionInFramework(mContext, BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED); | |
| callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> s.setDeviceVolume(device, volume, isGroupOperation, mAttributionSource)); | |
| } | |
| /** | |
| * Returns a list of {@link AudioInputControl} objects associated with a Bluetooth device. | |
| * | |
| * <p>Each {@link AudioInputControl} object represents an instance of the Audio Input Control | |
| * Service (AICS) on the remote device. A device may have multiple instances of the AICS, as | |
| * described in the <a href="https://www.bluetooth.com/specifications/specs/aics-1-0/">Audio | |
| * Input Control Service Specification (AICS 1.0)</a>. | |
| * | |
| * @param device The remote Bluetooth device. | |
| * @return A list of {@link AudioInputControl} objects, or an empty list if no AICS instances | |
| * are found or if an error occurs. | |
| * @throws IllegalArgumentException If the provided device is invalid. | |
| */ | |
| @Hide | |
| @SystemApi | |
| @RequiresBluetoothConnectPermission | |
| @RequiresPermission(allOf = {BLUETOOTH_CONNECT, BLUETOOTH_PRIVILEGED}) | |
| public @NonNull List<AudioInputControl> getAudioInputControlServices( | |
| @NonNull BluetoothDevice device) { | |
| requireNonNull(device); | |
| Log.d(TAG, "getAudioInputControlServices(" + device + ")"); | |
| if (!isValidDevice(device)) { | |
| throw new IllegalArgumentException("Invalid device " + device); | |
| } | |
| return callServiceIfEnabled( | |
| mAdapter, | |
| this::getService, | |
| s -> | |
| AudioInputControl.getAudioInputControlServices( | |
| mContext, s, mAttributionSource, device), | |
| Collections.emptyList()); | |
| } | |
| private static boolean isValidDevice(@Nullable BluetoothDevice device) { | |
| return device != null && BluetoothAdapter.checkBluetoothAddress(device.getAddress()); | |
| } | |
| } |