Android4.0.3中的提示音

一、ToneGenerator的使用

参照com.android.contacts.dialpad.DialpadFragment

ToneGenerator只能播放在ToneGenerator中定义好的TONE_TYPE。

1、常量申明

/** Tone音的长度，单位：milliseconds */
private static final int TONE_LENGTH_MS = 150;
/** 主音量的比例：以80%的主音量播放Tone音 */
private static final int TONE_RELATIVE_VOLUME = 80;
/** 主音量的音频种别 */
private static final int DIAL_TONE_STREAM_TYPE =AudioManager.STREAM_MUSIC;

2、变量申明

// Tone音播放器
private ToneGenerator mToneGenerator;
// Tone相关的同步锁
private Object mToneGeneratorLock = new Object();
// 设定中的Tone音播放设置
private boolean mDTMFToneEnabled;

3、Tone的初始化

public void onResume() {
    super.onResume();
    // 读取设定的值
    mDTMFToneEnabled =Settings.System.getInt(getActivity().getContentResolver(),
           Settings.System.DTMF_TONE_WHEN_DIALING, 1) == 1;
 
    // 失败了也无所谓，不是啥重要的东西
    synchronized (mToneGeneratorLock) {
        if (mToneGenerator == null) {
            try {
                // we want the user to be ableto control the volume of the dial tones
                // outside of a call, so we usethe stream type that is also mapped to the
                // volume control keys for thisactivity
                mToneGenerator = newToneGenerator(DIAL_TONE_STREAM_TYPE, TONE_RELATIVE_VOLUME);
               getActivity().setVolumeControlStream(DIAL_TONE_STREAM_TYPE);
            } catch (RuntimeException e) {
                Log.w(TAG, "Exceptioncaught while creating local tone generator: " + e);
                mToneGenerator = null;
            }
        }
    }
}

4、释放Tone资源

public voidonPause() {
    super.onPause();
 
    synchronized (mToneGeneratorLock) {
        if (mToneGenerator != null) {
            mToneGenerator.release();
            mToneGenerator = null;
        }
    }
}

5、播放Tone音

/**
 * 播放TONE_LENGTH_MS milliseconds的Tone音.
 * 只有在设定中选择了播放Tone，并且不是静音模式才会播放Tone音。
 * @param tone a tone code from {@linkToneGenerator}
 */
void playTone(int tone) {
    // 设定中没有选中的话，就不播
    if (!mDTMFToneEnabled) {
        return;
    }
 
    // 静音模式的时候也不播，需要每次都检查，因为没有Activity切换也能设成静音模式
    // 设定中的那个就不需要，因为要设定必须要先切入设定Activity才行
    AudioManager audioManager =
            (AudioManager)getActivity().getSystemService(Context.AUDIO_SERVICE);
    int ringerMode =audioManager.getRingerMode();
    if ((ringerMode == AudioManager.RINGER_MODE_SILENT)
        || (ringerMode ==AudioManager.RINGER_MODE_VIBRATE)) {
        return;
    }
 
    synchronized (mToneGeneratorLock) {
        if (mToneGenerator == null) {
            Log.w(TAG, "playTone:mToneGenerator == null, tone: " + tone);
            return;
        }
 
        // Start the new tone (will stop anyplaying tone)
        mToneGenerator.startTone(tone,TONE_LENGTH_MS);
    }
}

二、ToneGenerator的实现

相关代码位置：

ToneGenerator.java：ICS/frameworks/base/media/java/

Android_media_ToneGenerator.cpp：ICS/frameworks/base/core/jni/

ToneGenerator.cpp：ICS/frameworks/base/media/libmedia/

1、ToneGenerator.java

定义了多种ToneType，提供了java的接口

2、Android_media_ToneGenerator.cpp

将Java层的请求转发给Native层。

android_media_ToneGenerator_native_setup中的有句话看不懂：

ToneGenerator *lpToneGen= new ToneGenerator(streamType, AudioSystem::linearToLog(volume),true);
// change this value tochange volume scaling
static const float dBPerStep= 0.5f;
// shouldn't need totouch these
static const floatdBConvert = -dBPerStep * 2.302585093f / 20.0f;
static const floatdBConvertInverse = 1.0f / dBConvert;
 
floatAudioSystem::linearToLog(int volume)
{
    // float v = volume ? exp(float(100 -volume) * dBConvert) : 0;
    // LOGD("linearToLog(%d)=%f",volume, v);
    // return v;
    return volume ? exp(float(100 - volume) *dBConvert) : 0;
}

算出来的值会直接设到AudioTrack中，可是AudioTrack中的音量应该是个0～1.0f的百分比才对，为啥需要这么个公式呢，难道是Bug。应该测试一下！！

3、ToneGenerator.cpp

根据定义的Tone因的频率，长度等信息生成音频数据，最后交给AudioTrack播放。

三、AudioPolicyService中的mTonePlaybackThread

本来以为这个线程是专门处理Tone音设备的，可是根据上面一看原来是直接走AudioTrack的。这就奇怪了，并且AudioSystem中也没有提供对应的接口，这就更奇怪了，难道它没准备让外面的人用。再一检索，发现原来它是提供给AudioPolicyManagerBase使用的一个非同期播放Tone音的接口。

经过AudioCommandThread的处理，最终还是交给ToneGenerator来处理。

四、RingtoneManager与Ringtone

播放铃声的类，没具体看，最后是通过MediaPlayer来播放的。

五、结论

本来还以为会有个单独硬件来处理Tone音的，最后发现竟然是自动生成后，通过AudioTrack来处理的。

据说是因为硬件生成的Tone音很难听，所以才用软件来生成的。