介面鎖定

本章相關介面用於鎖定所有 API 介面,使介面只能被當前 Device 實例使用,防止 API 被其他使用者或程序使用。您可以設定預設的鎖定時長,也可以定期刷新鎖(建議定期刷新),還可以主動釋放介面鎖。

取得鎖

取得鎖。此鎖將在 60 秒後自動釋放,釋放後其他客戶端即可取得鎖。您可以更改此時間,但如果設定得過長,一旦指令碼異常退出,您將幾乎無法連接設備,可能需要重新啟動設備才能繼續連接。此介面可重入,重入時等價於 _refresh_lock

d._acquire_lock(leaseTime=60)

釋放鎖

主動釋放 API 鎖,之後其他客戶端將可以取得鎖。

d._release_lock()

刷新鎖

刷新鎖。每次呼叫後會將鎖的過期時間設定為指定的 leaseTime。請定期呼叫此介面以保持 API 鎖定。同樣,如果 leaseTime 設定得太高,一旦指令碼異常退出,您將幾乎無法連接設備。

d._refresh_lock(leaseTime=60)