接口锁定

本章相关接口用于锁定所有 API 接口,使接口只能被当前 Device 实例使用,防止 API 被其他用户或进程使用。您可以设置默认的加锁时长,也可以定期刷新锁(推荐定期刷新),还可以主动释放接口锁。

获得锁

获得锁。此锁将在 60 秒后自动释放,释放后其他客户端即可获得锁。您可以更改此时间,但如果设置得过长,一旦脚本异常退出,您将几乎无法连接设备,可能需要重启设备才能继续连接。此接口可重入,重入时等价于 _refresh_lock

d._acquire_lock(leaseTime=60)

释放锁

主动释放 API 锁,之后其他客户端将可以获得锁。

d._release_lock()

刷新锁

刷新锁。每次调用后会将锁的过期时间设置为指定的 leaseTime。请定期调用此接口以保持 API 锁定。同样,如果 leaseTime 设置得太高,一旦脚本异常退出,您将几乎无法连接设备。

d._refresh_lock(leaseTime=60)