Class: QgsSensorManager¶

Manages sensors.

QgsSensorManager handles the storage, serializing and deserializing of sensors. Usually this class is not constructed directly, but rather accessed through a QgsProject via QgsProject.sensorManager().

Added in version 3.32.

Class Hierarchy¶

Base classes¶

QObject

Methods

`addSensor`	Registers a new sensor.
`clear`	Deregisters and removes all sensors from the manager.
`readXml`	Reads the manager's state from a DOM element, restoring all sensors present in the XML document.
`removeSensor`	Removes a registered sensor matching a given id.
`sensor`	Returns a registered sensor pointer matching a given id.
`sensorData`	Returns the last captured data from a registered sensor matching a given name.
`sensorNames`	Returns a list of registered sensor names.
`sensors`	Returns a list of pointers to all registered sensors.
`sensorsData`	Returns the last captured data of all registered sensors.
`writeXml`	Returns a DOM element representing the state of the manager.

Signals

`sensorAboutToBeRemoved`	Emitted when a sensor is about to be removed.
`sensorAdded`	Emitted when a sensor has been registered.
`sensorDataCaptured`	Emitted when newly captured data from a sensor has occurred.
`sensorErrorOccurred`	Emitted when a sensor error has occurred.
`sensorNameChanged`	Emitted when a sensor name has changed.
`sensorRemoved`	Emitted when a sensor has been removed.
`sensorStatusChanged`	Emitted when a sensor status has changed.

class qgis.core.QgsSensorManager[source]¶

Bases: QObject

__init__(parent: QObject | None = None)

Constructor for QgsSensorManager, with the specified parent object.

Parameters:: parent (Optional[QObject] = None)

addSensor(self, sensor: QgsAbstractSensor | None)[source]¶

Registers a new sensor. The sensor name does not require uniqueness; sensors will the same name will store their data in the same sensor name key, allowing for registration of sensors to cover multiple devices (e.g. two serial port sensors with alternative port name to cover two machines).

Note

Takes ownership of the sensor.

Parameters:: sensor (Optional[QgsAbstractSensor])

clear(self)[source]¶: Deregisters and removes all sensors from the manager.

readXml(self, element: QDomElement, document: QDomDocument) → bool[source]¶

Reads the manager’s state from a DOM element, restoring all sensors present in the XML document.