AudioRecordStream

コンストラクタ

new AudioRecordStream()

new AudioRecordStream(id): AudioRecordStream

パラメーター

id

number

内部ストリーム識別子

戻り値

AudioRecordStream

プロパティ

streamId

streamId: number

メソッド

flushAsync()

flushAsync(): Promise<AudioStatus>

レコードバッファをフラッシュし、未読データをすべて破棄します。

戻り値

Promise<AudioStatus>

Promise：以下に解決されるプロミスオブジェクト：

• STATUS_NO_ERROR (0)： フラッシュされました
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getAudioConfigAsync()

getAudioConfigAsync(): Promise<AudioConfig>

録音ストリームの現在のオーディオ構成を取得します。

戻り値

Promise<AudioConfig>

Promise：以下を含むオブジェクトに解決されるプロミスオブジェクト：

• sampleRate： Hz単位の現在のサンプルレート
• channelMask： 現在のチャネル構成
• format： 現在のサンプルフォーマット。または、次の値で拒否します。
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getAudioEffectSessionIdAsync()

getAudioEffectSessionIdAsync(): Promise<Int32>

このストリームに関連付けられているカスタムオーディオエフェクトセッションIDを取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： エフェクトセッションID
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_BAD_VALUE (-2)： エフェクトセッションが割り当てられていません

---

getAudioFlagsAsync()

getAudioFlagsAsync(): Promise<Int32>

このストリームに構成されているオーディオフラグを取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• AudioFlags値のビット単位の組み合わせ
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getAudioSourceAsync()

getAudioSourceAsync(): Promise<AudioSource>

このストリームに構成されているオーディオソースタイプを取得します。

戻り値

Promise<AudioSource>

Promise：以下に解決されるプロミスオブジェクト：

• 現在のソースを示す列挙型の値。または、次の値で拒否します。
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getChannelCountAsync()

getChannelCountAsync(): Promise<Int32>

録音ストリームのチャネル数を取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： チャネル数
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getLatencyInMsAsync()

getLatencyInMsAsync(): Promise<Int32>

録音ストリームの現在のレイテンシをミリ秒単位で取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： ミリ秒単位のレイテンシ
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getMajorVersion()

static getMajorVersion(): number

実装のメジャーバージョン番号を取得します。バージョンの確認に使用できます。

戻り値

number

number：メジャーバージョン番号を取得します。

---

getMinBufferSizeInBytesAsync()

getMinBufferSizeInBytesAsync(): Promise<Int32>

録音に必要な最小バッファサイズを取得します。呼び出しでは、録音の信頼性を高めるために、これ以上のサイズを使用する必要があります。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： バイト単位の最小バッファサイズ
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getMinorVersion()

static getMinorVersion(): number

実装のマイナーバージョン番号を取得します。バージョンの確認に使用できます。

戻り値

number

number：マイナーバージョン番号を取得します。

---

getNumBytesInPipelineAsync()

getNumBytesInPipelineAsync(): Promise<Int32>

現時点で録音パイプラインにあるバイトの数を取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： パイプラインにあるバイトの数
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getNumBytesOfNativeBufferAsync()

getNumBytesOfNativeBufferAsync(): Promise<Int32>

録音に使用されるネイティブバッファのサイズを取得します。バッファできるデータの最大量を表します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： バイト単位のバッファサイズ
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getPatchVersion()

static getPatchVersion(): number

実装のパッチバージョン番号を取得します。バージョンの確認に使用できます。

戻り値

number

number：パッチバージョン番号

---

getSampleRateAsync()

getSampleRateAsync(): Promise<Int32>

録音ストリームのサンプルレートを取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： Hz単位のサンプルレート
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getSampleSizeAsync()

getSampleSizeAsync(): Promise<Int32>

録音ストリームのサンプルサイズをビット単位で取得します。

戻り値

Promise<Int32>

Promise：以下に解決されるプロミスオブジェクト：

• 正の値： ビット単位のサンプルサイズ（例：16、24、32）
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

initCheckAsync()

initCheckAsync(): Promise<AudioStatus>

録音ストリームが適切に初期化されているか確認します。ストリームを確実に準備するには、ほかのメソッドを使用する前に呼び出す必要があります。

戻り値

Promise<AudioStatus>

Promise：以下に解決されるプロミスオブジェクト：

• STATUS_NO_ERROR (0)： ストリームは適切に初期化されています
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

readAsync()

readAsync(bytes: Int32): Promise<ArrayBuffer>

録音ストリームからオーディオデータを読み取ります。必要な権限：com.amazon.audio.privilege.microphone.access

パラメーター

bytes

Int32

読み込むバイト数。返される値以上でなければなりません

戻り値

Promise<ArrayBuffer>

Promise：以下に解決されるプロミスオブジェクト：

• 録音されたオーディオデータを含むArrayBuffer。または、次の値で拒否します。
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_BAD_VALUE (-2)： bytesパラメーターが無効です
• STATUS_PERMISSION_DENIED (-9)： マイク権限がありません
• STATUS_INVALID_OPERATION (-8)： 読み取り操作が失敗しました
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

registerEventObserverAsync()

registerEventObserverAsync(callback: (value: any) => void): Promise<AudioStatus>

録音ストリームイベントを受け取るコールバックを登録します。一度に登録できるコールバックは1つだけです。

パラメーター

callback

(value: any) => void

イベントを受け取る関数。イベントには以下のものがあります。

• DIED (0)： ストリームが失敗しました
• RECOVERED (1)： ストリームが障害から回復しました
• MUTE_STATE_CHANGED (2)： ストリームのミュート状態が変更されました

戻り値

Promise<AudioStatus>

Promise：以下に解決されるプロミスオブジェクト：

• STATUS_NO_ERROR (0)： コールバックが登録されました
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_BAD_VALUE (-2)： コールバックが無効です
• STATUS_ALREADY_EXISTS (-4)： コールバックは既に登録されています

---

unregisterEventObserverAsync()

unregisterEventObserverAsync(): Promise<AudioStatus>

以前に登録されたイベントコールバックの登録を解除します。

戻り値

Promise<AudioStatus>

Promise：以下に解決されるプロミスオブジェクト：

• STATUS_NO_ERROR (0)： コールバックの登録が解除されました
• STATUS_NO_INIT (-3)： ストリームが初期化されていません
• STATUS_BAD_VALUE (-2)： 登録されているコールバックはありません

---

Last updated: 2026年7月22日