设置设备忙碌状态

设置设备的忙碌状态，用于标识设备是否正在执行任务，便于多脚本协作时避免设备冲突。

接口说明

接口类型

setDeviceBusy

参数

参数名	类型	必填	说明
deviceId	string	✅	设备 ID
state	boolean	✅	忙碌状态，true=忙碌中，false=空闲

返回值

true  // 操作成功返回 true

事件通知

设置状态时会触发事件并通过 WebSocket 广播：

• 设置为忙碌时触发 device:busy 事件
• 设置为空闲时触发 device:idle 事件

基本使用

// 设置设备为忙碌状态
await apiInvoke('setDeviceBusy', {
    deviceId: 'P72578581E07',
    state: true
});

// 执行任务...

// 任务完成后设置为空闲状态
await apiInvoke('setDeviceBusy', {
    deviceId: 'P72578581E07',
    state: false
});

说明

设备锁定

当设备设置为忙碌状态（state: true）时，系统会自动锁定对应设备的中控界面，避免在脚本执行过程中被误操作干扰。

提示

• 设备的 busying 状态可以通过 getDevices 接口获取
• 建议在任务完成或异常时及时恢复为空闲状态，解除中控锁定