オーディオフォーカスマネージャー
オーディオフォーカスマネージャー
重要： Amazon社外秘。本テクニカルドキュメントは、リリース予定（一般公開前）の新製品に関するものです。
オーディオフォーカスマネージャーを使用すると、オーディオフォーカスセッションの作成と破棄を行うことができます。これにより、1つのオーディオソースを通常どおりに再生しながら、ほかのオーディオソースの音量を下げるか（ダッキングとも呼ばれます）、ほかのオーディオソースを一時停止または停止することが可能になり、複数のオーディオソースが同時に再生されるのを回避できます。
- TOC
必要なサービス
このAPIには、システムオーディオサービスの宣言が必要です。
[wants]
[[wants.service]]
id = "com.amazon.audio.control"
使用される型
オーディオコアタイプを参照してください
AudioFocusStatus
静的メソッド
AudioFocusManager.createAudioFocusSessionAsync()
説明
新しいオーディオフォーカスセッションを作成します。
戻り値
AudioFocusSessionオブジェクトに解決されるPromiseを返します。
サンプルコード
/*
Promiseの解決後にAudioFocusSessionオブジェクトを返します。
*/
const session = AudioFocusManager.createAudioFocusSessionAsync()
.then((session) => {return session;}).catch((error) => console.log(error));
AudioFocusManager.destroyAudioFocusSessionAsync(sessionObject)
説明
パラメーターで指定されたオーディオフォーカスセッションを破棄します。
戻り値
AudioFocusStatus型に解決されるPromiseを返します。
パラメーター
| パラメーター名 | 型 | 必須 | 説明 |
|---|---|---|---|
| sessionObject | AudioFocusSession | ○ | 破棄するAudioFocusSessionオブジェクト。 |
サンプルコード
/*
sessionはAudioFocusSessionオブジェクトであると想定します。
セッションを破棄し、AudioFocusStatus型に解決されるpromiseを返します。
*/
const status = AudioFocusManager.destroyAudioFocusSessionAsync(session)
.then((status) => {return status;}).catch((error) => console.log(error));
AudioFocusManager.getDefaultAudioFocusSessionAsync()
説明
デフォルトのオーディオフォーカスセッションを取得します。デフォルトのオーディオフォーカスセッションは、オーディオストリームがオーディオフォーカスセッションを明示的にリンクしない場合にデフォルトとなるシングルトンインスタンスです。
戻り値
デフォルトのAudioFocusSessionオブジェクトに解決されるPromiseを返します。
サンプルコード
/*
Promiseの解決後にデフォルトのAudioFocusSessionオブジェクトを返します。
*/
const session = AudioFocusManager.getDefaultAudioFocusSessionAsync()
.then((session) => {return session;}).catch((error) => console.log(error));
Last updated: 2025年10月2日
