本文主要涉及AudioService。還是基于5.1.1版本的代碼。
AudioService.java文件位于/framework/base/media/java/android/208522.html">android/57360.html">android/210528.html">android/media/下。
音量控制是AudioService最重要的功能之一。先總結一下:
Andorid5.1在AudioSystem.java定義了有10種流類型。每種流類型的音量都是相互獨立的,Android也在AudioService.java定義了幾個數組:MAX_STREAM_VOLUME(最大音量),DEFAULT_STREAM_VOLUME(默認音量大小),STREAM_VOLUME_ALIAS_VOICE(映射的流類型)。
雖然Android5.1中擁有10種流類型,但是為了便于使用,android通過判斷設備的類型,去映射具體流類型。Android5.1在AudioSystem.java中提供了3個設備(DEFAULT,VOICE,TELEVISION)作為可選擇項,分別去映射我們具體的音頻流類型。其中,DEFAULT和VOICE類型的音頻映射是一致的。

所以,從上表中可以看出,在手機設備當中,我們當前可調控的流類型音量其實只有5個,當你想調節STREAM_SYSTEM,STREAM_NOTIFICATION等流類型的音量時,實際上是調節了STREAM_RING的音量。當前可控的流類型可以通過下表更直觀地顯示:

音量鍵處理流程

先看到AudioService的adjustSuggestedStreamVolume()方法。
第一個參數direction指示了音量的調整方向,1為增大,-1為減小;第二個參數suggestedStreamType表示要求調整音量的流類型;第三個參數flags,其實是在AudioManager在handleKeyDown()中設置了兩個flags,分別是FLAG_SHOW_UI和FLAG_VIBRATE。前者告訴AudioService需要彈出一個音量控制面板。而在handleKeyUp()里設置了FLAG_PLAY_SOUND,這是為什么在松開音量鍵后”有時候“(在特定的流類型下,且沒有處于鎖屏狀態)會有一個提示音。
// 1.確定要調整音量的流類型 2.在某些情況下屏蔽FLAG_PLAY_SOUND 3.調用adjustStreamVolume() private void adjustSuggestedStreamVolume(int direction, int suggestedStreamType, int flags, String callingPackage, int uid) { ...... //從這一小段代碼中可以看出,在AudioService中還有地方可以強行改變音量鍵控制的流類型。 //mVolumeControlStream是VolumePanel通過forceVolumeControlStream()設置的, //VolumePanel顯示時會調用forceVolumeControlStream強制后續的音量鍵操作固定為促使它顯示的那個流類型, //并在它關閉時取消這個強制設置,設值為-1 if (mVolumeControlStream != -1) { streamType = mVolumeControlStream; } else { //通過getActiveStreamType()函數獲取要控制的流類型,這里根據建議的流類型與AudioService的實際情況,返回一個值 streamType = getActiveStreamType(suggestedStreamType); } final int resolvedStream = mStreamVolumeAlias[streamType]; ...... adjustStreamVolume(streamType, direction, flags, callingPackage, uid); } 接著看看adjustStreamVolume()
private void adjustStreamVolume(int streamType, int direction, int flags, String callingPackage, int uid) { ...... ensureValidDirection(direction); //確認一下調整的音量方向 ensureValidStreamType(streamType); //確認一下調整的流類型 int streamTypeAlias = mStreamVolumeAlias[streamType];//獲取streamType映射到的流類型 //VolumeStreamState類,保存與一個流類型所有音量相關的信息 VolumeStreamState streamState = mStreamStates[streamTypeAlias]; final int device = getDeviceForStream(streamTypeAlias); int aliasIndex = streamState.getIndex(device);//獲取當前音量 ...... //rescaleIndex用于將音量值的變化量從源流類型變換到目標流類型下, //由于不同的流類型的音量調節范圍不同,所以這個轉換是必需的 step = rescaleIndex(10, streamType, streamTypeAlias); } ...... final int result = checkForRingerModeChange(aliasIndex, direction, step); adjustVolume = (result & FLAG_ADJUST_VOLUME) != 0; //布爾變量,用來表示是否有必要繼續設置音量值 ...... int oldIndex = mStreamStates[streamType].getIndex(device);//取出調整前的音量值。這個值會在sendVolumeUpdate()調用 if (adjustVolume && (direction != AudioManager.ADJUST_SAME)) { ...... if ((direction == AudioManager.ADJUST_RAISE) && !checkSafeMediaVolume(streamTypeAlias, aliasIndex + step, device)) { Log.e(TAG, "adjustStreamVolume() safe volume index = "+oldIndex); mVolumeController.postDisplaySafeVolumeWarning(flags); //判斷streamState.adjustIndex返回值,如果音量值在調整之后并沒有發生變化,比如到了最大值,就不需要繼續后面的操作了 } else if (streamState.adjustIndex(direction * step, device)) { //這個消息將把音量設置到底層去,并將其存儲到Settingsprovider中 sendMsg(mAudioHandler, MSG_SET_DEVICE_VOLUME, SENDMSG_QUEUE, device, 0, streamState, 0); } ...... int index = mStreamStates[streamType].getIndex(device); sendVolumeUpdate(streamType, oldIndex, index, flags);// 通知外界音量值發生了變化 }總結一下這個函數:
checkForRingerModeChange()和情景模式有關。adjustIndex()更改VolumeStreamState對象中保存的音量值。sendVolumeUpdate()函數,通知外界音量值發生了變化。 下面將分析adjustIndex()、MSG_SET_DEVICE_VOLUME消息的處理和sendVolumeUpdate()。
先看到VolumeStreamState類的adjustIndex()
//更改VolumeStreamState對象中保存的音量值 public boolean adjustIndex(int deltaIndex, int device) { return setIndex(getIndex(device) + deltaIndex, device);// 將現有的音量值加上變化量,然后調用setIndex進行設置 } public boolean setIndex(int index, int device) { ...... mIndex.put(device, index);//保存設置的音量值 if (oldIndex != index) { //同時設置所有映射到當前流類型的其他流的音量 boolean currentDevice = (device == getDeviceForStream(mStreamType)); int numStreamTypes = AudioSystem.getNumStreamTypes(); for (int streamType = numStreamTypes - 1; streamType >= 0; streamType--) { if (streamType != mStreamType && mStreamVolumeAlias[streamType] == mStreamType) { int scaledIndex = rescaleIndex(index, mStreamType, streamType); mStreamStates[streamType].setIndex(scaledIndex, device); if (currentDevice) { mStreamStates[streamType].setIndex(scaledIndex, getDeviceForStream(streamType)); } } } return true; } else { return false; } } } 可以看出,VolumeStreamState.adjustIndex()除了更新自己所保存的音量值外,沒有做其他的事情。接下來看看MSG_SET_DEVICE_VOLUME消息處理做了什么。
case MSG_SET_DEVICE_VOLUME: setDeviceVolume((VolumeStreamState) msg.obj, msg.arg1); break;
private void setDeviceVolume(VolumeStreamState streamState, int device) { synchronized (VolumeStreamState.class) { streamState.applyDeviceVolume_syncVSS(device);//這個函數會調用AudioSystem.setStreamVolumeIndex(), //到這,音量就被設置到底層的AudioFlinger中 // 對所有流應用更改,使用此別名作為別名。處理流音量映射的情況 int numStreamTypes = AudioSystem.getNumStreamTypes(); for (int streamType = numStreamTypes - 1; streamType >= 0; streamType--) { ...... } //發送消息,其處理函數將會調用persitVolume()函數,這將會把音量的設置信息存儲到SettingsProvide中。 //Audioservice在初始化時,將會從SettingsProvide中將音量設置讀取出來并進行設置 sendMsg(mAudioHandler, MSG_PERSIST_VOLUME, SENDMSG_QUEUE, device, 0, streamState, PERSIST_DELAY); } 最后看到sendVolumeUpdate()
// UI update and Broadcast Intent private void sendVolumeUpdate(int streamType, int oldIndex, int index, int flags) { //判斷設備是否擁有通話功能。對沒有通話能力的設備來說,RING流類型自然也就沒有意義了。這句話應該算是一種從語義操作上進行的保護 if (!isPlatformVoice() && (streamType == AudioSystem.STREAM_RING)) { streamType = AudioSystem.STREAM_NOTIFICATION; } if (streamType == AudioSystem.STREAM_MUSIC) { flags = updateFlagsForSystemAudio(flags); } mVolumeController.postVolumeChanged(streamType, flags);//最后將顯示系統音量條的提示框 if ((flags & AudioManager.FLAG_FIXED_VOLUME) == 0) { oldIndex = (oldIndex + 5) / 10; //+5的意義是實現四舍五入;除以10是因為存儲時先乘了10,轉換過程中保留小數點后一位的精度 index = (index + 5) / 10; Intent intent = new Intent(AudioManager.VOLUME_CHANGED_ACTION); intent.putExtra(AudioManager.EXTRA_VOLUME_STREAM_TYPE, streamType); intent.putExtra(AudioManager.EXTRA_VOLUME_STREAM_VALUE, index); intent.putExtra(AudioManager.EXTRA_PREV_VOLUME_STREAM_VALUE, oldIndex); sendBroadcastToAll(intent); } } mVolumeController.postVolumeChanged()方法將會調用到mController.volumeChanged()方法,通過AIDL將調用到VolumeUI.java文件中的VolumeController.volumeChanged()方法,最后將會調用mPanel.postVolumeChanged更新系統音量條的UI,這里就是VolumePanel的內容啦,具體可看上一篇文章系統音量條
通過音量設置函數setStreamVolume()
除了音量鍵調節音量以外,還可以通過系統設置中進行調節。
控件會根據當初的音量和模式去調用AudioManager的adjustStreamVolume(靜音或震動模式)或setStreamVolume(普通模式)去調整相對應的音量。
AudioManager.setStreamVolume()是系統設置界面中調整音量所使用的接口。
private void setStreamVolume(int streamType, int index, int flags, String callingPackage, int uid) { ...... ensureValidStreamType(streamType);//先判斷一下流類型這個參數的有效性 int streamTypeAlias = mStreamVolumeAlias[streamType];//對這個數組進行流類型的轉換 VolumeStreamState streamState = mStreamStates[streamTypeAlias]; final int device = getDeviceForStream(streamType);//獲取當前流將使用哪一個音頻設備進行播放。最終會被調用到AudioPolicyService中 ...... oldIndex = streamState.getIndex(device);//獲取當前流的音量 index = rescaleIndex(index * 10, streamType, streamTypeAlias);//將原流類型下的音量值映射到目標流類型下的音量值 ...... if (!checkSafeMediaVolume(streamTypeAlias, index, device)) { mVolumeController.postDisplaySafeVolumeWarning(flags); mPendingVolumeCommand = new StreamVolumeCommand( streamType, index, flags, device); } else { onSetStreamVolume(streamType, index, flags, device);//將調用setStreamVolumeInt()方法 index = mStreamStates[streamType].getIndex(device);//獲取設置結果 } } sendVolumeUpdate(streamType, oldIndex, index, flags);//通知外界音量發生了變化 } onSetStreamVolume()方法主要就是調用了setStreamVolumeInt()方法,下面看下setStreamVolumeInt()
private void setStreamVolumeInt(int streamType, int index, int device, boolean force) { VolumeStreamState streamState = mStreamStates[streamType]; if (streamState.setIndex(index, device) || force) { //調用streamState.setIndex(),更改VolumeStreamState對象中保存的音量值 //這個消息將把音量設置到底層去,并將其存儲到Settingsprovider中 sendMsg(mAudioHandler, MSG_SET_DEVICE_VOLUME, SENDMSG_QUEUE, device, 0, streamState, 0); } } 仔細一看,會發現這與上面音量鍵控制音量的adjustStreamVolume()函數的代碼很類似,主要都是調用了那幾個方法。
以上就是本文關于Android原生音量控制實例詳解的全部內容,希望對大家有所幫助。感興趣的朋友可以繼續參閱本站其他相關專題,如有不足之處,歡迎留言指出。感謝朋友們對本站的支持!
新聞熱點
疑難解答