android 31 r1 api中文文档——audiorecord（chenwei）.docVIP

AudioRecord 译者署名： chenwei 版本：Android 3.1 r1 结构 继承关系 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 表示操作失败。 public static final int ERROR_BAD_VALUE 表示使用了一个不合理的值导致的失败。 public static final int ERROR_INVALID_OPERATION 表示不恰当的方法导致的失败。 public static final int RECORDSTATE_RECORDING 指示AudioRecord录制状态为正在录制。 public static final int RECORDSTATE_STOPPED 指示AudioRecord录制状态为不在录制 常量值: 1 (0 public static final int STATE_INITIALIZED 指示AudioRecord准备就绪。 public static final int STATE_UNINITIALIZED 指示AudioRecord状态没有初始化成功。 public static final int SUCCESS 表示操作成功。 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和CHA