获取声卡属性
1.接口描述
接口说明:获取声卡属性。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/audio/get-audio-card-mixer
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/get-audio-card-mixer
管理员权限 | 登录认证 |
---|---|
否 | 是 |
2.输入参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
card | 是 | Int | 声卡设备唯一标识,可通过获取声卡设备列表获取 |
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Int | 状态码 |
mixer | Array of CardProperty | 声卡属性列表数组 |
CardProperty
参数名称 | 类型 | 描述 |
---|---|---|
name | String | 声卡名称 |
id | Int | 声卡身份唯一标识 |
val | Int | 声卡音量大小,范围为 0~100 |
flag_c | Boolean | 是否为采集音量。 true:是; false:否 |
flag_p | Boolean | 是否为播放音量。 true:是; false:否 |
4.示例
获取声卡 0 的属性。
输入示例
{
"card": 0,
}
输出示例
{
"status": 0,
"mixer": [
{
"name": "Headphone",
"id": 0,
"val": 100,
"flag_c": false,
"flag_p": true
},
{
"name": "Line Gain",
"id": 5,
"val": 100,
"flag_c": false,
"flag_p": true
},
{
"name": "Mic Gain",
"id": 7,
"val": 100,
"flag_c": false,
"flag_p": true
},
{
"name": "Mic",
"id": 14,
"val": 100,
"flag_c": true,
"flag_p": false
},
{
"name": "Line",
"id": 15,
"val": 100,
"flag_c": true,
"flag_p": false
}
]
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 定义 | 说明 |
---|---|---|
7 | MW_STATUS_INVALID_ARG | 参数缺失 |