音频焦点管理器
音频焦点管理器
重要须知： 亚马逊机密信息。本文档是预发布技术文档，用于介绍尚未向公众发布的即将上线产品。
音频焦点管理器允许创建和销毁音频焦点会话。具体而言，此管理器通过让一个音频源正常播放，同时降低音量（也称为放弃）、暂停或停止其他音频源，从而防止多个音频源同时播放。
- 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对象 |
代码示例
/*
假设会话是一个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日
