Manual de usuario de calibre, Publicación 2.73.0 get _ device _ uid() Debe devolver una única ID para el dispositivo conectado actualmente( esto es llamado inmediatamente tras una llamada exitosa para abrir()). Usted debe implementar este método si selecciona ASK _ TO _ ALLOW _ CONNECT = True
ignore _ connected _ device( uid) Debería ignorar el dispositivo identificado por uid( elresultado de una llamada a get _ device _ uid()) en el futuro. Usted debe implementar este método si selecciona ASK _ TO _ ALLOW _ CONNECT = True. Note que esta función es llamada inmediatamente tras abrir(), así que si() se manifiesta, el dispositivo debería reiniciar esa manifestación.
get _ user _ blacklisted _ devices() Devuelve a la uid de mapa o dispositivo a un nombre amigable para todos los dispositivos que el usuario ha pedido que sean pasados por alto.
set _ user _ blacklisted _ devices( devices) Establecer la lista de uids de dispositivo que deben ser ignorados por este controlador.
specialize _ global _ preferences( device _ prefs) Implemente este método si su dispositivo quiere invalidar una preferencia particular. Usted debe asegurarse de que todos los sitios de llamada que quieran una preferencia que pueda ser invalidad utilicen device _ prefs [’ something’] en lugar de prefs [’ something’]. Su método debería de llamar a device _ prefs. set _ overrides( pref = val, pref = val,...). Actualmente utilizado para: metadata management( prefs [’ manage _ device _ metadata’])
set _ library _ info( library _ name, library _ uuid, field _ metadata) Emplemente este método si quiere información sobre la biblioteca actual de calibre. Este método es llamado en el arranque y cuando la biblioteca de Calibre cambia mientras está conectado.
is _ dynamically _ controllable() Llamado por el gerente cuando se inician los plugins. Si este método vevuelve un cordón, entonces a) soporta el control de interfaz dinámica del gerente del dispositivo, y b) ese nombre se utiliza cuando se comunica con el plugin.
Este método puede ser llamado en el hilo de la GUI. Un conductor que implemente este método debe estar de hilo seguro.
start _ plugin() Este método es llamado al iniciarse el plugin. El plugin debería empezar a aceptar conexiones de dispositivo. Si el plugin está ya aceptando conexiones, no hace nada.
Este método puede ser llamado en el hilo de la GUI. Un conductor que implemente este método debe estar de hilo seguro.
stop _ plugin() Este método es llamado para detener el plugin. El plugin no debería aceptar más conexiones, y debería limpiar tras sí mismo. Es probable que este métoso llame al apagado. Si el plugin ya no está aceptando conexiones, no hace nada.
Este método puede ser llamado en el hilo de la GUI. Un conductor que implemente este método debe estar de hilo seguro.
get _ option( opt _ string, default = None) Devuelve el valor de la opción indicada por opt _ string. Este método puede ser llamado cuando el plugin no se ha iniciado. Devuelve None si la opción no existe.
Este método puede ser llamado en el hilo de la GUI. Un conductor que implemente este método debe estar de hilo seguro.
1.10. Personalizar calibre 227