Bloqueo de API¶

Las interfaces de este capítulo se utilizan para bloquear todas las interfaces de la API, permitiéndole restringir el uso de la interfaz únicamente a la instancia actual del Device. Esto evita que la API sea utilizada por otros usuarios o procesos. Puede establecer una duración de bloqueo predeterminada o actualizar el bloqueo periódicamente usted mismo. Se recomienda el método de actualización periódica. También puede liberar el bloqueo de la interfaz de forma activa. Un flujo de bloqueo seguro es: adquirir el bloqueo -> crear un hilo para actualizar el bloqueo periódicamente -> liberar el bloqueo.

Adquirir el bloqueo¶

Adquiere el bloqueo. Este bloqueo se liberará automáticamente después de 60 segundos. Una vez liberado automáticamente, otros clientes podrán adquirir el bloqueo. Puede cambiar este tiempo, pero si lo establece demasiado alto y el script se cierra de forma anormal, es posible que no pueda volver a conectarse al dispositivo durante mucho tiempo, y podría necesitar reiniciarlo para continuar la conexión. Esta interfaz es reentrante; al reingresar, es equivalente a _refresh_lock.

d._acquire_lock(leaseTime=60)

Liberar el bloqueo¶

Libera activamente el bloqueo de la API, permitiendo que otros clientes puedan adquirirlo.

d._release_lock()

Actualizar el bloqueo¶

Actualiza el bloqueo. Cada llamada establece el tiempo de expiración del bloqueo a este leaseTime. Realice llamadas periódicas a esta interfaz para mantener el bloqueo de la API. De manera similar, si leaseTime es demasiado alto y el script se cierra de forma anormal, es posible que le sea casi imposible volver a conectarse al dispositivo.

d._refresh_lock(leaseTime=60)