AudioCapabilitiesReceiver
@UnstableApi
public final class AudioCapabilitiesReceiver
Receives broadcast events indicating changes to the device's audio capabilities, notifying a Listener when audio capability changes occur.
Summary
Nested types |
|---|
public interface AudioCapabilitiesReceiver.ListenerListener notified when audio capabilities change. |
Public constructors |
|---|
This method is deprecated. Use |
AudioCapabilitiesReceiver( |
Public methods |
|
|---|---|
void |
overrideCapabilities(AudioCapabilities audioCapabilities)Overrides the reported audio capabilities until the next event that triggers a new evaluation of the capabilities. |
AudioCapabilities |
register()Registers the receiver, meaning it will notify the listener when audio capability changes occur. |
void |
setAudioAttributes(AudioAttributes audioAttributes)Updates the |
void |
setRoutedDevice(@Nullable AudioDeviceInfo routedDevice)Updates the |
void |
Unregisters the receiver, meaning it will no longer notify the listener when audio capability changes occur. |
Public constructors
AudioCapabilitiesReceiver
publicAudioCapabilitiesReceiver(
Context context,
AudioCapabilitiesReceiver.Listener listener
)
AudioCapabilitiesReceiver
public AudioCapabilitiesReceiver(
Context context,
AudioCapabilitiesReceiver.Listener listener,
AudioAttributes audioAttributes,
@Nullable AudioDeviceInfo routedDevice
)
| Parameters | |
|---|---|
Context context |
A context for registering the receiver. |
AudioCapabilitiesReceiver.Listener listener |
The listener to notify when audio capabilities change. |
AudioAttributes audioAttributes |
The |
@Nullable AudioDeviceInfo routedDevice |
The |
Public methods
overrideCapabilities
public void overrideCapabilities(AudioCapabilities audioCapabilities)
Overrides the reported audio capabilities until the next event that triggers a new evaluation of the capabilities.
| Parameters | |
|---|---|
AudioCapabilities audioCapabilities |
The |
register
public AudioCapabilities register()
Registers the receiver, meaning it will notify the listener when audio capability changes occur. The current audio capabilities will be returned. It is important to call unregister when the receiver is no longer required.
| Returns | |
|---|---|
AudioCapabilities |
The current audio capabilities for the device. |
setAudioAttributes
public void setAudioAttributes(AudioAttributes audioAttributes)
Updates the AudioAttributes used by this instance.
| Parameters | |
|---|---|
AudioAttributes audioAttributes |
The |
setRoutedDevice
public void setRoutedDevice(@Nullable AudioDeviceInfo routedDevice)
Updates the AudioDeviceInfo audio will be routed to.
| Parameters | |
|---|---|
@Nullable AudioDeviceInfo routedDevice |
The |
unregister
public void unregister()
Unregisters the receiver, meaning it will no longer notify the listener when audio capability changes occur.