Android Audio系统之RingerMode

田海立@CSDN

2012-04-11

本文介绍Android系统中Audio里的RingerMode。从使用的角度，只要关注第一节AudioManager中对于RingerMode的接口；后面章节讲解了AudioService中对于RingerMode的内部实现，以及如何改变RingerMode对某一个AudioStream的影响。

一、利用AudioManager使用RingerMode

RingerMode的获取与设置都是通过AudioManager来进行的。通过context.getSystemService(Context.AUDIO_SERVICE)获得AudioService的本地代理，然后通过调用AudioManager的getRingerMode()/setRingerMode()来获取当前的RingerMode或设置RingerMode。

RingerMode有三种：RINGER_MODE_SILENT,RINGER_MODE_VIBRATE和RINGER_MODE_NORMAL。

RingerMode设置之后，会有广播RINGER_MODE_CHANGED_ACTION发出，并且新的RingerMode会被设置在EXTRA_RINGER_MODE里，广播RINGER_MODE_CHANGED_ACTION的接收者时，可以通过Intent.getIntExtra(AudioManager.EXTRA_RINGER_MODE)获得更改过的RingerMode。

二、RingerMode在AudioService中内部实现

AudioManager不过是在本地的一个代理，具体的实现还是在AudioService中。

RingerMode在AudioService中通过mRingerMode记录；永久存储还是在Settings.System中，对应的设置项是MODE_RINGER，可通过Settings.System.getInt()/putInt()来操作。

《Android中的Audio播放：音量和远程播放控制》中描述的AudioStream是AndroidAudio系统的基础。因为设置RingerMode时，主要牵涉到静音操作，而Android的Audio音量和静音是按照AudioStream来设定的。

看AudioService中关于如何设置RingerMode的[方法setRingerModeInt()的实现]：

mRingerMode = ringerMode;
int numStreamTypes = AudioSystem.getNumStreamTypes();
for (int streamType = numStreamTypes – 1; streamType >= 0; streamType--) {
    if (isStreamMutedByRingerMode(streamType)) { 
        if (!isStreamAffectedByRingerMode(streamType) ||
                mRingerMode == AudioManager.RINGER_MODE_NORMAL) {
            mStreamStates[streamType].mute(null, false);    // unmute {streamType}
            mRingerModeMutedStreams &= ~(1<< streamType);
        }
    } else {
        if (isStreamAffectedByRingerMode(streamType) &&
                mRingerMode !=AudioManager.RINGER_MODE_NORMAL) {
            mStreamStates[streamType].mute(null, true);    // mute {streamType}
            mRingerModeMutedStreams |=~(1<< streamType);
        }
    }
}

• 改变RingerMode是否影响某一个AudioStream的音量（静音）是由isStreamAffectedByRingerMode(streamType:int) [Line#5 & Line#10]决定的，而该方法是检查mRingerModeAffectedStreams上针对该AudioStream的位上是否被置位，亦即，mRingerModeAffectedStreams是某个AudioStream是否受RingerMode影响的Bitmasks。
• 如果AudioStream被静音，则在mRingerModeMutedStreams的相应位上置位做标志。所以mRingerModeMutedStreams是标识AudioStream是否因为RingerMode的设置而静音的所有Stream的Bitmasks。
• RingerMode记录在mRingerMode，但永久存储是通过Settings.System，所以设置完具体的RingerMode之后，通过Settings.System.putInt(cr,Settings.System.MODE_RINGER, mRingerMode)保存当前的RingerMode。

三、配置RingerMode对特定AudioStream的影响

前节中讲到，某一个AudioStream是否受设置RingerMode影响是由mRingerModeAffectedStreams决定的，也就是即便设置RingerMode为静音/震动模式（RINGER_MODE_SILENT/RINGER_MODE_VIBRATE）之后， 某个AudioStream还不一定被设置为静音，而是否起作用，关键取决于mRingerModeAffectedStreams上对应于该AudioStream的位上取值。

mRingerModeAffectedStreams在AudioService中初始值是通过Settings.System.getInt(MODE_RINGER_STREAMS_AFFECTED, defVal)获取的

mRingerModeAffectedStreams= Settings.System.getInt(cr,Settings.System.MODE_RINGER_STREAMS_AFFECTED,
        ((1 << AUdioSystem.STREAM_RING) | (1 << AudioSystem.STREAM_NOTIFICATION) |
        (1 << AudioSystem.STREAM_SYSTEM)| (1<< AudioSystem.STREAM_SYSTEM_ENFORCED)));

可以看到，默认有四个AudioStream是受RingerMode设置的影响的。

这样，可以通过设置Settings.System.MODE_RINGER_STREAMS_AFFECTED来改变受RingerMode设置影响的AudioStream。

比如，Alarm的“静音模式下是否闹铃”的设置就是通过对AudioStreamSTREAM_ALARM的置位/去位实现的：

int ringerModeStreamTypes = Settings.System.getInt(cr, Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
if (pref.isChecked()) {
    // 静音模式下仍然闹铃，也就是Alarm不受RingerMode设置的影响
    ringerModeStreamTypes &= ~(1 << AudioManager.STREAM_ALARM);
} else {
    // 静音模式下不闹铃，也就是Alarm受RingerMode设置的影响
    ringerModeStreamTypes |= (1 << AudioManager.STREAM_ALARM);
}
Settings.System.putInt(cr, Settings.System.MODE_RINGER_STREAMS_AFFECTED, ringerModeStreamTypes);

一旦MODE_RINGER_STREAMS.AFFECTED被改变，AudioService中会重新获取并更新mRingerModeMutedStreams的值，并再通过setRingerModeInt()设置mRingerModeMutedStreams改变后的RingerMode。

AudioService中通过SettingObserver（继承ContentObserver）在侦听这个设置项的改变而实现的。

SettingObserver() {
    mContentResolver.registerContentObserver(Settings.System.getUriFor(Settings.System.MODE_RINGER_STREAMS_AFFECTED), false, this);
    // ...
}

@override
public void onChange(boolean selfChange) {
    // ...
    int ringerModeAffectedStreams = Settings.System.getInt(mContentResolver, Settings.System.MODE_RINGER_STREAMS_AFFECTED, 0);
    if (ringerModeAffectedStreams != mRingerModeAffectedStreams) {
        mRingerModeAffectedStreams = ringerModeAffectedStreams;
        setRingerModeInt(getRingerMode(), false);
    }
    // ...
}

总结

1. RingerMode由Android系统统一管理的；
2. 设置RingerMode是否影响某个AudioStream的设置是可配置的，可以通过配置来改变受RingerMode影响的AudioStream；
3. RingerMode有所改变，可以通过广播获知。