AudioRecordStreamBuilder
所需权限
API需要特定权限才能执行某些操作：
[[needs.privilege]]
id = "com.amazon.audio.privilege.microphone.access"
需要申请运行时权限。
构造函数
new AudioRecordStreamBuilder()
new AudioRecordStreamBuilder(): AudioRecordStreamBuilder
返回值
属性
args
args:
Object={}
方法
buildAsync()
buildAsync():
Promise<AudioRecordStream>
使用当前的构建器配置，新建AudioRecordStream。构建前务必调用setAudioConfig和setAudioSource。
返回值
Promise<AudioRecordStream>
Promise 解析为如下的Promise：
- 如果成功，则会创建新的AudioPlaybackStream实例
或显示以下拒绝结果：
- (-2)： 缺少必要配置
- (-3)： 音频系统未初始化
- (-9)： 缺少麦克风权限
- (-1)： 资源分配失败
- (-5)： 服务器通信错误
destroyAsync()
staticdestroyAsync(recordStream: AudioRecordStream):Promise<AudioStatus>
销毁现有的AudioRecordStream。这会释放所有与流相关的资源。调用此方法后不得使用流对象。
参数
recordStream
要销毁的流
返回值
Promise<AudioStatus>
Promise 解析为如下的Promise：
- (0)： 已成功销毁的流
- (-2)： 流对象无效
- (-3)： 音频系统未初始化
- (-8)： 流已销毁
reset()
reset():
void
重置所有构建器配置并设为默认值。
借此复用构建器，创建不同的流配置。
setAudioConfig()
setAudioConfig(config: AudioConfig):
void
为要构建的流设置音频配置。必须在buildAsync之前调用。
参数
config
音频配置对象包含：
sampleRate： 来自types/AudioCoreClientTypes.AudioSampleRate枚举的采样率（单位：Hz）channelMask： 来自types/AudioCoreClientTypes.AudioChannelMask枚举的频道配置format： 来自types/AudioCoreClientTypes.AudioSampleFormat枚举的采样格式
setAudioFlags()
setAudioFlags(flags: AudioFlags):
void
为要构建的流设置可选音频标记。此类标记会修改录音行为。
参数
flags
AudioFlags枚举中的位标记：
- (0x0)： 默认行为
- (1 2)： 录音延迟最小化
- (1 1)： 通过位操作，可结合使用硬件A/V同步功能和AudioFlags枚举标记中定义的其他标记或
setAudioSource()
setAudioSource(source: AudioSource):
void
为要构建的流设置音频源类型。必须在buildAsync之前调用。不同音频源应用的路由和处理流程可能有所差异。
参数
source
AudioSource枚举中的音频输入类型：
- : 优化语音识别
- : 优化VoIP
- : 视频录制音频
- : 未处理的音频输入
- : 唤醒词检测功能已优化
- : 高频捕获以及AudioSource枚举中定义的其他源
Last updated: 2026年7月22日
