AudioFocusManager

コンストラクタ

new AudioFocusManager()

new AudioFocusManager(): AudioFocusManager

戻り値

AudioFocusManager

プロパティ

defaultFocusSession

static defaultFocusSession: AudioFocusSession = null

メソッド

createAudioFocusSessionAsync()

static createAudioFocusSessionAsync(): Promise<AudioFocusSession>

新しいAudioFocusSessionを作成します。各セッションは、オーディオフォーカスリクエストとコールバックを個別に管理できます。複数のセッションを作成して、さまざまなオーディオストリームを個別に管理できます。

使用例：

• 音楽再生とナビゲーション用の各種セッション
• 音声アシスタント応答用の個別セッション
• ゲームオーディオ用の独立したセッション

戻り値

Promise<AudioFocusSession>

Promiseは以下に解決されます。

• 成功した場合、新しいAudioFocusSessionオブジェクト

または、次の値で拒否します。

• STATUS_NO_MEMORY (-1)： セッションを割り当てることができませんでした
• STATUS_NO_INIT (-3)： オーディオフォーカスシステムが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

destroyAudioFocusSessionAsync()

static destroyAudioFocusSessionAsync(sessionObject): Promise<AudioFocusStatus>

既存のオーディオフォーカスセッションを破棄し、関連するすべてのリソースをリリースします。このセッションが不要になったときに、システムリソースを解放するために呼び出す必要があります。このセッションでアクティブなフォーカスリクエストはすべて、自動的にリリースされます。

重要： 破棄したセッションオブジェクトを再使用しないでください。

パラメーター

sessionObject

AudioFocusSession

破棄するセッション

戻り値

Promise<AudioFocusStatus>

Promiseは以下に解決されます。

• AUDIO_FOCUS_STATUS_NO_ERROR (0)： セッションが破棄されました
• AUDIO_FOCUS_STATUS_BAD_VALUE (-2)： セッションオブジェクトが無効です
• AUDIO_FOCUS_STATUS_NO_INIT (-3)： オーディオフォーカスシステムが初期化されていません
• AUDIO_FOCUS_STATUS_INVALID_OPERATION (-8)： セッションは既に破棄されています

---

getDefaultAudioFocusSessionAsync()

static getDefaultAudioFocusSessionAsync(): Promise<AudioFocusSession>

デフォルトのオーディオフォーカスセッションを取得します。オーディオストリームがフォーカスセッションを明示的に指定していない場合に使用されるシングルトンインスタンスです。デフォルトセッションは最初のアクセス時に作成され、アプリケーションが終了するまで持続します。

重要な注意事項：

• デフォルトセッションは、デフォルトフォーカスを使用するすべてのコンポーネントで共有されます
• デフォルトセッションでのフォーカスの変更は、そのセッションを使用するすべてのストリームに影響します
• 独立したフォーカス制御を行うには、専用のセッションを作成してください

戻り値

Promise<AudioFocusSession>

Promiseは以下に解決されます。

• デフォルトのAudioFocusSessionインスタンス。 または、次の値で拒否します。
• STATUS_NO_MEMORY (-1)： デフォルトセッションを作成できませんでした
• STATUS_NO_INIT (-3)： オーディオフォーカスシステムが初期化されていません
• STATUS_DEAD_OBJECT (-5)： サーバー通信エラー

---

getMajorVersion()

static getMajorVersion(): number

AudioFocusManagerのメジャーバージョン番号を取得します。互換性チェックと機能検出に使用できます。

戻り値

number

モジュールのメジャーバージョン番号

---

getMinorVersion()

static getMinorVersion(): number

AudioFocusManagerのマイナーバージョン番号を取得します。互換性チェックと機能検出に使用できます。

戻り値

number

モジュールのマイナーバージョン番号

---

getPatchVersion()

static getPatchVersion(): number

AudioFocusManagerのパッチバージョン番号を取得します。互換性チェックと機能検出に使用できます。

戻り値

number

モジュールのパッチバージョン番号

---

Last updated: 2025年10月2日