Android AudioManager

一个学渣的自我救赎

已于 2024-05-29 00:08:49 修改

阅读量1.8k

点赞数 29

于 2024-05-07 10:42:42 首次发布

本文链接：https://blog.csdn.net/liuning1985622/article/details/138522623

版权

Android Framework 同时被 2 个专栏收录

372 篇文章

订阅专栏

Android Audio

71 篇文章

订阅专栏

一、AudioManager相关类

1、AudioManager

AudioManager是Android系统提供的一个与音频相关的管理类，可以用于控制应用程序与系统的音频交互。它可以管理音频路由、控制音量、播放和暂停音频等操作。具体来说，AudioManager提供了以下几个方面的功能：

1、音频路由管理：可以访问系统的音频路由列表，并设置当前活动的音频路由。

2、音量管理：可以获取和设置当前的音量、静音状态和音量变化的监听器等。

3、音频焦点管理：可以控制播放和暂停音频、获取和释放音频焦点，保证优先级最高的音频应用程序能够正常工作。

4、铃声管理：可以设置铃声模式、获取铃声音量等。

5、回声消除：可以通过开启回声消除特性，消除声音和语音通话中出现的回声问题。

AudioManager 代码位于：

frameworks/base/media/java/android/media/AudioManager.java

AudioManager 的定义：

public class AudioManager {
    private class ServiceEventHandlerDelegate {}
    private static final class SafeWaitObject {}
    private static final class BlockingFocusResultReceiver {}
    public static abstract class AudioPlaybackCallback {}
    private static class AudioPlaybackCallbackInfo {}
    private final static class PlaybackConfigChangeCallbackData {}
    public static abstract class AudioRecordingCallback {}
    private static class AudioRecordingCallbackInfo {}
    private final static class RecordConfigChangeCallbackData {}
    private class OnAmPortUpdateListener implements AudioManager.OnAudioPortUpdateListener {}
    public abstract static class AudioServerStateCallback {}
    public abstract static class VolumeGroupCallback {}
    private final class CommunicationDeviceDispatcherStub
            extends ICommunicationDeviceDispatcher.Stub implements CallbackUtil.DispatcherStub {}
    class CallInjectionModeChangedListener implements OnModeChangedListener {}
    public abstract static class MuteAwaitConnectionCallback {}
    private final class MuteAwaitConnectionDispatcherStub {}
    private class NativeEventHandlerDelegate {}
    public interface OnAudioFocusChangeListener {
    public void onAudioFocusChange(int focusChange);
    }
}

二、AudioManager API

AudioManager API如下：

音量相关

void adjustVolume(int direction,int flags)：调整最相关的数据流的音量。
void adjustStreamVolume(int streamType, int direction, int flags)：调整指定类型的声音。
void setStreamVolume (int streamType, int index, int flags)：直接设置指定类型的音量值。
void setStreamMute(int streamType,booleanstate)：将指定类型的声音调整为静音。
int getStreamVolume(int streamType)：返回特定数据流的当前音量索引。
int getStreamMaxVolume(int streamType)：返回特定流的最大音量指数。

麦克风相关

setMicrophoneMute(boolean on)：设置是否让麦克风静音。
boolean isMicrophoneMute()：检查是否打开或关闭麦克风静音。

音频焦点相关

int requestAudioFocus(AudioFocusRequest focusRequest)：请求音频的焦点。
int requestAudioFocus(AudioManager.OnAudioFocusChangeListener l,int streamType,int durationHint)：请求音频的焦点。
int abandonAudioFocus(AudioFocusRequest focusRequest)：放弃音频焦点
int abandonAudioFocus(AudioManager.OnAudioFocusChangeListenerl)：放弃音频的焦点。
interface OnAudioFocusChangeListener{void onAudioFocusChange(int focusChange)}：音频焦点变化监听器

音频配置信息相关

void registerAudioRecordingCallback(@NonNull AudioRecordingCallback cb, Handler handler)；注册AudioRecording回调
void unregisterAudioRecordingCallback(@NonNull AudioRecordingCallback cb)；解除注册AudioRecording回调
List<AudioRecordingConfiguration> getActiveRecordingConfigurations()：获取音频录制的相关配置信息。
void registerAudioPlaybackCallback(@NonNull AudioPlaybackCallback cb, Handler handler)；注册registerAudioPlaybackCallback回调
void unregisterAudioPlaybackCallback(@NonNull AudioPlaybackCallback cb) ;解除注册registerAudioPlaybackCallback回调
List<AudioPlaybackConfiguration> getActivePlaybackConfigurations() ；获取音频播放任务的相关配置信息。

按键音相关

public void playSoundEffect(@SystemSoundEffect int effectType)：播放按键音
public void playSoundEffect(@SystemSoundEffect int effectType, int userId) ：播放按键音
public void playSoundEffect(@SystemSoundEffect int effectType, float volume) ：播放按键音
public void loadSoundEffects() ：加载按键音效
public void unloadSoundEffects() ：卸载按键音效

其他

void setMode(int mode)：设置声音模式。
int getMode()：返回当前音频模式。
void setRingerMode(int ringerMode)：设置手机电话铃声的模式。
int getRingerMode()：返回当前的铃声模式。
void setParameters(String keyValuePairs)：设置一个音频硬件数量可变的参数值。
String getParameters(String keys)：给音频硬件设置一个varaible数量的参数值。
void setVibrateSetting (int vibrateType, int vibrateSetting)：设置设置时应该振动的振动类型。
int getVibrateSetting(int vibrateType)：返回是否该用户的振动设置为振动类型。
setSpeakerphoneOn(boolean on)：设置扬声器打开或关闭。
isSpeakerphoneOn()：检查是否打开或关闭扬声器。
boolean isMusicActive()：检查是否有音乐处于活跃状态。
interface OnAudioFocusChangeListener：监听音频焦点变化。
interface OnModeChangedListener：监听音频模式的变化。
interface OnCommunicationDeviceChangedListener：监听连接设备变化。

其中setMode/getMode用于设置/获取音频管理器的工作模式，Mode定义如下：

模式（Mode）	描述
MODE_NORMAL	普通模式，用于正常的音频播放
MODE_RINGTONE	铃声模式，用于电话铃声播放
MODE_IN_CALL	电话通话模式，用于电话通话时的音频管理
MODE_IN_COMMUNICATION	通信模式，用于VoIP应用程序通话时的音频管理

其中setRingerMode/getRingerMode用于设定/获取ringerMode，ringerMode定义如下：

铃声模式（ringerMode）	描述
RINGER_MODE_SILENT	静音模式，设备不会播放铃声，而是会震动、闪光或完全静音。
RINGER_MODE_VIBRATE	震动模式，设备会震动而不播放铃声。
RINGER_MODE_NORMAL	正常模式，设备播放指定的铃声。

其中setStreamVolume/adjustStreamVolume/getStreamVolume用于设定/获取Stream Volume，streamType定义如下：

streamType	描述
STREAM_ALARM	闹钟
STREAM_DTMF	双音多频,拨号键的
STREAM_MUSIC	音乐，即媒体
STREAM_NOTIFICATION	通知
STREAM_RING	铃声
STREAM_SYSTEM	系统
STREAM_VOICE_CALL	通话

其中adjustVolume需要指定direction和Flag，direction定义如下：

direction	描述
ADJUST_RAISE	增加音量
ADJUST_LOWER	减小音量
ADJUST_MUTE	静音
ADJUST_UNMUTE	取消静音

Flag定义如下：

FLAG	描述
FLAG_SHOW_UI	调整时显示音量条（就是按音量键出现的那个）
FLAG_PLAY_SOUND	改变音量时播放声音
FLAG_VIBRATE	手机铃声进入振动铃声模式是否振动
FLAG_ALLOW_RINGER_MODES	更改音量时是否切换模式，比如响铃音量设置为0时是否开启震动模式
FLAG_SHOW_SILENT_HINT	由于静音模式，无法调整音量，请在用户界面中显示提示。
FLAG_ACTIVE_MEDIA_ONLY	指示仅当媒体正在活动播放时才应处理此问题。
FLAG_SHOW_UI_WARNINGS	就像FLAG_SHOW_UI，但是只有对话框警告和确认，没有滑块。
FLAG_SHOW_VIBRATE_HINT	阻止将音量从振动调低，在用户界面中显示提示。