Android教程網 >> Android技術 >> Android開發實例 >> Android中文API（122） —— AudioRecord

Android中文API（122） —— AudioRecord

編輯：Android開發實例

前言

　　本章內容是android.media.AudioRecord，版本為Android 3.1 r1，翻譯來自"chenwei"，這位朋友在沒有加入翻譯組情況下匿名投稿，這裡整理後代為發布！

結構

繼承關系

public class AudioRecord extends Object

　　java.lang.Object

android.media.AudioRecord

類概述

　　AudioRecord類在Java應用程序中管理音頻資源，用來記錄從平台音頻輸入設備產生的數據。通過AudioRecord對象來完成"pulling"（讀取）數據。應用通過以下幾個方法負責立即從AudioRecord對象讀取： read(byte[], int, int)， read(short[], int, int)或read(ByteBuffer, int). 無論使用哪種音頻格式，使用AudioRecord是最方便的。

　　在創建AudioRecord對象時，AudioRecord會初始化，並和音頻緩沖區連接，用來緩沖新的音頻數據。根據構造時指定的緩沖區大小，來決定AudioRecord能夠記錄多長的數據。從硬件設備讀取的數據，應小於整個記錄緩沖區。

內部類

　　　　interface AudioRecord.OnRecordPositionUpdateListener

　　接口定義為：當AudioRecord 收到一個由setNotificationMarkerPosition(int)設置的通知標志，或由 setPositionNotificationPeriod(int)設置的周期更新記錄的進度狀態時，回調此接口。

常量

　　　　public static final int ERROR

　　表示操作失敗。

常量值: -1 (0xffffffff)

　　public static final int ERROR_BAD_VALUE

　　表示使用了一個不合理的值導致的失敗。

　　常量值: -2 (0xfffffffe)

　　public static final int ERROR_INVALID_OPERATION

　　表示不恰當的方法導致的失敗。

　　常量值: -3 (0xfffffffd)

　　public static final int RECORDSTATE_RECORDING

　　指示AudioRecord錄制狀態為“正在錄制”。

　　常量值: 3 (0x00000003)

　　public static final int RECORDSTATE_STOPPED

　　指示AudioRecord錄制狀態為“不在錄制”。

　　常量值: 1 (0x00000001)

　　public static final int STATE_INITIALIZED

　　指示AudioRecord准備就緒。

　　常量值: 1 (0x00000001)

　　public static final int STATE_UNINITIALIZED

　　指示AudioRecord狀態沒有初始化成功。

　　常量值: 0 (0x00000000)

　　public static final int SUCCESS

　　表示操作成功。

　　常量值: 0 (0x00000000)

構造函數

　　public AudioRecord (int audioSource, int sampleRateInHz, int channelConfig, int audioFormat, int bufferSizeInBytes)

　　類構造函數。

參數

audioSource 錄制源。請見MediaRecorder.AudioSource錄制源定義。

sampleRateInHz 默認采樣率，單位Hz。 44100Hz是當前唯一能保證在所有設備上工作的采樣率，在一些設備上還有22050, 16000或11025。

channelConfig 描述音頻通道設置。請見CHANNEL_IN_MONO 和 CHANNEL_IN_STEREO。 CHANNEL_IN_MONO保證能在所有設備上工作。

audioFormat 音頻數據保證支持此格式。請見ENCODING_PCM_16BIT 和ENCODING_PCM_8BIT。

bufferSizeInBytes 在錄制過程中，音頻數據寫入緩沖區的總數（字節）。從緩沖區讀取的新音頻數據總會小於此值。 getMinBufferSize(int, int, int)返回AudioRecord 實例創建成功後的最小緩沖區。設置的值比getMinBufferSize()還小則會導致初始化失敗。

異常

IllegalArgumentException

公共方法

　　　　public int getAudioFormat ()

　　　　返回設置的音頻數據格式。請見ENCODING_PCM_16BIT 和ENCODING_PCM_8BIT。

　　　　public int getAudioSource ()

　　　　返回音頻錄制源。

　　　　　　參見

MediaRecorder.AudioSource

　　　　public int getChannelConfiguration ()

　　　　返回設置的頻道設置。請見CHANNEL_IN_MONO和CHANNEL_IN_STEREO。

　　　　public int getChannelCount ()

　　　　返回設置的頻道數目。

　　　　public static int getMinBufferSize (int sampleRateInHz, int channelConfig, int audioFormat)

　　　　返回成功創建AudioRecord對象所需要的最小緩沖區大小。注意：這個大小並不保證在負荷下的流暢錄制，應根據預期的頻率來選擇更高的值，AudioRecord實例在推送新數據時使用此值。

　　　　　　參數

sampleRateInHz 默認采樣率，單位Hz。

channelConfig 描述音頻通道設置。

請見CHANNEL_IN_MONO和CHANNEL_IN_STEREO。

audioFormat 音頻數據保證支持此格式。參見ENCODING_PCM_16BIT。

　　　　　　返回值

　　如果硬件不支持錄制參數，或輸入了一個無效的參數，則返回ERROR_BAD_VALUE，如果硬件查詢到輸出屬性沒有實現，或最小緩沖區用byte表示，則返回ERROR。

　　　　　　參見

更多信息請見有效的設置參數

　　　　public int getNotificationMarkerPosition ()

　　　　返回通知，標記框架中的位置。

　　　　public int getPositionNotificationPeriod ()

　　　　返回通知，更新框架中的時間位置。

　　　　public int getRecordingState ()

　　　　返回AudioRecord實例的錄制狀態。

　　　　　　參見

RECORDSTATE_STOPPED

　　 RECORDSTATE_RECORDING

　　　　public int getSampleRate ()

　　　　返回設置的音頻數據樣本采樣率，單位Hz。

　　　　public int getState ()

　　　　返回AudioRecord實例的狀態。這點非常有用，用在AudioRecord 實例創建成功後，檢查初始化屬性。它能肯定請求到了合適的硬件資源。

　　　　　　參見

　　STATE_INITIALIZED

　　 STATE_UNINITIALIZED

　　　　public int read (short[] audioData, int offsetInShorts, int sizeInShorts)

　　　　從音頻硬件錄制緩沖區讀取數據。

　　參數

audioData 寫入的音頻錄制數據。

offsetInShorts 目標數組 audioData 的起始偏移量。

sizeInShorts 請求讀取的數據大小。

　　　　　　返回值

　　返回short型數據，表示讀取到的數據，如果對象屬性沒有初始化，則返回ERROR_INVALID_OPERATION，如果參數不能解析成有效的數據或索引，則返回ERROR_BAD_VALUE。返回數值不會超過sizeInShorts。

　　　　public int read (byte[] audioData, int offsetInBytes, int sizeInBytes)

　　　　從音頻硬件錄制緩沖區讀取數據。

參數

audioData 寫入的音頻錄制數據。

offsetInBytes audioData的起始偏移值，單位byte。

sizeInBytes 讀取的最大字節數。

返回值

　　讀入緩沖區的總byte數，如果對象屬性沒有初始化，則返回ERROR_INVALID_OPERATION，如果參數不能解析成有效的數據或索引，則返回ERROR_BAD_VALUE。讀取的總byte數不會超過sizeInBytes。

　　　　public int read (ByteBuffer audioBuffer, int sizeInBytes)

　　　　從音頻硬件錄制緩沖區讀取數據，直接復制到指定緩沖區。如果audioBuffer不是直接的緩沖區，此方法總是返回0。

參數

audioBuffer 存儲寫入音頻錄制數據的緩沖區。

sizeInBytes 請求的最大字節數。

返回值

　　　　public void release ()

　　　　釋放本地AudioRecord資源。對象不能經常使用此方法，而且在調用release()後，必須設置引用為null。

　　　　public int setNotificationMarkerPosition (int markerInFrames)

　　　　如果設置了setRecordPositionUpdateListener(OnRecordPositionUpdateListener)或setRecordPositionUpdateListener(OnRecordPositionUpdateListener, Handler)，則通知監聽者設置位置標記。

參數

markerInFrames 在框架中快速標記位置。

返回值

返回錯誤或成功代碼，請見SUCCESS、ERROR_BAD_VALUE、ERROR_INVALID_OPERATION。

　　　　public int setPositionNotificationPeriod (int periodInFrames)

　　　　如果設置了setRecordPositionUpdateListener(OnRecordPositionUpdateListener)或setRecordPositionUpdateListener(OnRecordPositionUpdateListener, Handler)，則通知監聽者設置時間標記。

參數

markerInFrames 在框架中快速更新時間標記。

返回值

返回錯誤或成功代碼，請見SUCCESS、ERROR_INVALID_OPERATION。

　　 public void setRecordPositionUpdateListener (AudioRecord.OnRecordPositionUpdateListener listener, Handler handler)

　　當之前設置的標志已經成立，或者周期錄制位置更新時，設置處理監聽者。使用此方法來將Handler 和別的線程聯系起來，來接收AudioRecord 事件，比創建AudioTrack 實例更好一些。

　　參數

handler 用來接收事件通知消息。

　　 public void setRecordPositionUpdateListener (AudioRecord.OnRecordPositionUpdateListener listener)

　　　　當之前設置的標志已經成立，或者周期錄制位置更新時，設置處理監聽者。

　　　　public void startRecording ()

　　　　AudioRecord實例開始進行錄制。