AudioManager

java.lang.Object
- ohos.media.audio.AudioManager

```
public class AudioManager
extends Object
```
Manages audio information, controls audio devices, adjusts the volume, and manages the audio focus.
An AudioManager instance adjusts the global volume, mutes streams, controls the audio version, sets the ringer mode (sound, silent, or vibration), and enables or disables audio devices.

从以下版本开始:

1

SystemCapability

SystemCapability.Multimedia#AUDIO

嵌套类概要

嵌套类
限定符和类型	类	说明
`static class`	`AudioManager.AudioRingMode`	Describes ringer modes.
`static class`	`AudioManager.AudioVolumeType`	Describes audio stream types.
`static class`	`AudioManager.CallState`	Describes call states.
`static class`	`AudioManager.RingtoneType`	Describes ringtone types.

字段概要

字段
限定符和类型	字段	说明
`static int`	`DEFAULT_VOLUME`	Indicates the default volume.
`static int`	`DEVICE_ID_BLUETOOTH`	Indicates a Bluetooth device.
`static int`	`DEVICE_ID_SPEAKERPHONE`	Indicates a speaker device.
`static int`	`DEVICE_ID_WIRED_HEADSET`	Indicates a wired headset device.
`static int`	`MARKER_WITH_SOUND`	Indicates that a sound is played when the volume is adjusted.
`static int`	`MARKER_WITH_VOLUME_BAR`	Indicates that a volume bar is shown when the volume is adjusted.
`static int`	`RINGER_MODE_MAX`	Indicates the maximum valid volume of the sound mode.
`static int`	`VOLUME_OP_DEC`	Indicates a volume decrease.
`static int`	`VOLUME_OP_INC`	Indicates a volume increase.
`static int`	`VOLUME_OP_MAINTAIN`	Indicates that the volume remains unchanged.

构造器概要

构造器
构造器	说明
`AudioManager()`	A constructor used to create an `AudioManager` instance
`AudioManager(String packageName)`	A constructor used to create an `AudioManager` instance according to the name of an application installation package.
`AudioManager(Context context)`	A constructor used to create an `AudioManager` instance based on the application context.

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法	说明
`boolean`	`activateAudioInterrupt(AudioInterrupt interrupt)`	Activates audio interruption.
`void`	`attachAudioEffects()`	Loads sound effect resources.
`boolean`	`changeVolumeBy(AudioManager.AudioVolumeType volumeType, int index)`	Increases or decreases the current volume by a certain amount.
`boolean`	`connectBluetoothSco()`	Connects to the Bluetooth SCO channel.
`boolean`	`deactivateAudioInterrupt(AudioInterrupt interrupt)`	Deactivates audio interruption.
`void`	`detachAudioEffects()`	Detaches sound effect resources.
`boolean`	`disconnectBluetoothSco()`	Disconnects from the Bluetooth SCO channel.
`List<AudioCapturerConfig>`	`getActiveCapturerConfigs()`	Obtains currently active capturer configurations of the device.
`List<AudioRendererInfo>`	`getActiveRendererConfigs()`	Obtains information about the active audio streams, including the usage type, content type, and flags.
`String`	`getAudioParameter(String key)`	Obtains the value of audio device parameters specified by `key`.
`AudioManager.CallState`	`getCallState()`	Obtains the current call state.
`static AudioDeviceDescriptor[]`	`getDevices(AudioDeviceDescriptor.DeviceFlag flag)`	Obtains information about audio input or output devices, or that about all audio devices.
`static int`	`getMasterOutputFrameCount()`	Obtains the number of frames in the buffer of the master output device.
`static int`	`getMasterOutputSampleRate()`	Obtains the sampling rate of the master output device.
`int`	`getMaxVolume(AudioManager.AudioVolumeType volumeType)`	Obtains the maximum volume level of a specified type of audio streams.
`int`	`getMinVolume(AudioManager.AudioVolumeType volumeType)`	Obtains the minimum volume level of a specified type of audio streams.
`int`	`getRingerMode()`	Obtains the ringer mode.
`static Uri`	`getRingerUri(Context context, AudioManager.RingtoneType type)`	Obtains the `Uri` of a specified `RingtoneType`.
`int`	`getVersion()`	Obtains the audio kit version.
`int`	`getVolume(AudioManager.AudioVolumeType volumeType)`	Obtains the volume level of a specified type of audio streams.
`boolean`	`isBluetoothScoUsableNotInCall(Context context)`	Checks whether the current device supports synchronous connection-oriented (SCO) links when it is not in a call.
`boolean`	`isDeviceActive(int deviceType)`	Checks whether a device is turned on or off.
`boolean`	`isMasterMute()`	Checks whether audio streams are muted globally.
`boolean`	`isMicrophoneMute()`	Checks whether a microphone is muted.
`boolean`	`isMute(AudioManager.AudioVolumeType volumeType)`	Checks whether a specified type of streams are muted.
`static boolean`	`isStreamActive(AudioManager.AudioVolumeType volumeType)`	Checks whether audio streams of a specified type are active.
`boolean`	`isVolumeChangeForbidden(Context context)`	Checks whether device volume is fixed.
`static int`	`makeSessionId()`	Creates a session ID to be used by `AudioRendererInfo.Builder#sessionID(int)` for setting audio playback parameters and `AudioCapturerInfo.Builder#sessionID(int)` for setting recording parameters.
`boolean`	`mute(AudioManager.AudioVolumeType volumeType)`	Mutes a specified type of streams.
`void`	`registerAudioCapturerCallback(AudioCapturerCallback cb)`	Registers a callback to receive notifications about capturer configuration changes.
`void`	`registerAudioRendererCallback(AudioRendererCallback cb)`	Registers an audio playback callback for the current device.
`void`	`removeAudioDeviceChangeObserver(AudioDeviceChangeObserver observer)`	Removes the `AudioDeviceChangeObserver` object that is registered with the system via the `setAudioDeviceChangeObserver(ohos.media.audio.AudioDeviceChangeObserver)` method.
`void`	`setAudioDeviceChangeObserver(AudioDeviceChangeObserver observer)`	Sets an observer to listen for state changes of an audio device, for example, when it becomes connected or disconnected.
`boolean`	`setAudioParameter(String key, String value)`	Sets values of a variable number of parameters for audio devices.
`void`	`setCallState(AudioManager.CallState callState)`	Sets the current call state.
`boolean`	`setDeviceActive(int deviceType, boolean state)`	Turns on or off a device.
`boolean`	`setMasterMute(boolean isMute)`	Mutes or unmutes global audio streams.
`boolean`	`setMicrophoneMute(boolean isMute)`	Mutes or unmutes a microphone.
`boolean`	`setRingerMode(AudioManager.AudioRingMode mode)`	Sets the ringer mode.
`static void`	`setRingerUri(Context context, AudioManager.RingtoneType type, Uri uri)`	Sets the `Uri` of a specified `RingtoneType`.
`boolean`	`setVolume(AudioManager.AudioVolumeType volumeType, int volume)`	Sets the volume level of a specified type of streams.
`boolean`	`setVolume(AudioManager.AudioVolumeType volumeType, int volume, int markers)`	Sets the volume for an audio stream of the specified type.
`boolean`	`unmute(AudioManager.AudioVolumeType volumeType)`	Unmutes a specified type of streams.
`void`	`unregisterAudioCapturerCallback(AudioCapturerCallback cb)`	Unregisters the callback that has been registered with `registerAudioCapturerCallback(ohos.media.audio.AudioCapturerCallback)`.
`void`	`unregisterAudioRendererCallback(AudioRendererCallback cb)`	Deregisters an audio playback callback listening the current device.

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - DEFAULT_VOLUME
```
public static final int DEFAULT_VOLUME
```
    Indicates the default volume.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    常量字段值
  - DEVICE_ID_BLUETOOTH
```
public static final int DEVICE_ID_BLUETOOTH
```
    Indicates a Bluetooth device.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    常量字段值
  - DEVICE_ID_SPEAKERPHONE
```
public static final int DEVICE_ID_SPEAKERPHONE
```
    Indicates a speaker device.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    常量字段值
  - DEVICE_ID_WIRED_HEADSET
```
public static final int DEVICE_ID_WIRED_HEADSET
```
    Indicates a wired headset device.
    
    从以下版本开始:
    
    3
    
    另请参阅:
    
    常量字段值
  - MARKER_WITH_SOUND
```
public static final int MARKER_WITH_SOUND
```
    Indicates that a sound is played when the volume is adjusted.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - MARKER_WITH_VOLUME_BAR
```
public static final int MARKER_WITH_VOLUME_BAR
```
    Indicates that a volume bar is shown when the volume is adjusted.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - RINGER_MODE_MAX
```
public static final int RINGER_MODE_MAX
```
    Indicates the maximum valid volume of the sound mode.
    
    从以下版本开始:
    
    1
  - VOLUME_OP_DEC
```
public static final int VOLUME_OP_DEC
```
    Indicates a volume decrease.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - VOLUME_OP_INC
```
public static final int VOLUME_OP_INC
```
    Indicates a volume increase.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
  - VOLUME_OP_MAINTAIN
```
public static final int VOLUME_OP_MAINTAIN
```
    Indicates that the volume remains unchanged.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    常量字段值
- 构造器详细资料
  - AudioManager
```
public AudioManager()
```
    A constructor used to create an AudioManager instance
    
    从以下版本开始:
    
    1
  - AudioManager
```
public AudioManager(String packageName)
```
    A constructor used to create an AudioManager instance according to the name of an application installation package.
    
    参数:
    
    packageName - Indicates the name of an application installation package.
    
    从以下版本开始:
    
    1
  - AudioManager
```
public AudioManager(Context context)
```
    A constructor used to create an AudioManager instance based on the application context.
    
    参数:
    
    context - Indicates the application context.
    
    从以下版本开始:
    
    3
- 方法详细资料
  - getVersion
```
public int getVersion()
```
    Obtains the audio kit version.
    
    返回:
    
    Returns the audio kit version.
    
    从以下版本开始:
    
    1
  - setVolume
```
public boolean setVolume(AudioManager.AudioVolumeType volumeType,
                         int volume)
```
    Sets the volume level of a specified type of streams.
    
    参数:
    
    volumeType - Indicates the type of streams for which the volume level is to set.
    
    volume - Indicates the volume level to set. You can obtain the maximum level value by calling getMaxVolume(ohos.media.audio.AudioManager.AudioVolumeType), and the minimum by getMinVolume(ohos.media.audio.AudioManager.AudioVolumeType).
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    getMaxVolume(AudioVolumeType), getMinVolume(AudioVolumeType), getVolume(AudioVolumeType)
  - setVolume
```
public boolean setVolume(AudioManager.AudioVolumeType volumeType,
                         int volume,
                         int markers)
```
    Sets the volume for an audio stream of the specified type.
    
    参数:
    
    volumeType - Indicates the type of the audio stream whose volume needs to be set.
    
    volume - Indicates the volume to set. You can use getMaxVolume(ohos.media.audio.AudioManager.AudioVolumeType) and getMinVolume(ohos.media.audio.AudioManager.AudioVolumeType) to obtain the maximum volume and minimum volume of a specific audio stream, respectively.
    
    markers - Indicates the markers. This parameter can be set to the values of MARKER_WITH_VOLUME_BAR, the values ofMARKER_WITH_SOUND, and their combinations. The value 0 means that no marker is set.
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    6
    
    另请参阅:
    
    getMaxVolume(AudioVolumeType), getMinVolume(AudioVolumeType), getVolume(AudioVolumeType)
  - getVolume
```
public int getVolume(AudioManager.AudioVolumeType volumeType)
              throws AudioRemoteException
```
    Obtains the volume level of a specified type of audio streams.
    
    参数:
    
    volumeType - Indicates the stream type.
    
    返回:
    
    Returns the volume level of the type of streams.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the volume level fails to be obtained.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    getMaxVolume(AudioVolumeType), getMinVolume(AudioVolumeType), setVolume(AudioVolumeType, int)
  - getMinVolume
```
public int getMinVolume(AudioManager.AudioVolumeType volumeType)
                 throws AudioRemoteException
```
    Obtains the minimum volume level of a specified type of audio streams.
    
    参数:
    
    volumeType - Indicates the stream type.
    
    返回:
    
    Returns the minimum valid volume level for the type of streams.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the minimum volume level fails to be obtained.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    getVolume(AudioVolumeType)
  - getMaxVolume
```
public int getMaxVolume(AudioManager.AudioVolumeType volumeType)
                 throws AudioRemoteException
```
    Obtains the maximum volume level of a specified type of audio streams.
    
    参数:
    
    volumeType - Indicates the stream type.
    
    返回:
    
    Returns the maximum valid volume level for the type of streams.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the maximum volume level fails to be obtained.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    getVolume(AudioVolumeType)
  - mute
```
public boolean mute(AudioManager.AudioVolumeType volumeType)
```
    Mutes a specified type of streams.
    
    参数:
    
    volumeType - Indicates the type of streams to mute.
    
    返回:
    
    Returns true if the streams are muted; returns false otherwise.
    
    从以下版本开始:
    
    1
  - unmute
```
public boolean unmute(AudioManager.AudioVolumeType volumeType)
```
    Unmutes a specified type of streams.
    
    参数:
    
    volumeType - Indicates the type of streams to unmute.
    
    返回:
    
    Returns true if the streams are unmuted; returns false otherwise.
    
    从以下版本开始:
    
    1
  - isMute
```
public boolean isMute(AudioManager.AudioVolumeType volumeType)
               throws AudioRemoteException
```
    Checks whether a specified type of streams are muted.
    
    参数:
    
    volumeType - Indicates the stream type.
    
    返回:
    
    Returns true if the streams are muted; returns false otherwise.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the check fails.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    mute(AudioVolumeType), unmute(AudioVolumeType)
  - setRingerMode
```
public boolean setRingerMode(AudioManager.AudioRingMode mode)
```
    Sets the ringer mode.
    In silent mode, a device is silent and does not vibrate. In vibration mode, a device is silent and vibrates. In sound mode, a device is audible and may vibrate (depending on user settings).
    
    参数:
    
    mode - Indicates the ringer mode, which can be AudioRingMode#RINGER_MODE_NORMAL, AudioRingMode#RINGER_MODE_SILENT, or AudioRingMode#RINGER_MODE_VIBRATE.
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    getRingerMode()
  - getRingerMode
```
public int getRingerMode()
                  throws AudioRemoteException
```
    Obtains the ringer mode.
    
    返回:
    
    Returns the ringer mode, which can be AudioRingMode#RINGER_MODE_NORMAL, AudioRingMode#RINGER_MODE_SILENT, or AudioRingMode#RINGER_MODE_VIBRATE.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the ringer mode fails to be obtained.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    setRingerMode(AudioRingMode)
  - setDeviceActive
```
public boolean setDeviceActive(int deviceType,
                               boolean state)
```
    Turns on or off a device.
    
    参数:
    
    deviceType - Indicates the device type, which can be DEVICE_ID_SPEAKERPHONE or DEVICE_ID_BLUETOOTH.
    
    state - Indicates the turn-on or turn-off state.
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    1
  - isDeviceActive
```
public boolean isDeviceActive(int deviceType)
                       throws AudioRemoteException
```
    Checks whether a device is turned on or off.
    
    参数:
    
    deviceType - Indicates the device type, which can be DEVICE_ID_SPEAKERPHONE, DEVICE_ID_BLUETOOTH or DEVICE_ID_WIRED_HEADSET.
    
    返回:
    
    Returns true if the device is turned on; returns false otherwise.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the device state fails to be obtained.
    
    从以下版本开始:
    
    3
  - activateAudioInterrupt
```
public boolean activateAudioInterrupt(AudioInterrupt interrupt)
```
    Activates audio interruption.
    Before playing audio, an application sends an interruption request to other applications for pausing audio playback or decreasing the volume, preventing audio conflicts.
    
    参数:
    
    interrupt - Indicates the interruption data structure, including interruption information and the interruption listener.
    
    返回:
    
    Returns true if audio interruption is activated; returns false otherwise.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    deactivateAudioInterrupt(AudioInterrupt), AudioInterrupt
  - deactivateAudioInterrupt
```
public boolean deactivateAudioInterrupt(AudioInterrupt interrupt)
```
    Deactivates audio interruption.
    If an application does not need to receive interruption messages, call this method to deactivate audio interruption for the application.
    
    参数:
    
    interrupt - Indicates the interruption data structure, including interruption information and the interruption listener.
    
    返回:
    
    Returns true if audio interruption is deactivated; returns false otherwise.
    
    从以下版本开始:
    
    1
    
    另请参阅:
    
    activateAudioInterrupt(AudioInterrupt), AudioInterrupt
  - setAudioParameter
```
public boolean setAudioParameter(String key,
                                 String value)
```
    Sets values of a variable number of parameters for audio devices.
    
    参数:
    
    key - Indicates the key of parameters to be set.
    
    value - Indicates the value of parameters.
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getAudioParameter
```
public String getAudioParameter(String key)
```
    Obtains the value of audio device parameters specified by key.
    
    参数:
    
    key - Indicates the key parameter.
    
    返回:
    
    Returns the key-value pairs, Example: key=value.
    
    从以下版本开始:
    
    1
  - registerAudioCapturerCallback
```
public void registerAudioCapturerCallback(AudioCapturerCallback cb)
                                   throws IllegalArgumentException
```
    Registers a callback to receive notifications about capturer configuration changes.
    
    参数:
    
    cb - Indicates the non-null callback to register.
    
    抛出:
    
    IllegalArgumentException - Throws this exception if cb is null.
    
    从以下版本开始:
    
    1
  - registerAudioRendererCallback
```
public void registerAudioRendererCallback(AudioRendererCallback cb)
```
    Registers an audio playback callback for the current device. When the playback status or a playback parameter changes, this callback will notify your application of the change.
    
    参数:
    
    cb - Indicates the audio playback callback. You need to implement this callback in your application.
    
    从以下版本开始:
    
    3
  - setAudioDeviceChangeObserver
```
public void setAudioDeviceChangeObserver(AudioDeviceChangeObserver observer)
```
    Sets an observer to listen for state changes of an audio device, for example, when it becomes connected or disconnected.
    You can call this method to obtain the device changes in a timely manner.
    
    参数:
    
    observer - Indicates the observer to set.
    
    从以下版本开始:
    
    4
  - removeAudioDeviceChangeObserver
```
public void removeAudioDeviceChangeObserver(AudioDeviceChangeObserver observer)
```
    Removes the AudioDeviceChangeObserver object that is registered with the system via the setAudioDeviceChangeObserver(ohos.media.audio.AudioDeviceChangeObserver) method. The observer object receives notifications of the status changes of an audio device connected to the system.
    
    参数:
    
    observer - Indicates the AudioDeviceChangeObserver object to remove.
    
    从以下版本开始:
    
    6
  - unregisterAudioCapturerCallback
```
public void unregisterAudioCapturerCallback(AudioCapturerCallback cb)
```
    Unregisters the callback that has been registered with registerAudioCapturerCallback(ohos.media.audio.AudioCapturerCallback).
    
    参数:
    
    cb - Indicates the non-null callback to unregister.
    
    从以下版本开始:
    
    1
  - unregisterAudioRendererCallback
```
public void unregisterAudioRendererCallback(AudioRendererCallback cb)
```
    Deregisters an audio playback callback listening the current device. After the deregistration, your application will not be notified when the audio playback status or a playback parameter changes.
    
    参数:
    
    cb - Indicates the audio playback callback, which has been registered by registerAudioRendererCallback(ohos.media.audio.AudioRendererCallback).
    
    从以下版本开始:
    
    3
  - getActiveCapturerConfigs
```
public List<AudioCapturerConfig> getActiveCapturerConfigs()
```
    Obtains currently active capturer configurations of the device.
    
    返回:
    
    Returns the non-null list of capturer configurations if any is active; returns an empty list otherwise.
    
    从以下版本开始:
    
    1
  - getActiveRendererConfigs
```
public List<AudioRendererInfo> getActiveRendererConfigs()
```
    Obtains information about the active audio streams, including the usage type, content type, and flags.
    
    返回:
    
    Returns the audio stream information.
    
    从以下版本开始:
    
    3
  - getDevices
```
public static AudioDeviceDescriptor[] getDevices(AudioDeviceDescriptor.DeviceFlag flag)
```
    Obtains information about audio input or output devices, or that about all audio devices.
    
    参数:
    
    flag - Indicates input or output devices, or all audio devices.
    
    返回:
    
    Returns an array with the same information structure as an AudioDeviceDescriptor instance if the information is obtained; returns an array whose length is 0 otherwise.
    
    从以下版本开始:
    
    1
  - setMasterMute
```
public boolean setMasterMute(boolean isMute)
```
    Mutes or unmutes global audio streams.
    
    参数:
    
    isMute - Indicates whether to mute global audio streams. Value true means global audio streams will be muted, and false means the opposite.
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    1
  - setMicrophoneMute
```
public boolean setMicrophoneMute(boolean isMute)
```
    Mutes or unmutes a microphone.
    
    参数:
    
    isMute - Indicates whether to mute a microphone. Value true means that the microphone will be muted, and false means the opposite.
    
    返回:
    
    Returns true if the setting is successful; returns false otherwise.
    
    从以下版本开始:
    
    1
  - isMicrophoneMute
```
public boolean isMicrophoneMute()
```
    Checks whether a microphone is muted.
    
    返回:
    
    Returns true if the microphone is muted; returns false otherwise.
    
    从以下版本开始:
    
    1
  - getRingerUri
```
public static Uri getRingerUri(Context context,
                               AudioManager.RingtoneType type)
```
    Obtains the Uri of a specified RingtoneType.
    
    参数:
    
    context - Indicates the context used for a search.
    
    type - Indicates the ringtone type.
    
    返回:
    
    Returns the Uri object matching the RingToneType.
    
    从以下版本开始:
    
    2
  - setRingerUri
```
public static void setRingerUri(Context context,
                                AudioManager.RingtoneType type,
                                Uri uri)
```
    Sets the Uri of a specified RingtoneType.
    
    参数:
    
    context - Indicates the context used for a search.
    
    type - Indicates the ringtone type.
    
    uri - Indicates the Uri object to set.
    
    从以下版本开始:
    
    2
  - getCallState
```
public AudioManager.CallState getCallState()
                                    throws AudioRemoteException
```
    Obtains the current call state.
    
    返回:
    
    Returns the current call state.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the call state fails to be obtained.
    
    从以下版本开始:
    
    4
  - setCallState
```
public void setCallState(AudioManager.CallState callState)
```
    Sets the current call state.
    
    参数:
    
    callState - Indicates the call state to set, which is defined in CallState.
    
    从以下版本开始:
    
    4
  - changeVolumeBy
```
public boolean changeVolumeBy(AudioManager.AudioVolumeType volumeType,
                              int index)
```
    Increases or decreases the current volume by a certain amount.
    If the target stream volume exceeds the maximum or is lower than the minimum allowed, the volume will be set to the maximum or minimum volume.
    
    参数:
    
    volumeType - Indicates the audio stream type.
    
    index - Indicates the volume change relative to the original volume. The value can be -1, 0, or 1. Value 1 indicates that the volume is increased by one level, -1 indicates that the volume is decreased by one level, and 0 indicates that the volume remains unchanged.
    
    返回:
    
    Returns true if the volume is changed; returns false otherwise.
    
    从以下版本开始:
    
    3
  - getMasterOutputSampleRate
```
public static int getMasterOutputSampleRate()
```
    Obtains the sampling rate of the master output device. The sampling rate can be used as a reference for audio playback.
    
    返回:
    
    Returns the sampling rate.
    
    从以下版本开始:
    
    3
  - getMasterOutputFrameCount
```
public static int getMasterOutputFrameCount()
```
    Obtains the number of frames in the buffer of the master output device. The value can be used as a reference for audio playback.
    
    返回:
    
    Returns the number of frames.
    
    从以下版本开始:
    
    3
  - isStreamActive
```
public static boolean isStreamActive(AudioManager.AudioVolumeType volumeType)
```
    Checks whether audio streams of a specified type are active.
    
    参数:
    
    volumeType - Indicates the audio stream type.
    
    返回:
    
    Returns true if the specified audio streams are active; returns false otherwise.
    
    从以下版本开始:
    
    3
  - connectBluetoothSco
```
public boolean connectBluetoothSco()
```
    Connects to the Bluetooth SCO channel.
    
    返回:
    
    Returns true if the connection is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - disconnectBluetoothSco
```
public boolean disconnectBluetoothSco()
```
    Disconnects from the Bluetooth SCO channel.
    
    返回:
    
    Returns true if the disconnection is successful; returns false otherwise.
    
    从以下版本开始:
    
    3
  - makeSessionId
```
public static int makeSessionId()
```
    Creates a session ID to be used by AudioRendererInfo.Builder#sessionID(int) for setting audio playback parameters and AudioCapturerInfo.Builder#sessionID(int) for setting recording parameters.
    
    返回:
    
    Returns the session ID if created; returns -1 otherwise.
    
    从以下版本开始:
    
    3
  - isMasterMute
```
public boolean isMasterMute()
                     throws AudioRemoteException
```
    Checks whether audio streams are muted globally.
    
    返回:
    
    Returns true if all audio streams are muted; returns false otherwise.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the check fails.
    
    从以下版本开始:
    
    3
  - attachAudioEffects
```
public void attachAudioEffects()
                        throws AudioRemoteException
```
    Loads sound effect resources.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the sound effects fail to be loaded.
    
    从以下版本开始:
    
    6
  - detachAudioEffects
```
public void detachAudioEffects()
                        throws AudioRemoteException
```
    Detaches sound effect resources.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the sound effects fail to be detached.
    
    从以下版本开始:
    
    6
  - isVolumeChangeForbidden
```
public boolean isVolumeChangeForbidden(Context context)
                                throws AudioRemoteException
```
    Checks whether device volume is fixed.
    Some devices may not support volume adjustment or may work at a fixed volume. You cannot mute or adjust volume of audio streams for these devices. In this case, this method returns true.
    
    参数:
    
    context - Indicates the application context.
    
    返回:
    
    Returns true if the device volume is fixed; returns false otherwise.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the operation fails.
    
    从以下版本开始:
    
    6
  - isBluetoothScoUsableNotInCall
```
public boolean isBluetoothScoUsableNotInCall(Context context)
                                      throws AudioRemoteException
```
    Checks whether the current device supports synchronous connection-oriented (SCO) links when it is not in a call.
    
    参数:
    
    context - Indicates the application context.
    
    返回:
    
    Returns true if SCO links are available when the device is not in a call; returns false otherwise.
    
    抛出:
    
    AudioRemoteException - Throws this exception if the operation fails.
    
    从以下版本开始:
    
    6

类 AudioManager

嵌套类概要

字段概要

构造器概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

DEFAULT_VOLUME

DEVICE_ID_BLUETOOTH

DEVICE_ID_SPEAKERPHONE

DEVICE_ID_WIRED_HEADSET

MARKER_WITH_SOUND

MARKER_WITH_VOLUME_BAR

RINGER_MODE_MAX

VOLUME_OP_DEC

VOLUME_OP_INC

VOLUME_OP_MAINTAIN

构造器详细资料

AudioManager

AudioManager

AudioManager

方法详细资料

getVersion

setVolume

setVolume

getVolume

getMinVolume

getMaxVolume

mute

unmute

isMute

setRingerMode

getRingerMode

setDeviceActive

isDeviceActive

activateAudioInterrupt

deactivateAudioInterrupt

setAudioParameter

getAudioParameter

registerAudioCapturerCallback

registerAudioRendererCallback

setAudioDeviceChangeObserver

removeAudioDeviceChangeObserver

unregisterAudioCapturerCallback

unregisterAudioRendererCallback

getActiveCapturerConfigs

getActiveRendererConfigs

getDevices

setMasterMute

setMicrophoneMute

isMicrophoneMute

getRingerUri

setRingerUri

getCallState

setCallState

changeVolumeBy

getMasterOutputSampleRate

getMasterOutputFrameCount

isStreamActive

connectBluetoothSco

disconnectBluetoothSco

makeSessionId

isMasterMute

attachAudioEffects

detachAudioEffects

isVolumeChangeForbidden

isBluetoothScoUsableNotInCall