Android中文API（122） —— AudioRecord

结构

继承关系

public class AudioRecord extends Object

　　java.lang.Object

android.media.AudioRecord

类概述

　　在创建AudioRecord对象时，AudioRecord会初始化，并和音频缓冲区连接，用来缓冲新的音频数据。 根据构造时指定的缓冲区大小，来决定AudioRecord能够记录多长的数据。 从硬件设备读取的数据，应小于整个记录缓冲区。

内部类

　　　　interface          AudioRecord.OnRecordPositionUpdateListener

常量

　　　　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准备就绪。

　　public static final int STATE_UNINITIALIZED

　　指示AudioRecord状态没有初始化成功。

      　　常量值: 0 (0x00000000)

　　public static final int SUCCESS

　　表示操作成功。

构造函数

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

　　类构造函数。

         参数

sampleRateInHz      默认采样率，单位Hz。 44100Hz是当前唯一能保证在所有设备上工作的采样率，在一些设备上还有22050, 16000或11025。

                   异常

公共方法

　　　　public int getAudioFormat ()

　　　　public int getAudioSource ()

　　　　返回音频录制源。

　　　　　　参见

<code> </code>

　　　　<code>public int getChannelConfiguration ()</code>

　　　　public int getChannelCount ()

　　　　返回设置的频道数目。

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

　　　　返回成功创建AudioRecord对象所需要的最小缓冲区大小。 注意：这个大小并不保证在负荷下的流畅录制，应根据预期的频率来选择更高的值，AudioRecord实例在推送新数据时使用此值。

　　　　　　参数

                            sampleRateInHz      默认采样率，单位Hz。

                            channelConfig           描述音频通道设置。

　　　　　　返回值

　　　　public int getNotificationMarkerPosition ()

　　　　返回通知，标记框架中的位置。

　　　　public int getPositionNotificationPeriod ()

　　　　返回通知，更新框架中的时间位置。

　　　　public int getRecordingState ()

　　　　返回AudioRecord实例的录制状态。

　　　　public int getSampleRate ()

　　　　返回设置的音频数据样本采样率，单位Hz。

　　　　public int getState ()

　　　　返回AudioRecord实例的状态。 这点非常有用，用在AudioRecord 实例创建成功后，检查初始化属性。 它能肯定请求到了合适的硬件资源。

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

　　　　从音频硬件录制缓冲区读取数据。

           　　参数

                            audioData        写入的音频录制数据。

                            offsetInShorts           目标数组 audioData 的起始偏移量。

                            sizeInShorts              请求读取的数据大小。

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

                   参数

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

                            sizeInBytes                读取的最大字节数。

                   返回值

　　　　public int read (ByteBuffer audioBuffer, int sizeInBytes)

　　　　从音频硬件录制缓冲区读取数据，直接复制到指定缓冲区。 如果audioBuffer不是直接的缓冲区，此方法总是返回0。

                            audioBuffer               存储写入音频录制数据的缓冲区。

                            sizeInBytes                请求的最大字节数。

　　　　public void release ()

　　　　释放本地AudioRecord资源。 对象不能经常使用此方法，而且在调用release()后，必须设置引用为null。

　　　　public int setNotificationMarkerPosition (int markerInFrames)

                            markerInFrames      在框架中快速标记位置。

　　　　public int setPositionNotificationPeriod (int periodInFrames)

                            markerInFrames      在框架中快速更新时间标记。

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

　　当之前设置的标志已经成立，或者周期录制位置更新时，设置处理监听者。 使用此方法来将Handler 和别的线程联系起来，来接收AudioRecord 事件，比创建AudioTrack 实例更好一些。

　　参数

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

　　 public void setRecordPositionUpdateListener (AudioRecord.OnRecordPositionUpdateListener listener)

　　　　当之前设置的标志已经成立，或者周期录制位置更新时，设置处理监听者。

　　　　public void startRecording ()

　　　　AudioRecord实例开始进行录制。

受保护方法

　　protected void finalize ()

　　　　通知VM回收此对象内存。 此方法只能用在运行的应用程序没有任何线程再使用此对象，来告诉垃圾回收器回收此对象。

　　此方法用于释放系统资源，由垃圾回收器清除此对象。 默认没有实现，由VM来决定，但子类根据需要可重写finalize()。 在执行期间，调用此方法可能会立即抛出未定义异常，但是可以忽略。

本文转自over140 51CTO博客，原文链接：http://blog.51cto.com/over140/582334，如需转载请自行联系原作者