結構

繼承關係

public classAudioRecord extendsObject

　　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能夠記錄多長的資料。從硬體裝置讀取的資料，應小於整個記錄緩衝區。

內部類

　　　　AudioRecord.OnRecordPositionUpdateListener

　　介面定義為：當AudioRecord收到一個由setNotificationMarkerPosition(int)設定的通知標誌，或由setPositionNotificationPeriod(int)設定的週期更新記錄的進度狀態時，回撥此介面。

常量

　　　　ERROR

　　表示操作失敗。

常量值: -1 (0xffffffff)

　　public static final intERROR_BAD_VALUE

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

　　常量值: -2 (0xfffffffe)

　　public static final intERROR_INVALID_OPERATION

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

　　常量值: -3 (0xfffffffd)

　　public static final intRECORDSTATE_RECORDING

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

　　常量值: 3 (0x00000003)

　　public static final intRECORDSTATE_STOPPED

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

　　常量值: 1 (0x00000001)

　　public static final intSTATE_INITIALIZED

　　指示AudioRecord準備就緒。

　　常量值: 1 (0x00000001)

　　public static final intSTATE_UNINITIALIZED

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

　　常量值: 0 (0x00000000)

　　public static final intSUCCESS

　　表示操作成功。

　　常量值: 0 (0x00000000)

建構函式

　　publicAudioRecord(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

公共方法

　　　　getAudioFormat

　　　　返回設定的音訊資料格式。請見ENCODING_PCM_16BIT和ENCODING_PCM_8BIT。

　　　　getAudioSource

　　　　返回音訊錄製源。

　　　　　　參見

MediaRecorder.AudioSource

　　　　getChannelConfiguration

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

　　　　getChannelCount

　　　　返回設定的頻道數目。

　　　　getMinBufferSize

　　　　返回成功建立AudioRecord物件所需要的最小緩衝區大小。注意：這個大小並不保證在負荷下的流暢錄製，應根據預期的頻率來選擇更高的值，AudioRecord例項在推送新資料時使用此值。

　　　　　　引數

sampleRateInHz預設取樣率，單位Hz。

channelConfig描述音訊通道設定。

請見CHANNEL_IN_MONO和CHANNEL_IN_STEREO。

audioFormat音訊資料保證支援此格式。參見ENCODING_PCM_16BIT。

　　　　　　返回值

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

　　　　　　參見

更多資訊請見有效的設定引數

　　　　getNotificationMarkerPosition

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

　　　　getPositionNotificationPeriod

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

　　　　getRecordingState

　　　　返回AudioRecord例項的錄製狀態。

　　　　　　參見

RECORDSTATE_STOPPED

　　RECORDSTATE_RECORDING

　　　　getSampleRate

　　　　返回設定的音訊資料樣本取樣率，單位Hz。

　　　　getState

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

　　　　　　參見

　　STATE_INITIALIZED

　　STATE_UNINITIALIZED

　　　　read

　　　　從音訊硬體錄製緩衝區讀取資料。

　　引數

audioData寫入的音訊錄製資料。

offsetInShorts目標陣列audioData的起始偏移量。

sizeInShorts請求讀取的資料大小。

　　　　　　返回值

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

　　　　read

　　　　從音訊硬體錄製緩衝區讀取資料。

引數

audioData寫入的音訊錄製資料。

offsetInBytesaudioData的起始偏移值，單位byte。

sizeInBytes讀取的最大位元組數。

返回值

　　讀入緩衝區的總byte數，如果物件屬性沒有初始化，則返回ERROR_INVALID_OPERATION，如果引數不能解析成有效的資料或索引，則返回ERROR_BAD_VALUE。讀取的總byte數不會超過sizeInBytes。

　　　　read

　　　　從音訊硬體錄製緩衝區讀取資料，直接複製到指定緩衝區。如果audioBuffer不是直接的緩衝區，此方法總是返回0。

引數

audioBuffer儲存寫入音訊錄製資料的緩衝區。

sizeInBytes請求的最大位元組數。

返回值

　　讀入緩衝區的總byte數，如果物件屬性沒有初始化，則返回ERROR_INVALID_OPERATION，如果引數不能解析成有效的資料或索引，則返回ERROR_BAD_VALUE。讀取的總byte數不會超過sizeInBytes。

　　　　release

　　　　釋放本地AudioRecord資源。物件不能經常使用此方法，而且在呼叫release()後，必須設定引用為null。

　　　　setNotificationMarkerPosition

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

引數

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

返回值

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

　　　　setPositionNotificationPeriod

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

引數

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

返回值

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

　　public voidsetRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener, Handler handler)

　　當之前設定的標誌已經成立，或者週期錄製位置更新時，設定處理監聽者。使用此方法來將Handler和別的執行緒聯絡起來，來接收AudioRecord事件，比建立AudioTrack例項更好一些。

　　引數

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

　　public voidsetRecordPositionUpdateListener(AudioRecord.OnRecordPositionUpdateListener listener)

　　　　當之前設定的標誌已經成立，或者週期錄製位置更新時，設定處理監聽者。

　　　　startRecording

　　　　AudioRecord例項開始進行錄製。

異常

IllegalStateException

受保護方法

　　protected voidfinalize()

　　　　通知VM回收此物件記憶體。此方法只能用在執行的應用程式沒有任何執行緒再使用此物件，來告訴垃圾回收器回收此物件。

　　此方法用於釋放系統資源，由垃圾回收器清除此物件。預設沒有實現，由VM來決定，但子類根據需要可重寫finalize()。在執行期間，呼叫此方法可能會立即丟擲未定義異常，但是可以忽略。

　　注意：VM保證物件可以一次或多次呼叫finalize()，但並不保證finalize()會馬上執行。例如，物件B的finalize()可能延遲執行，等待物件A的finalize()延遲迴收A的記憶體。為了安全起見，請看ReferenceQueue，它提供了更多地控制VM的垃圾回收。

AudioRecord.OnRecordPositionUpdateListener

版本：Android 3.1 r1

結構

繼承關係

public static interfaceAudioRecord.OnRecordPositionUpdateListener

android.media.AudioRecord.OnRecordPositionUpdateListener

類概述

介面定義為：當AudioRecord收到一個由setNotificationMarkerPosition(int)設定的通知標誌，或由setPositionNotificationPeriod(int)設定的週期更新記錄的進度狀態時，回撥此介面。

公共方法

public abstract voidonMarkerReached(AudioRecord recorder)

回撥監聽器，通知監聽器已經到達之前設定的標記位置。

public abstract voidonPeriodicNotification(AudioRecord recorder)

按照一定的週期，通知監聽器，指定的記錄已經就緒。