AudioRecordStreamBuilder
必要な権限
このAPIでは、特定の操作に特定の権限が必要です。
[[needs.privilege]]
id = "com.amazon.audio.privilege.microphone.access"
実行時権限のリクエストを行う必要があります。
コンストラクタ
new AudioRecordStreamBuilder()
new AudioRecordStreamBuilder(): AudioRecordStreamBuilder
戻り値
プロパティ
args
args:
Object={}
メソッド
buildAsync()
buildAsync():
Promise<AudioRecordStream>
現在のビルダー構成を使用して新しいオーディオ録音ストリームを作成します。作成する前に構成を呼び出しておく必要があります。
戻り値
Promise<AudioRecordStream>
Promise:以下に解決されるプロミスオブジェクト:
- 新しいインスタンス(成功した場合)
または、次の値で拒否します。
- (-2): 必要な構成が見つかりません
- (-3): オーディオシステムが初期化されていません
- (-9): マイク権限がありません
- (-1): リソースを割り当てることができませんでした
- (-5): サーバー通信エラー
destroyAsync()
staticdestroyAsync(recordStream: AudioRecordStream):Promise<AudioStatus>
既存のものを破棄します。これにより、ストリームに関連するすべてのリソースがリリースされます。このメソッドを呼び出した後は、ストリームオブジェクトを使用しないでください。
パラメーター
recordStream
破棄するストリーム
戻り値
Promise<AudioStatus>
Promise:以下に解決されるプロミスオブジェクト:
- (0): ストリームが破棄されました
- (-2): ストリームオブジェクトが無効です
- (-3): オーディオシステムが初期化されていません
- (-8): ストリームは既に破棄されています
reset()
reset():
void
すべてのビルダー構成をデフォルト値にリセットします。
ビルダーを再利用して別のストリーム構成を作成する場合に使用できます。
setAudioConfig()
setAudioConfig(config: AudioConfig):
void
ビルドするストリームのオーディオ構成を設定します。これらの属性は、あらかじめ呼び出しておく必要があります。
パラメーター
config
以下を含むオーディオ構成オブジェクト。
sampleRate: 列挙型から取得したサンプルレート (Hz)channelMask: 列挙型から取得したチャネル構成format: 列挙型から取得したサンプル形式
setAudioFlags()
setAudioFlags(flags: AudioFlags):
void
ビルドするストリームのオーディオフラグ(任意)を設定します。これらのフラグはオーディオ録音の動作を変更します。
パラメーター
flags
列挙型から取得したビットフラグ:
- (0x0): デフォルトの動作
- (1 2): 録音の遅延を最小化します
- (1 1): ハードウェアA/V同期および、列挙型で定義されているその他のフラグ。フラグはビット論理和を使用して組み合わせることができます
setAudioSource()
setAudioSource(source: AudioSource):
void
ビルドするストリームのオーディオソースタイプを設定します。これらの属性は、あらかじめ呼び出しておく必要があります。ソースが異なると、適用されるルーティングや処理が異なる場合があります。
パラメーター
source
列挙型から取得したオーディオ入力のタイプ:
- : 音声認識向けに最適化されています
- : VoIP向けに最適化されています
- : ビデオ録画オーディオ
- : 未処理のオーディオ入力
- : ウェイクワード検出向けに最適化されています
- : 高音域キャプチャおよび、列挙型で定義されているその他のタイプ
Last updated: 2026年7月22日

