获取外接音频设备列表
1.接口描述
接口说明：获取外接音频设备列表。
请求方式：
- 固件版本 V2.6.0 及以上：POST [ip]/mwapi/V2.0/audio/get-usb-audio-list
- 固件版本 V2.5.0 及以下：POST [ip]/mwapi/get-usb-audio-list
| 管理员权限 | 登录认证 |
|---|---|
| 否 | 是 |
2.输入参数
| 参数名称 | 必选 | 类型 | 描述 |
|---|---|---|---|
| target | 是 | Int | 选择音频设置项获取对应的设备列表。 0：获取 Web Camera 的可选音频设备列表 1：获取麦克风可选设备列表 2：获取可选 USB 音频播放设备列表 |
3.输出参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| status | Int | 状态码 |
| selected | Boolean | 当前音频设置项是否已选择设备 true: 已选择；false：未选择 |
| audioOffset | Int | 音频偏移设置，毫秒 |
| cur-dev-path | String | 当前选中的设备。如未选择设备，则为空 |
| devices | Array of DeviceData | 设备列表 |
DeviceData
| 参数名称 | 类型 | 描述 |
|---|---|---|
| dev-path | String | 设备唯一标识 |
| dev-name | String | 设备名称 |
4.示例
获取 Web Camera 的可选音频设备列表。
输入示例
{
"target": 0,
}
输出示例
{
"status": 0,
"selected": false,
"audioOffset": -150,
"cur-dev-path": "",
"devices": [
{
"dev-path": "aHc6Mywx",
"dev-name": "HDMI [USB Capture HDMI+] #1"
},
{
"dev-path": "aHc6Mywy",
"dev-name": "HDMI [USB Capture HDMI+] #2"
}
]
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码，其他错误码详见 公共错误码。
| 错误码 | 定义 | 说明 |
|---|---|---|
| 7 | MW_STATUS_INVALID_ARG | 参数缺失 |