android 按鍵聲音

1.Android的audio流的型別有以下12種：

1. /* The audio stream for phone calls */  
2.     public static final int STREAM_VOICE_CALL = 0;//通話連線時的音訊流（通話聲）  
3.     /* The audio stream for system sounds */  
4.     public static final int STREAM_SYSTEM = 1;//系統音訊流  
5.     /* The audio stream for the phone ring and message alerts */  
6.     public static final int STREAM_RING = 2;//來電鈴聲  
7.     /* The audio stream for music playback */  
8.     public static final int STREAM_MUSIC = 3;//媒體音訊流  
9.     /* The audio stream for alarms */  
10.     public static final int STREAM_ALARM = 4;//鬧鐘音訊流  
11.     /* The audio stream for notifications */  
12.     public static final int STREAM_NOTIFICATION = 5;//通知音訊流  
13.     /* @hide The audio stream for phone calls when connected on bluetooth */  
14.     public static final int STREAM_BLUETOOTH_SCO = 6;//從註釋上看時使用藍芽耳機通話的音訊流  
15.     /* @hide The audio stream for enforced system sounds in certain countries (e.g camera in Japan) */  
16.     public static final int STREAM_SYSTEM_ENFORCED = 7;//一些國家強制使用的音訊流？？不太明白  
17.     /* @hide The audio stream for DTMF tones */  
18.     public static final int STREAM_DTMF = 8;//DTMF音訊流  
19.     /* @hide The audio stream for text to speech (TTS) */  
20.     public static final int STREAM_TTS = 9;//TTS: Text to Speech:檔案到語言的音訊流，即機器說話  
21.     /* @hide The audio stream for Fm */  
22.     public static final int STREAM_FM = 10;//FM的音訊流  
23.     /* @hide The audio stream for MATV */  
24.     public static final int STREAM_MATV = 11;//TV的音訊流 

每種音訊流所規定的最大值：

1. /** @hide Maximum volume index values for audio streams */  
2.  private int[] MAX_STREAM_VOLUME = new int[] {  
3.      6,  // STREAM_VOICE_CALL  
4.      7,  // STREAM_SYSTEM  
5.      7,  // STREAM_RING  
6.      12, // STREAM_MUSIC  
7.      7,  // STREAM_ALARM  
8.      7,  // STREAM_NOTIFICATION  
9.      15, // STREAM_BLUETOOTH_SCO  
10.      7,  // STREAM_SYSTEM_ENFORCED  
11.      15, // STREAM_DTMF  
12.      15, // STREAM_TTS  
13.      13, //STREAM_FM  
14.      13  //stream_MATV  
15.  };  

2.所有的按鍵事件都是touch事件，這部分我會另外開篇博文介紹。

開始本文正文，Anndroid系統中所有View帶有按鍵音，使用者可以通過Settings>Sound>勾選Audible Selection即可開啟按鍵音。但是有個奇怪的地方：此按鍵音是與媒體音量（即STREAM_MUSIC）繫結的，難道按鍵音的STREAM TYPE就是STREAM_MUSIC嗎？我們從程式碼中尋找一下。

首先所有的View點選的時候都有按鍵音，我們從View.java的點選事件找起，在view的響應的onTouchEvent（）方法中有如下程式碼：

1. switch (event.getAction()) {  
2.                case MotionEvent.ACTION_UP:  
3.                    boolean prepressed = (mPrivateFlags & PREPRESSED) != 0;  
4.                    if ((mPrivateFlags & PRESSED) != 0 || prepressed) {  
5.                        // take focus if we don't have it already and we should in  
6.                        // touch mode.  
7.                        boolean focusTaken = false;  
8.                        if (isFocusable() && isFocusableInTouchMode() && !isFocused()) {  
9.                            focusTaken = requestFocus();  
10.                        }  
11.   
12.                        if (!mHasPerformedLongPress) {  
13.                            // This is a tap, so remove the longpress check  
14.                            removeLongPressCallback();  
15.   
16.                            // Only perform take click actions if we were in the pressed state  
17.                            if (!focusTaken) {  
18.                                // Use a Runnable and post this rather than calling  
19.                                // performClick directly. This lets other visual state  
20.                                // of the view update before click actions start.  
21.                                if (mPerformClick == null) {  
22.                                    mPerformClick = new PerformClick();  
23.                                }  
24.                                if (!post(mPerformClick)) {  
25.                                    performClick();//這裡響應click事件  
26.                                }  
27.                            }  
28.                        }  
29.   
30.                        if (mUnsetPressedState == null) {  
31.                            mUnsetPressedState = new UnsetPressedState();  
32.                        }  
33.   
34.                        if (prepressed) {  
35.                            mPrivateFlags |= PRESSED;  
36.                            refreshDrawableState();  
37.                            postDelayed(mUnsetPressedState,  
38.                                    ViewConfiguration.getPressedStateDuration());  
39.                        } else if (!post(mUnsetPressedState)) {  
40.                            // If the post failed, unpress right now  
41.                            mUnsetPressedState.run();  
42.                        }  
43.                        removeTapCallback();  
44.                    }  
45.                    break;  

1. public boolean performClick() {  
2.     sendAccessibilityEvent(AccessibilityEvent.TYPE_VIEW_CLICKED);  
3.   
4.     if (mOnClickListener != null) {  
5.         playSoundEffect(SoundEffectConstants.CLICK);  
6.         mOnClickListener.onClick(this);  
7.         return true;  
8.     }  
9.   
10.     return false;  
11. }  

從這裡可以看到與使用者介面onClickListener結合起來了，當使用者註冊了clickListener，則呼叫發出按鍵音函式playSoundEffect ()和響應使用者寫好的clickListener的onClick()方法。這裡playSoundEffect函式傳的引數SoundEffectContants.CLICK為多少呢，從SoundEffectConstants.java可知SoundEffectConstants.CLICK = 0:

1. public class SoundEffectConstants  
2. {  
3. SoundEffectConstants() { throw new RuntimeException("Stub!"); }  
4. public static  int getContantForFocusDirection(int direction) { throw new RuntimeException("Stub!"); }  
5. public static final int CLICK = 0;  
6. public static final int NAVIGATION_LEFT = 1;  
7. public static final int NAVIGATION_UP = 2;  
8. public static final int NAVIGATION_RIGHT = 3;  
9. public static final int NAVIGATION_DOWN = 4;  
10. }  

playSoundEffect ()的具體內容如下：

1. public void playSoundEffect(int soundConstant) {  
2.     if (mAttachInfo == null || mAttachInfo.mRootCallbacks == null || !isSoundEffectsEnabled()) {  
3.         return;  
4.     }  
5.     mAttachInfo.mRootCallbacks.playSoundEffect(soundConstant);  
6. }  

真正呼叫的是AttachInfo Callbacks介面的playSoundEffect()函式：

1. /** 
2.     * A set of information given to a view when it is attached to its parent 
3.     * window. 
4.     */  
5.    static class AttachInfo {  
6.        interface Callbacks {  
7.            void playSoundEffect(int effectId);  
8.            boolean performHapticFeedback(int effectId, boolean always);  
9.        }  

看註釋可知其真正的方法寫在parent window中，那parent window是哪個呢？ViewRoot的實現該回撥介面：

1. public final class ViewRoot extends Handler implements ViewParent,  
2.         View.AttachInfo.Callbacks {  

具體的playSoundEffect()函式內容：

1. public void playSoundEffect(int effectId) {  
2.         checkThread();  
3.   
4.         try {  
5.             final AudioManager audioManager = getAudioManager();  
6.   
7.             switch (effectId) {  
8.                 case SoundEffectConstants.CLICK:  
9.                     audioManager.playSoundEffect(AudioManager.FX_KEY_CLICK);  
10.                     return;  
11.                 case SoundEffectConstants.NAVIGATION_DOWN:  
12.                     audioManager.playSoundEffect(AudioManager.FX_FOCUS_NAVIGATION_DOWN);  
13.                     return;  
14.                 case SoundEffectConstants.NAVIGATION_LEFT:  
15.                     audioManager.playSoundEffect(AudioManager.FX_FOCUS_NAVIGATION_LEFT);  
16.                     return;  
17.                 case SoundEffectConstants.NAVIGATION_RIGHT:  
18.                     audioManager.playSoundEffect(AudioManager.FX_FOCUS_NAVIGATION_RIGHT);  
19.                     return;  
20.                 case SoundEffectConstants.NAVIGATION_UP:  
21.                     audioManager.playSoundEffect(AudioManager.FX_FOCUS_NAVIGATION_UP);  
22.                     return;  
23.                 default:  
24.                     throw new IllegalArgumentException("unknown effect id " + effectId +  
25.                             " not defined in " + SoundEffectConstants.class.getCanonicalName());  
26.             }  
27.         } catch (IllegalStateException e) {  
28.             // Exception thrown by getAudioManager() when mView is null  
29.             Log.e(TAG, "FATAL EXCEPTION when attempting to play sound effect: " + e);  
30.             e.printStackTrace();  
31.         }  
32.     }  

我們傳入的引數為SoundEffectContants.CLICK，呼叫AudioManager的playSoundEffect()方法，引數為AudioManger.FX_KEY_CLICK，繼續往下看，在AudioManager.java中playSoundEffect()方法：

1. public void  playSoundEffect(int effectType) {  
2.     if (effectType < 0 || effectType >= NUM_SOUND_EFFECTS) {  
3.         return;  
4.     }  
5.   
6.     if (!querySoundEffectsEnabled()) {  
7.         return;  
8.     }  
9.   
10.     IAudioService service = getService();  
11.     try {  
12.         service.playSoundEffect(effectType);  
13.     } catch (RemoteException e) {  
14.         Log.e(TAG, "Dead object in playSoundEffect"+e);  
15.     }  
16. }  

呼叫了IAudioService的playSoundEffect() 方法，IAudioService方法是使用aidl生成的介面，aidl原始檔：frameworks/base/media/java/android/media/IAudioService.aidl，真正響應的地方在AudioService.java中：

1. /** @see AudioManager#playSoundEffect(int) */  
2. public void playSoundEffect(int effectType) {  
3.     sendMsg(mAudioHandler, MSG_PLAY_SOUND_EFFECT, SHARED_MSG, SENDMSG_NOOP,  
4.             effectType, -1, null, 0);  
5. }  

該方法呼叫sendMsg()方法，傳入一下引數：（mAudioHandler,  7, -1, 1, 0, -1, null, 0）,sendMsg()方法如下:

1. private static void sendMsg(Handler handler, int baseMsg, int streamType,  
2.         int existingMsgPolicy, int arg1, int arg2, Object obj, int delay) {  
3.     int msg = (streamType == SHARED_MSG) ? baseMsg : getMsg(baseMsg, streamType);  
4.   
5.     if (existingMsgPolicy == SENDMSG_REPLACE) {  
6.         handler.removeMessages(msg);  
7.     } else if (existingMsgPolicy == SENDMSG_NOOP && handler.hasMessages(msg)) {  
8.         Log.d(TAG, "sendMsg: Msg " + msg + " existed!");  
9.         return;  
10.     }  
11.   
12.     handler  
13.             .sendMessageDelayed(handler.obtainMessage(msg, arg1, arg2, obj), delay);  
14. }  

該方法就是將傳入的引數經過計算，obtain一個message，message的what = 7 arg1 = 0 arg2 = -1 object = null; 處理該訊息的地方handleMessage （）：

1. @Override  
2.         public void handleMessage(Message msg) {  
3.             int baseMsgWhat = getMsgBase(msg.what);  
4.   
5.             switch (baseMsgWhat) {  
6.   
7. ...  
8.   
9.                 case MSG_PLAY_SOUND_EFFECT:  
10.                     playSoundEffect(msg.arg1, msg.arg2);  
11.                     break;  
12. ...  
13.   
14. }  

呼叫了帶兩個引數的playSoundEffect()函式，傳入引數 0，-1：

1. private void playSoundEffect(int effectType, int volume) {  
2.     synchronized (mSoundEffectsLock) {  
3.   
4.         if (mSoundPool == null) {  
5.             return;  
6.         }  
7.         float volFloat;  
8.         // use STREAM_MUSIC volume attenuated by 3 dB if volume is not specified by caller  
9.         if (volume < 0) {  
10.             //以下計算播放的音量大小：  
11.                  // Same linear to log conversion as in native AudioSystem::linearToLog() (AudioSystem.cpp)  
12.             float dBPerStep = (float)((0.5 * 100) / MAX_STREAM_VOLUME[AudioSystem.STREAM_MUSIC]);  
13.             int musicVolIndex = (mStreamStates[AudioSystem.STREAM_MUSIC].mIndex + 5) / 10;  
14.             float musicVoldB = dBPerStep * (musicVolIndex - MAX_STREAM_VOLUME[AudioSystem.STREAM_MUSIC]);  
15.             volFloat = (float)Math.pow(10, (musicVoldB - 3)/20);  
16.         } else {  
17.             volFloat = (float) volume / 1000.0f;  
18.         }  
19.         if (SOUND_EFFECT_FILES_MAP[effectType][1] > 0) {  
20.   
21.             mSoundPool.play(SOUND_EFFECT_FILES_MAP[effectType][1], volFloat, volFloat, 0, 0, 1.0f);//呼叫該函式播放按鍵音  
22.         } else {  
23.           
24.             MediaPlayer mediaPlayer = new MediaPlayer();  
25.             if (mediaPlayer != null) {  
26.                 try {  
27.                     String filePath = Environment.getRootDirectory() + SOUND_EFFECTS_PATH + SOUND_EFFECT_FILES[SOUND_EFFECT_FILES_MAP[effectType][0]];  
28.                     mediaPlayer.setDataSource(filePath);  
29.                     mediaPlayer.setAudioStreamType(AudioSystem.STREAM_RING);  
30.                     mediaPlayer.prepare();  
31.                     mediaPlayer.setVolume(volFloat, volFloat);  
32.                     mediaPlayer.setOnCompletionListener(new OnCompletionListener() {  
33.                         public void onCompletion(MediaPlayer mp) {  
34.                             cleanupPlayer(mp);  
35.                         }  
36.                     });  
37.                     mediaPlayer.setOnErrorListener(new OnErrorListener() {  
38.                         public boolean onError(MediaPlayer mp, int what, int extra) {  
39.                             cleanupPlayer(mp);  
40.                             return true;  
41.                         }  
42.                     });  
43.                     mediaPlayer.start();  
44.                 } catch (IOException ex) {  
45.                     Log.w(TAG, "MediaPlayer IOException: "+ex);  
46.                 } catch (IllegalArgumentException ex) {  
47.                     Log.w(TAG, "MediaPlayer IllegalArgumentException: "+ex);  
48.                 } catch (IllegalStateException ex) {  
49.                     Log.w(TAG, "MediaPlayer IllegalStateException: "+ex);  
50.                 }  
51.             }  
52.         }  
53.     }  
54. }  

因為傳入的引數volume為-1，按鍵音大小的值走if（volume < 0）內，函式中此部分計算的是按鍵音的大小volFloat，可以看出，整個計算過程都跟媒體音量STREAM_MUSIC有關，這裡就看出，按鍵音的音量大小是與STREAM_MUSIC繫結的，那按鍵音的型別呢？繼續看下去，函式 mSoundPool.play(SOUND_EFFECT_FILES_MAP[effectType][1], volFloat, volFloat, 0, 0, 1.0f);中使用了SoundPool來播放按鍵音，我們看看該SoundPool初始化步驟，在AudioService初始化時，呼叫了loadSoundEffects()函式：

1. public AudioService(Context context) {  
2. ......  
3.         loadSoundEffects();  
4. .......  
5.     }  

loadSoundEffects()函式的具體實現如下：

1.  public boolean loadSoundEffects() {  
2.        synchronized (mSoundEffectsLock) {  
3.            if (mSoundPool != null) {  
4.                return true;  
5.            }  
6.            mSoundPool = new SoundPool(NUM_SOUNDPOOL_CHANNELS, AudioSystem.STREAM_SYSTEM, 0);  
7.   
8.           ......  
9.   
10.        return true;  
11. }  

在此函式中，初始化了該SoundPool，型別為STREAM_SYSTEM。

到這裡，結果出來了，android中，view的按鍵音型別為系統音訊（STREAM_SYSTEM)，而音量的大小與媒體音量（STREAM_MUSIC）繫結了起來。