接口锁定¶
本章相关接口用于锁定所有 API 接口,使接口只能被当前 Device 实例使用,防止 API 被其他用户或进程使用。您可以设置默认的加锁时长,也可以定期刷新锁(推荐定期刷新),还可以主动释放接口锁。
获得锁¶
获得锁。此锁将在 60 秒后自动释放,释放后其他客户端即可获得锁。您可以更改此时间,但如果设置得过长,一旦脚本异常退出,您将几乎无法连接设备,可能需要重启设备才能继续连接。此接口可重入,重入时等价于 _refresh_lock。
d._acquire_lock(leaseTime=60)
释放锁¶
主动释放 API 锁,之后其他客户端将可以获得锁。
d._release_lock()
刷新锁¶
刷新锁。每次调用后会将锁的过期时间设置为指定的 leaseTime。请定期调用此接口以保持 API 锁定。同样,如果 leaseTime 设置得太高,一旦脚本异常退出,您将几乎无法连接设备。
d._refresh_lock(leaseTime=60)