android 按鍵聲音

l_serein發表於2012-05-17

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, -1null0);  
  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, 001.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)繫結了起來。

相關文章