该 API 还是实验性的,仅对 dev 分支的 Chrome 用户可用。

chrome.audio

描述 chrome.audio API 允许用户获取连接到系统的音频设备信息,并控制它们。目前该 API 仅在 Chrome OS 上实现。
可用版本 仅用于 Dev 分支。了解更多内容
权限 "audio"

摘要

方法
getInfo chrome.audio.getInfo(function callback)
setActiveDevices chrome.audio.setActiveDevices(array of string ids, function callback)
setProperties chrome.audio.setProperties(string id, object properties, function callback)
事件
onDeviceChanged

方法

getInfo

chrome.audio.getInfo(function callback)

获取所有音频输出与输入设备的信息。

参数
function callback

callback 参数应该是一个如下形式的函数:

function(array of object outputInfo, array of object inputInfo) {...};
array of object outputInfo

每一个对象的属性

string id

音频输出设备的唯一标志符。

string name

用户友好的名称(例如“Bose Amplifier”)。

boolean isActive

i 如果是当前活动的设备则为 true。

boolean isMuted

如果已静音则为 true。

double volume

输出音量,范围为 0.0 到 1.0。

array of object inputInfo

每一个对象的属性

string id

音频输入设备的唯一标志符。

string name

用户友好的名称(例如“USB 麦克风”)。

boolean isActive

如果是当前活动的设备则为 true。

boolean isMuted

如果已静音则为 true。

double gain

输入增益,从 0.0 到 1.0。

setActiveDevices

chrome.audio.setActiveDevices(array of string ids, function callback)

将一部分音频设备设置为活动设备。

参数
array of string ids
function callback

callback 参数应该是一个如下形式的函数:

function() {...};

setProperties

chrome.audio.setProperties(string id, object properties, function callback)

为输入或输出设备设置属性。

参数
string id
object properties
boolean isMuted

如果已静音则为 true。

double (可选)
volume

如果是输出设备则该字段表示输出音量,如果是输入设备则忽略该字段。

double (可选)
gain

如果是输入设备则该字段表示输入增益,如果是输出设备则忽略该字段。

function callback

callback 参数应该是一个如下形式的函数:

function() {...};

事件

onDeviceChanged

音频设备配置更改时产生。

addListener

chrome.audio.onDeviceChanged.addListener(function callback)
参数
function callback

callback 参数应该是一个如下形式的函数:

function() {...};