as

Settings
Sign out
Notifications
Alexa
Amazonアプリストア
AWS
ドキュメント
Support
Contact Us
My Cases
開発
設計と開発
公開
リファレンス
サポート

オーディオフォーカスマネージャー

オーディオフォーカスマネージャー

オーディオフォーカスマネージャーを使用すると、オーディオフォーカスセッションの作成と破棄を行うことができます。これにより、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日