AudioRecordStreamBuilder

构造函数

new AudioRecordStreamBuilder()

new AudioRecordStreamBuilder(): AudioRecordStreamBuilder

返回值

AudioRecordStreamBuilder

属性

args

args: Object = {}

方法

buildAsync()

buildAsync(): Promise<AudioRecordStream>

使用当前的构建器配置，新建AudioRecordStream。构建前务必调用setAudioConfig和setAudioSource。需要权限：com.amazon.audio.privilege.microphone.access需要运行时权限：

返回值

Promise<AudioRecordStream>

解析为以下项的Promise：

• 成功时新建AudioRecordStream实例

或显示以下拒绝结果：

• STATUS_BAD_VALUE (-2)： 缺少必要配置
• STATUS_NO_INIT (-3)： 音频系统未初始化
• STATUS_PERMISSION_DENIED (-9)： 缺少麦克风权限
• STATUS_NO_MEMORY (-1): 资源分配失败
• STATUS_DEAD_OBJECT (-5)： 服务器通信错误

参见

https://developer.amazon.com/zh/docs/kepler-tv/request-runtime-privileges.html

---

reset()

reset(): void

重置所有构建器配置并设为默认值。

借此复用构建器，创建不同的流配置。

返回值

void

---

setAudioConfig()

setAudioConfig(config): void

为要构建的流设置音频配置。必须在buildAsync之前调用。

参数

config

AudioConfig

音频配置对象包含：

• sampleRate： 来自types/AudioCoreClientTypes.AudioSampleRate枚举的采样率（单位：Hz）
• channelMask： 来自types/AudioCoreClientTypes.AudioChannelMask枚举的频道配置
• format： 来自types/AudioCoreClientTypes.AudioSampleFormat枚举的采样格式

返回值

void

---

setAudioFlags()

setAudioFlags(flags): void

为要构建的流设置可选音频标记。此类标记会修改录音行为。

参数

flags

AudioFlags

AudioFlags枚举中的位标记：

• FLAG_NONE (0x0): 默认行为
• FLAG_LOW_LATENCY (1 << 2)： 录音延迟最小化
• FLAG_HW_AV_SYNC (1 << 1): 通过位操作，可结合使用硬件A/V同步功能和AudioFlags枚举标记中定义的其他标记或

返回值

void

---

setAudioSource()

setAudioSource(source): void

为要构建的流设置音频源类型。必须在buildAsync之前调用。不同音频源应用的路由和处理流程可能有所差异。

参数

source

AudioSource

AudioSource枚举中的音频输入类型：

• VOICE_RECOGNITION： 优化语音识别
• VOICE_COMMUNICATION： 优化VoIP
• CAMCORDER： 视频录制音频
• RAW： 未处理的音频输入
• WAKEWORD： 唤醒词检测功能已优化
• ULTRASOUND： 高频捕获以及AudioSource枚举中定义的其他源

返回值

void

---

destroyAsync()

static destroyAsync(recordStream): Promise<AudioStatus>

销毁现有的AudioRecordStream。这会释放所有与流相关的资源。调用此方法后不得使用流对象。

参数

recordStream

AudioRecordStream

要销毁的流

返回值

Promise<AudioStatus>

解析为以下项的Promise：

• STATUS_NO_ERROR (0)： 已成功销毁的流
• STATUS_BAD_VALUE (-2)： 流对象无效
• STATUS_NO_INIT (-3)： 音频系统未初始化
• STATUS_INVALID_OPERATION (-8)： 流已销毁

---

Last updated: 2025年10月2日