触发设备按键切换
1.接口描述
接口说明:触发设备按键切换。
请求方式:
- 固件版本 V2.6.0 及以上:POST [ip]/mwapi/V2.0/scene/set-switch-action
- 固件版本 V2.5.0 及以下:POST [ip]/mwapi/set-switch-action
管理员权限 | 登录认证 |
---|---|
否 | 是 |
2.输入参数
参数名称 | 必选 | 类型 | 描述 |
---|---|---|---|
action | 是 | Int | 触发设备上对应按键 0:按键一;1:按键二;2:按键三;3:按键四:4:按键五 |
location | 否 | Int | 画面位置 画中画 1:左上 2:右上 3:左下 4:右下 分屏画面 1:最左 2:中间偏左 3: 中间 4:中间偏右 5:最右 |
sourceCollection | 否 | Int | 资源组合 1:HDMI 1 + HDMI 2 2:HDMI 2 + HDMI 1 3:HDMI 1 + WEBCAM 4:WEBCAM + HDMI 1 5:HDMI 2 + WEBCAM 6:WEBCAM + HDMI 2 |
swap | 否 | Int | 交换画面位置,此值为1时,location及sourceCollection 无效 |
3.输出参数
参数名称 | 类型 | 描述 |
---|---|---|
status | Int | 状态码 |
4.示例
触发按键一。
输入示例
{
"action": 0,
"location":1,
"sourceCollection":1,
"swap":0
}
输出示例
{
"status": 0,
}
5.错误码
以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。
错误码 | 定义 | 说明 |
---|---|---|
7 | MW_STATUS_INVALID_ARG | 参数缺失 |
9 | MW_STATUS_UNSUPPORTED | 禁止操作 |
11 | MW_STATUS_DEVICE_BUSY | 画面编辑模式,禁止 |
31 | MW_STATUS_NOT_PERMITTED | 移动端配对模式,禁止 |