Package org.robolectric.shadows

Class ShadowAudioManager

java.lang.Object

org.robolectric.shadows.ShadowAudioManager

@Implements(android.media.AudioManager.class)
public class ShadowAudioManager
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ShadowAudioManager.AudioFocusRequest

Field Summary

Fields

Modifier and Type	Field	Description
static final com.google.common.collect.ImmutableList<Integer>	ALL_STREAMS
static final int	DEFAULT_MAX_VOLUME
static final int	DEFAULT_VOLUME
static final int	FLAG_NO_ACTION
static final int	INVALID_VOLUME
static final int	MAX_VOLUME_MUSIC_DTMF
static final int	MIN_VOLUME

Constructor Summary

Constructors

Constructor	Description
ShadowAudioManager()

Method Summary

Modifier and Type	Method	Description
protected int	abandonAudioFocus(AudioManager.OnAudioFocusChangeListener l)
protected int	abandonAudioFocusRequest(AudioFocusRequest audioFocusRequest)	Provides a mock like interface for the abandonAudioFocusRequest method by storing the request object for later inspection and returning the value specified in setNextFocusRequestResponse.
void	addAvailableCommunicationDevice(AudioDeviceInfo communicationDevice, boolean notifyAudioDeviceCallbacks)	Adds an available communication AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was not present before and indicated by notifyAudioDeviceCallbacks.
void	addInputDevice(AudioDeviceInfo inputDevice, boolean notifyAudioDeviceCallbacks)	Adds an input AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was not present before and indicated by notifyAudioDeviceCallbacks.
protected void	addOnCommunicationDeviceChangedListener(Executor executor, AudioManager.OnCommunicationDeviceChangedListener listener)	Registers a AudioManager.OnCommunicationDeviceChangedListener that can later be called with callOnCommunicationDeviceChangedListeners(android.media.AudioDeviceInfo).
void	addOutputDevice(AudioDeviceInfo outputDevice, boolean notifyAudioDeviceCallbacks)	Adds an output AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was not present before and indicated by notifyAudioDeviceCallbacks.
void	addOutputDeviceWithDirectProfiles(AudioDeviceInfo outputDevice)	Adds an output device with direct profiles and notifies the list of AudioDeviceCallback if the device was not present before.
protected void	adjustStreamVolume(int streamType, int direction, int flags)	Implements AudioManager.adjustStreamVolume(int, int, int).
void	callOnCommunicationDeviceChangedListeners(AudioDeviceInfo device)	Calls the AudioManager.OnCommunicationDeviceChangedListener.onCommunicationDeviceChanged(android.media.AudioDeviceInfo) method on all registered AudioManager.OnCommunicationDeviceChangedListener, using their registered executors, with the provided AudioDeviceInfo as argument.
protected void	clearCommunicationDevice()
void	clearDispatchedMediaKeyEvents()
AudioRecordingConfiguration	createActiveRecordingConfiguration(int sessionId, int audioSource, String clientPackageName)	Creates simple active recording configuration.
protected AudioPlaybackConfiguration	createAudioPlaybackConfiguration(AudioAttributes audioAttributes)
protected void	dispatchMediaKeyEvent(KeyEvent keyEvent)	Sends a simulated key event for a media button.
protected int	generateAudioSessionId()	Provides a mock like interface for the AudioManager.generateAudioSessionId() method by returning positive distinct values, or AudioManager.ERROR if all possible values have already been returned.
protected List<AudioPlaybackConfiguration>	getActivePlaybackConfigurations()
protected List<AudioRecordingConfiguration>	getActiveRecordingConfigurations()	Returns list of active recording configurations that was set by setActiveRecordingConfigurations(java.util.List<android.media.AudioRecordingConfiguration>, boolean) or empty list otherwise.
protected List<AudioDeviceInfo>	getAudioDevicesForAttributes(AudioAttributes attributes)	Returns the audio devices that would be used for the routing of the given audio attributes.
protected List<AudioDeviceInfo>	getAvailableCommunicationDevices()
protected AudioDeviceInfo	getCommunicationDevice()
AudioDeviceInfo[]	getDevices(int flags)
protected List<?>	getDevicesForAttributes(AudioAttributes attributes)	Returns the devices associated with the given audio stream.
protected List<AudioProfile>	getDirectProfilesForAttributes(AudioAttributes attributes)	Returns the list of profiles supported for direct playback.
List<KeyEvent>	getDispatchedMediaKeyEvents()
AudioManager.OnAudioFocusChangeListener	getLastAbandonedAudioFocusListener()
AudioFocusRequest	getLastAbandonedAudioFocusRequest()
ShadowAudioManager.AudioFocusRequest	getLastAudioFocusRequest()
protected int	getMode()
String	getParameter(String key)	Returns a single parameter that was set via setParameters(String).
protected String	getParameters(String keys)	The expected composition for keys is not well defined.
protected int	getRingerMode()
protected int	getStreamMaxVolume(int streamType)
protected int	getStreamVolume(int streamType)
protected float	getStreamVolumeDb(int streamType, int index, int deviceType)
boolean	isAnyAudioPolicyRegistered()	Returns true if at least one audio policy is registered with this manager, and false otherwise.
protected boolean	isBluetoothA2dpOn()
protected boolean	isBluetoothScoAvailableOffCall()
protected boolean	isBluetoothScoOn()
protected boolean	isHotwordStreamSupported(boolean lookbackAudio)
protected boolean	isMicrophoneMute()
protected boolean	isMusicActive()
protected boolean	isSpeakerphoneOn()
protected boolean	isStreamMute(int streamType)
static boolean	isValidRingerMode(int ringerMode)
protected boolean	isWiredHeadsetOn()
void	lockCommunicationDevice(boolean lockCommunicationDevice)	Sets whether subsequent calls to setCommunicationDevice(android.media.AudioDeviceInfo) will succeed.
void	lockMode(boolean lockMode)	Sets whether subsequent calls to setMode(int) will succeed or not.
protected void	registerAudioDeviceCallback(AudioDeviceCallback callback, Handler handler)	Registers an AudioDeviceCallback object to receive notifications of changes to the set of connected audio devices.
protected void	registerAudioPlaybackCallback(AudioManager.AudioPlaybackCallback cb, Handler handler)	Registers callback that will receive changes made to the list of active playback configurations by setActivePlaybackConfigurationsFor(java.util.List<android.media.AudioAttributes>).
protected int	registerAudioPolicy(Object audioPolicy)	Registers an AudioPolicy to allow that policy to control audio routing and audio focus.
protected void	registerAudioRecordingCallback(AudioManager.AudioRecordingCallback cb, Handler handler)	Registers callback that will receive changes made to the list of active recording configurations by setActiveRecordingConfigurations(java.util.List<android.media.AudioRecordingConfiguration>,boolean).
void	removeAvailableCommunicationDevice(AudioDeviceInfo communicationDevice, boolean notifyAudioDeviceCallbacks)	Removes an available communication AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was present before and indicated by notifyAudioDeviceCallbacks.
void	removeInputDevice(AudioDeviceInfo inputDevice, boolean notifyAudioDeviceCallbacks)	Removes an input AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was present before and indicated by notifyAudioDeviceCallbacks.
protected void	removeOnCommunicationDeviceChangedListener(AudioManager.OnCommunicationDeviceChangedListener listener)	Unregisters a previously registered AudioManager.OnCommunicationDeviceChangedListener.
void	removeOutputDevice(AudioDeviceInfo outputDevice, boolean notifyAudioDeviceCallbacks)	Removes an output AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was present before and indicated by notifyAudioDeviceCallbacks.
void	removeOutputDeviceWithDirectProfiles(AudioDeviceInfo outputDevice)	Removes an output device with direct profiles and notifies the list of AudioDeviceCallback if the device was present before.
protected int	requestAudioFocus(AudioFocusRequest audioFocusRequest)	Provides a mock like interface for the requestAudioFocus method by storing the request object for later inspection and returning the value specified in setNextFocusRequestResponse.
protected int	requestAudioFocus(AudioManager.OnAudioFocusChangeListener l, int streamType, int durationHint)
static void	reset()
void	setActivePlaybackConfigurationsFor(List<AudioAttributes> audioAttributes)	Sets active playback configurations that will be served by AudioManager.getActivePlaybackConfigurations().
void	setActivePlaybackConfigurationsFor(List<AudioAttributes> audioAttributes, boolean notifyCallbackListeners)	Same as setActivePlaybackConfigurationsFor(List), but also notifies callbacks if notifyCallbackListeners is true.
void	setActiveRecordingConfigurations(List<AudioRecordingConfiguration> activeRecordingConfigurations, boolean notifyCallbackListeners)	Sets active recording configurations that will be served by AudioManager.getActiveRecordingConfigurations() and notifies callback listeners about that change.
void	setAudioDevicesForAttributes(AudioAttributes attributes, com.google.common.collect.ImmutableList<AudioDeviceInfo> devices)	Sets the audio devices returned from getAudioDevicesForAttributes(android.media.AudioAttributes).
void	setAvailableCommunicationDevices(List<AudioDeviceInfo> availableCommunicationDevices)	Sets the list of available communication devices represented by AudioDeviceInfo.
protected void	setBluetoothA2dpOn(boolean on)
protected void	setBluetoothScoOn(boolean isBluetoothScoOn)
protected boolean	setCommunicationDevice(AudioDeviceInfo communicationDevice)	Note that this method can silently fail.
void	setDefaultDevicesForAttributes(com.google.common.collect.ImmutableList<Object> devices)	Sets the devices to use as default for all audio streams.
void	setDevicesForAttributes(AudioAttributes attributes, com.google.common.collect.ImmutableList<Object> devices)	Sets the devices associated with the given audio stream.
void	setHotwordStreamSupported(boolean lookbackAudio, boolean isSupported)
void	setInputDevices(List<AudioDeviceInfo> inputDevices)	Sets the list of connected input devices represented by AudioDeviceInfo.
void	setIsBluetoothScoAvailableOffCall(boolean isBluetoothScoAvailableOffCall)
void	setIsMusicActive(boolean isMusicActive)
void	setIsStreamMute(int streamType, boolean isMuted)
protected void	setMicrophoneMute(boolean on)
protected void	setMode(int mode)	Note that this method can silently fail.
void	setNextFocusRequestResponse(int nextResponseValue)
void	setOutputDevices(List<AudioDeviceInfo> outputDevices)	Sets the list of connected output devices represented by AudioDeviceInfo.
protected void	setParameters(String keyValuePairs)
protected void	setRingerMode(int ringerMode)
protected void	setSpeakerphoneOn(boolean on)
void	setStreamMaxVolume(int streamMaxVolume)
void	setStreamVolume(int streamVolume)
protected void	setStreamVolume(int streamType, int index, int flags)
protected void	setWiredHeadsetOn(boolean on)
protected void	unregisterAudioDeviceCallback(AudioDeviceCallback callback)	Unregisters an AudioDeviceCallback object which has been previously registered to receive notifications of changes to the set of connected audio devices.
protected void	unregisterAudioPlaybackCallback(AudioManager.AudioPlaybackCallback cb)	Unregisters callback listening to changes made to list of active playback configurations.
protected void	unregisterAudioPolicy(Object audioPolicy)
protected void	unregisterAudioRecordingCallback(AudioManager.AudioRecordingCallback cb)	Unregisters callback listening to changes made to list of active recording configurations.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

MAX_VOLUME_MUSIC_DTMF

public static final int MAX_VOLUME_MUSIC_DTMF

See Also:

• Constant Field Values

DEFAULT_MAX_VOLUME

public static final int DEFAULT_MAX_VOLUME

See Also:

• Constant Field Values

MIN_VOLUME

public static final int MIN_VOLUME

See Also:

• Constant Field Values

DEFAULT_VOLUME

public static final int DEFAULT_VOLUME

See Also:

• Constant Field Values

INVALID_VOLUME

public static final int INVALID_VOLUME

See Also:

• Constant Field Values

FLAG_NO_ACTION

public static final int FLAG_NO_ACTION

See Also:

• Constant Field Values

ALL_STREAMS

public static final com.google.common.collect.ImmutableList<Integer> ALL_STREAMS

Constructor Details

ShadowAudioManager

public ShadowAudioManager()

Method Details

getStreamMaxVolume

@Implementation
protected int getStreamMaxVolume(int streamType)

getStreamVolume

@Implementation
protected int getStreamVolume(int streamType)

getStreamVolumeDb

@Implementation(minSdk=28)
protected float getStreamVolumeDb(int streamType,
 int index,
 int deviceType)

setStreamVolume

@Implementation
protected void setStreamVolume(int streamType,
 int index,
 int flags)

isBluetoothScoAvailableOffCall

@Implementation
protected boolean isBluetoothScoAvailableOffCall()

requestAudioFocus

@Implementation
protected int requestAudioFocus(AudioManager.OnAudioFocusChangeListener l,
 int streamType,
 int durationHint)

requestAudioFocus

@Implementation(minSdk=26)
protected int requestAudioFocus(AudioFocusRequest audioFocusRequest)

Provides a mock like interface for the requestAudioFocus method by storing the request object for later inspection and returning the value specified in setNextFocusRequestResponse.

abandonAudioFocus

@Implementation
protected int abandonAudioFocus(AudioManager.OnAudioFocusChangeListener l)

abandonAudioFocusRequest

@Implementation(minSdk=26)
protected int abandonAudioFocusRequest(AudioFocusRequest audioFocusRequest)

Provides a mock like interface for the abandonAudioFocusRequest method by storing the request object for later inspection and returning the value specified in setNextFocusRequestResponse.

getRingerMode

@Implementation
protected int getRingerMode()

setRingerMode

@Implementation
protected void setRingerMode(int ringerMode)

isValidRingerMode

@Implementation
public static boolean isValidRingerMode(int ringerMode)

setMode

@Implementation
protected void setMode(int mode)

Note that this method can silently fail. See lockMode.

reset

@Resetter
public static void reset()

lockMode

public void lockMode(boolean lockMode)

Sets whether subsequent calls to setMode(int) will succeed or not.

getMode

@Implementation
protected int getMode()

setStreamMaxVolume

public void setStreamMaxVolume(int streamMaxVolume)

setStreamVolume

public void setStreamVolume(int streamVolume)

setWiredHeadsetOn

@Implementation
protected void setWiredHeadsetOn(boolean on)

isWiredHeadsetOn

@Implementation
protected boolean isWiredHeadsetOn()

setBluetoothA2dpOn

@Implementation
protected void setBluetoothA2dpOn(boolean on)

isBluetoothA2dpOn

@Implementation
protected boolean isBluetoothA2dpOn()

setSpeakerphoneOn

@Implementation
protected void setSpeakerphoneOn(boolean on)

isSpeakerphoneOn

@Implementation
protected boolean isSpeakerphoneOn()

setMicrophoneMute

@Implementation
protected void setMicrophoneMute(boolean on)

isMicrophoneMute

@Implementation
protected boolean isMicrophoneMute()

isBluetoothScoOn

@Implementation
protected boolean isBluetoothScoOn()

setBluetoothScoOn

@Implementation
protected void setBluetoothScoOn(boolean isBluetoothScoOn)

isMusicActive

@Implementation
protected boolean isMusicActive()

getActivePlaybackConfigurations

@Implementation(minSdk=26)
protected List<AudioPlaybackConfiguration> getActivePlaybackConfigurations()

setParameters

@Implementation
protected void setParameters(String keyValuePairs)

getParameters

@Implementation
protected String getParameters(String keys)

The expected composition for keys is not well defined.

For testing purposes this method call always returns null.

getParameter

public String getParameter(String key)

Returns a single parameter that was set via setParameters(String).

adjustStreamVolume

@Implementation
protected void adjustStreamVolume(int streamType,
 int direction,
 int flags)

Implements AudioManager.adjustStreamVolume(int, int, int).

Currently supports only the directions AudioManager.ADJUST_MUTE, AudioManager.ADJUST_UNMUTE, AudioManager.ADJUST_LOWER and AudioManager.ADJUST_RAISE.

isStreamMute

@Implementation(minSdk=23)
protected boolean isStreamMute(int streamType)

setIsBluetoothScoAvailableOffCall

public void setIsBluetoothScoAvailableOffCall(boolean isBluetoothScoAvailableOffCall)

setIsStreamMute

public void setIsStreamMute(int streamType,
 boolean isMuted)

registerAudioPlaybackCallback

@Implementation(minSdk=26)
protected void registerAudioPlaybackCallback(AudioManager.AudioPlaybackCallback cb,
 Handler handler)

Registers callback that will receive changes made to the list of active playback configurations by setActivePlaybackConfigurationsFor(java.util.List<android.media.AudioAttributes>).

unregisterAudioPlaybackCallback

@Implementation(minSdk=26)
protected void unregisterAudioPlaybackCallback(AudioManager.AudioPlaybackCallback cb)

Unregisters callback listening to changes made to list of active playback configurations.

getDevicesForAttributes

@Implementation(minSdk=30)
protected List<?> getDevicesForAttributes(AudioAttributes attributes)

Returns the devices associated with the given audio stream.

In this shadow-implementation the devices returned are either

1. devices set through setDevicesForAttributes(android.media.AudioAttributes, com.google.common.collect.ImmutableList<java.lang.Object>), or
2. devices set through setDefaultDevicesForAttributes(com.google.common.collect.ImmutableList<java.lang.Object>), or
3. an empty list.

setDevicesForAttributes

public void setDevicesForAttributes(AudioAttributes attributes,
 com.google.common.collect.ImmutableList<Object> devices)

Sets the devices associated with the given audio stream.

setDefaultDevicesForAttributes

public void setDefaultDevicesForAttributes(com.google.common.collect.ImmutableList<Object> devices)

Sets the devices to use as default for all audio streams.

getAudioDevicesForAttributes

@Implementation(minSdk=33)
protected List<AudioDeviceInfo> getAudioDevicesForAttributes(AudioAttributes attributes)

Returns the audio devices that would be used for the routing of the given audio attributes.

Devices can be added with setAudioDevicesForAttributes(android.media.AudioAttributes, com.google.common.collect.ImmutableList<android.media.AudioDeviceInfo>). Note that setDevicesForAttributes(android.media.AudioAttributes, com.google.common.collect.ImmutableList<java.lang.Object>) and setDefaultDevicesForAttributes(com.google.common.collect.ImmutableList<java.lang.Object>) have no effect on the return value of this method.

setAudioDevicesForAttributes

public void setAudioDevicesForAttributes(AudioAttributes attributes,
 com.google.common.collect.ImmutableList<AudioDeviceInfo> devices)

Sets the audio devices returned from getAudioDevicesForAttributes(android.media.AudioAttributes).

addOnCommunicationDeviceChangedListener

@Implementation(minSdk=31)
protected void addOnCommunicationDeviceChangedListener(Executor executor,
 AudioManager.OnCommunicationDeviceChangedListener listener)

Registers a AudioManager.OnCommunicationDeviceChangedListener that can later be called with callOnCommunicationDeviceChangedListeners(android.media.AudioDeviceInfo). The provided executor will be used when calling AudioManager.OnCommunicationDeviceChangedListener.onCommunicationDeviceChanged(android.media.AudioDeviceInfo)

removeOnCommunicationDeviceChangedListener

@Implementation(minSdk=31)
protected void removeOnCommunicationDeviceChangedListener(AudioManager.OnCommunicationDeviceChangedListener listener)

Unregisters a previously registered AudioManager.OnCommunicationDeviceChangedListener.

callOnCommunicationDeviceChangedListeners

public void callOnCommunicationDeviceChangedListeners(AudioDeviceInfo device)

Calls the AudioManager.OnCommunicationDeviceChangedListener.onCommunicationDeviceChanged(android.media.AudioDeviceInfo) method on all registered AudioManager.OnCommunicationDeviceChangedListener, using their registered executors, with the provided AudioDeviceInfo as argument.

setInputDevices

public void setInputDevices(List<AudioDeviceInfo> inputDevices)

Sets the list of connected input devices represented by AudioDeviceInfo.

The previous list of input devices is replaced and no notifications of the list of AudioDeviceCallback is done.

To add/remove devices one by one and trigger notifications for the list of AudioDeviceCallback please use one of the following methods addInputDevice(AudioDeviceInfo, boolean), removeInputDevice(AudioDeviceInfo, boolean).

setOutputDevices

public void setOutputDevices(List<AudioDeviceInfo> outputDevices)

Sets the list of connected output devices represented by AudioDeviceInfo.

The previous list of output devices is replaced and no notifications of the list of AudioDeviceCallback is done.

To add/remove devices one by one and trigger notifications for the list of AudioDeviceCallback please use one of the following methods addOutputDevice(AudioDeviceInfo, boolean), removeOutputDevice(AudioDeviceInfo, boolean).

setAvailableCommunicationDevices

public void setAvailableCommunicationDevices(List<AudioDeviceInfo> availableCommunicationDevices)

Sets the list of available communication devices represented by AudioDeviceInfo.

The previous list of communication devices is replaced and no notifications of the list of AudioDeviceCallback is done.

To add/remove devices one by one and trigger notifications for the list of AudioDeviceCallback please use one of the following methods addOutputDevice(AudioDeviceInfo, boolean), removeOutputDevice(AudioDeviceInfo, boolean).

addInputDevice

public void addInputDevice(AudioDeviceInfo inputDevice,
 boolean notifyAudioDeviceCallbacks)

Adds an input AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was not present before and indicated by notifyAudioDeviceCallbacks.

removeInputDevice

public void removeInputDevice(AudioDeviceInfo inputDevice,
 boolean notifyAudioDeviceCallbacks)

Removes an input AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was present before and indicated by notifyAudioDeviceCallbacks.

addOutputDevice

public void addOutputDevice(AudioDeviceInfo outputDevice,
 boolean notifyAudioDeviceCallbacks)

Adds an output AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was not present before and indicated by notifyAudioDeviceCallbacks.

removeOutputDevice

public void removeOutputDevice(AudioDeviceInfo outputDevice,
 boolean notifyAudioDeviceCallbacks)

Removes an output AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was present before and indicated by notifyAudioDeviceCallbacks.

addAvailableCommunicationDevice

public void addAvailableCommunicationDevice(AudioDeviceInfo communicationDevice,
 boolean notifyAudioDeviceCallbacks)

Adds an available communication AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was not present before and indicated by notifyAudioDeviceCallbacks.

removeAvailableCommunicationDevice

public void removeAvailableCommunicationDevice(AudioDeviceInfo communicationDevice,
 boolean notifyAudioDeviceCallbacks)

Removes an available communication AudioDeviceInfo and notifies the list of AudioDeviceCallback if the device was present before and indicated by notifyAudioDeviceCallbacks.

registerAudioDeviceCallback

@Implementation(minSdk=23)
protected void registerAudioDeviceCallback(AudioDeviceCallback callback,
 Handler handler)

Registers an AudioDeviceCallback object to receive notifications of changes to the set of connected audio devices.

The handler is ignored.

See Also:

• addInputDevice(AudioDeviceInfo, boolean)
• addOutputDevice(AudioDeviceInfo, boolean)
• addAvailableCommunicationDevice(AudioDeviceInfo, boolean)
• removeInputDevice(AudioDeviceInfo, boolean)
• removeOutputDevice(AudioDeviceInfo, boolean)
• removeAvailableCommunicationDevice(AudioDeviceInfo, boolean)
• addOutputDeviceWithDirectProfiles(AudioDeviceInfo)
• removeOutputDeviceWithDirectProfiles(AudioDeviceInfo)

unregisterAudioDeviceCallback

@Implementation(minSdk=23)
protected void unregisterAudioDeviceCallback(AudioDeviceCallback callback)

Unregisters an AudioDeviceCallback object which has been previously registered to receive notifications of changes to the set of connected audio devices.

See Also:

• addInputDevice(AudioDeviceInfo, boolean)
• addOutputDevice(AudioDeviceInfo, boolean)
• addAvailableCommunicationDevice(AudioDeviceInfo, boolean)
• removeInputDevice(AudioDeviceInfo, boolean)
• removeOutputDevice(AudioDeviceInfo, boolean)
• removeAvailableCommunicationDevice(AudioDeviceInfo, boolean)
• addOutputDeviceWithDirectProfiles(AudioDeviceInfo)
• removeOutputDeviceWithDirectProfiles(AudioDeviceInfo)

setCommunicationDevice

@Implementation(minSdk=31)
protected boolean setCommunicationDevice(AudioDeviceInfo communicationDevice)

Note that this method can silently fail. See lockCommunicationDevice.

lockCommunicationDevice

public void lockCommunicationDevice(boolean lockCommunicationDevice)

Sets whether subsequent calls to setCommunicationDevice(android.media.AudioDeviceInfo) will succeed.

getCommunicationDevice

@Implementation(minSdk=31)
protected AudioDeviceInfo getCommunicationDevice()

clearCommunicationDevice

@Implementation(minSdk=31)
protected void clearCommunicationDevice()

getAvailableCommunicationDevices

@Implementation(minSdk=31)
protected List<AudioDeviceInfo> getAvailableCommunicationDevices()

isHotwordStreamSupported

@Implementation(minSdk=34)
protected boolean isHotwordStreamSupported(boolean lookbackAudio)

setHotwordStreamSupported

public void setHotwordStreamSupported(boolean lookbackAudio,
 boolean isSupported)

getDevices

@Implementation(minSdk=23)
public AudioDeviceInfo[] getDevices(int flags)

setActivePlaybackConfigurationsFor

public void setActivePlaybackConfigurationsFor(List<AudioAttributes> audioAttributes)

Sets active playback configurations that will be served by AudioManager.getActivePlaybackConfigurations().

Note that there is no public AudioPlaybackConfiguration constructor, so the configurations returned are specified by their audio attributes only.

setActivePlaybackConfigurationsFor

public void setActivePlaybackConfigurationsFor(List<AudioAttributes> audioAttributes,
 boolean notifyCallbackListeners)

Same as setActivePlaybackConfigurationsFor(List), but also notifies callbacks if notifyCallbackListeners is true.

createAudioPlaybackConfiguration

protected AudioPlaybackConfiguration createAudioPlaybackConfiguration(AudioAttributes audioAttributes)

setIsMusicActive

public void setIsMusicActive(boolean isMusicActive)

getLastAudioFocusRequest

public ShadowAudioManager.AudioFocusRequest getLastAudioFocusRequest()

setNextFocusRequestResponse

public void setNextFocusRequestResponse(int nextResponseValue)

getLastAbandonedAudioFocusListener

public AudioManager.OnAudioFocusChangeListener getLastAbandonedAudioFocusListener()

getLastAbandonedAudioFocusRequest

public AudioFocusRequest getLastAbandonedAudioFocusRequest()

getActiveRecordingConfigurations

@Implementation(minSdk=24)
protected List<AudioRecordingConfiguration> getActiveRecordingConfigurations()

Returns list of active recording configurations that was set by setActiveRecordingConfigurations(java.util.List<android.media.AudioRecordingConfiguration>, boolean) or empty list otherwise.

registerAudioRecordingCallback

@Implementation(minSdk=24)
protected void registerAudioRecordingCallback(AudioManager.AudioRecordingCallback cb,
 Handler handler)

Registers callback that will receive changes made to the list of active recording configurations by setActiveRecordingConfigurations(java.util.List<android.media.AudioRecordingConfiguration>,boolean).

unregisterAudioRecordingCallback

@Implementation(minSdk=24)
protected void unregisterAudioRecordingCallback(AudioManager.AudioRecordingCallback cb)

Unregisters callback listening to changes made to list of active recording configurations.

setActiveRecordingConfigurations

public void setActiveRecordingConfigurations(List<AudioRecordingConfiguration> activeRecordingConfigurations,
 boolean notifyCallbackListeners)

Sets active recording configurations that will be served by AudioManager.getActiveRecordingConfigurations() and notifies callback listeners about that change.

createActiveRecordingConfiguration

public AudioRecordingConfiguration createActiveRecordingConfiguration(int sessionId,
 int audioSource,
 String clientPackageName)

Creates simple active recording configuration. The resulting configuration will return null for AudioRecordingConfiguration.getAudioDevice().

registerAudioPolicy

@HiddenApi
@Implementation(minSdk=28)
protected int registerAudioPolicy(Object audioPolicy)

Registers an AudioPolicy to allow that policy to control audio routing and audio focus.

Note: this implementation does NOT ensure that we have the permissions necessary to register the given AudioPolicy.

Returns:

AudioManager.ERROR if the given policy has already been registered, and AudioManager.SUCCESS otherwise.

unregisterAudioPolicy

@HiddenApi
@Implementation(minSdk=29)
protected void unregisterAudioPolicy(Object audioPolicy)

isAnyAudioPolicyRegistered

public boolean isAnyAudioPolicyRegistered()

Returns true if at least one audio policy is registered with this manager, and false otherwise.

getDirectProfilesForAttributes

@Implementation(minSdk=33)
protected List<AudioProfile> getDirectProfilesForAttributes(AudioAttributes attributes)

Returns the list of profiles supported for direct playback.

In this shadow-implementation the list returned are profiles set through addOutputDeviceWithDirectProfiles(AudioDeviceInfo), removeOutputDeviceWithDirectProfiles(AudioDeviceInfo).

addOutputDeviceWithDirectProfiles

public void addOutputDeviceWithDirectProfiles(AudioDeviceInfo outputDevice)

Adds an output device with direct profiles and notifies the list of AudioDeviceCallback if the device was not present before.

removeOutputDeviceWithDirectProfiles

public void removeOutputDeviceWithDirectProfiles(AudioDeviceInfo outputDevice)

Removes an output device with direct profiles and notifies the list of AudioDeviceCallback if the device was present before.

generateAudioSessionId

@Implementation
protected int generateAudioSessionId()

Provides a mock like interface for the AudioManager.generateAudioSessionId() method by returning positive distinct values, or AudioManager.ERROR if all possible values have already been returned.

dispatchMediaKeyEvent

@Implementation
protected void dispatchMediaKeyEvent(KeyEvent keyEvent)

Sends a simulated key event for a media button.

Instead of sending the media event to the media system service, from where it would be routed to a media app, this shadow method only records the events to be verified through getDispatchedMediaKeyEvents().

getDispatchedMediaKeyEvents

public List<KeyEvent> getDispatchedMediaKeyEvents()

clearDispatchedMediaKeyEvents

public void clearDispatchedMediaKeyEvents()