QSensor Class

Dokumentation zur Eigenschaft

active : bool

Diese Eigenschaft enthält einen Wert, der angibt, ob der Sensor aktiv ist.

Dieser Wert ist „true“, wenn der Sensor aktiv ist (Werte zurückgibt). Andernfalls ist er „false“.

Beachten Sie, dass die Einstellung dieses Werts auf „true“ keine sofortige Wirkung hat. Stattdessen wird der Sensor gestartet, sobald die Ereignisschleife erreicht ist.

Zugriffsfunktionen:

Notifier-Signal:

alwaysOn : bool

Diese Eigenschaft enthält einen Wert, der angibt, ob der Sensor auch bei ausgeschaltetem Bildschirm weiterlaufen soll.

Auf einigen Plattformen werden Sensoren standardmäßig angehalten, wenn der Bildschirm ausgeschaltet wird. Wenn Sie diese Eigenschaft auf „true“ setzen, wird sichergestellt, dass der Sensor weiterhin läuft.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] availableDataRates : qrangelist

Diese Eigenschaft enthält die Datenraten, die der Sensor unterstützt.

Dies ist eine Liste der vom Sensor unterstützten Datenraten. Gemessen in Hertz.

Einträge in der Liste können diskrete Raten oder einen kontinuierlichen Ratenbereich darstellen. Eine diskrete Rate wird dadurch gekennzeichnet, dass beide Werte identisch sind.

Beachten Sie, dass diese Angabe nicht obligatorisch ist, da nicht alle Sensoren mit einer bestimmten Rate arbeiten. In solchen Fällen ist die Liste leer.

Zugriffsfunktionen:

Siehe auch QSensor::dataRate und qrangelist.

axesOrientationMode : AxesOrientationMode

Diese Eigenschaft legt den Modus fest, der bestimmt, wie sich die Bildschirmausrichtung auf die angezeigten Werte auswirkt.

Bei der Einstellung „ FixedOrientation “ (Standardmodus) wird keine automatische Drehung auf die Messwerte angewendet. Dies ist der einzige verfügbare Modus für Backends, die die Funktion „ QSensor::AxesOrientation “ nicht unterstützen.

Bei der Einstellung „ AutomaticOrientation “ werden die Messwerte automatisch gedreht, wenn sich die Bildschirmausrichtung ändert. Im Endeffekt wird die Bildschirmausrichtung aufgehoben.

Nehmen wir als Beispiel an, das Gerät wird um 180 Grad gedreht, wodurch sich auch die Bildschirmausrichtung um 180 Grad gegenüber der nativen Ausrichtung dreht. Ohne automatische Achsenausrichtung würden sich die Messwerte nun ändern: Sowohl die X- als auch die Y-Werte würden negiert, was einen Anwendungsentwickler dazu zwingen würde, die Negation im Anwendungscode manuell aufzuheben. Die automatische Achsenausrichtung erledigt dies automatisch; in diesem Modus wären die X- und Y-Werte dieselben wie bei der Standard-Bildschirmausrichtung.

Diese automatische Drehung der Achsen ist in einigen Anwendungsfällen praktisch, zum Beispiel in einer Wasserwaagen-Anwendung, die anhand des X-Achsenwerts eines Beschleunigungssensors misst, wie eben eine Oberfläche ist. Wenn sich die Geräte- und Bildschirmausrichtung um 90 Grad ändert, muss der Anwendungsentwickler nichts ändern; er kann den X-Achsenwert weiterhin verwenden, obwohl das Gerät gedreht wurde. Ohne automatische Achsenausrichtung müsste der Anwendungsentwickler stattdessen die Y-Werte heranziehen und somit Code zur Anwendung hinzufügen, der je nach Bildschirmausrichtung von einer anderen Achse ausliest.

Der Modus „ UserOrientation “ ähnelt dem Modus „ AutomaticOrientation “ sehr, nur dass die Bildschirmausrichtung manuell gesteuert statt automatisch bestimmt wird. Der Winkel der Eigenschaft „ userOrientation “ wird dann zum Drehen der Messwerte verwendet.

Da die Drehung der Messwerte auf der Bildschirmausrichtung basiert, ändern sich die Z-Werte niemals, da die Z-Achse senkrecht zum Bildschirm steht. Da sich die Bildschirmausrichtung in 90-Grad-Schritten ändert, erfolgt die Drehung der Messwerte ebenfalls in 90-Grad-Schritten.

Diese Eigenschaft wird nur bei drehbaren Sensoren verwendet.

Zugriffsfunktionen:

Benachrichtigungssignal:

bufferSize : int

Diese Eigenschaft gibt die Größe des Puffers an. Standardmäßig beträgt die Puffergröße 1, was bedeutet, dass keine Pufferung stattfindet. Wenn die maximale Puffergröße 1 beträgt, wird die Pufferung vom Sensor nicht unterstützt.

Wird „bufferSize“ auf einen Wert größer als „ maxBufferSize “ gesetzt, wird „ maxBufferSize “ verwendet.

Die Pufferung ist aktiviert, wenn „bufferSize“ größer als 1 ist. Der Sensor sammelt die angeforderte Anzahl von Messwerten und übermittelt sie alle auf einmal an die Anwendung. Sie werden der Anwendung als Burst geänderter Messwerte übermittelt, daher ist es besonders wichtig, dass die Anwendung jeden Messwert sofort verarbeitet oder die Werte an anderer Stelle speichert.

Wird „ stop()“ aufgerufen, während die Pufferung läuft, wird der teilweise gefüllte Puffer nicht übergeben.

Wird der Sensor mit der Pufferungsoption gestartet, werden die Werte ab diesem Zeitpunkt erfasst. Es gibt keinen bereits vorhandenen Puffer, der genutzt werden kann.

Einige Backends unterstützen lediglich das Aktivieren oder Deaktivieren des Puffers und bieten keine Kontrolle über dessen Größe. In diesem Fall sind die Eigenschaften ` maxBufferSize ` und ` efficientBufferSize ` möglicherweise gar nicht festgelegt, obwohl die Pufferung unterstützt wird. Durch Setzen der Eigenschaft `bufferSize` auf einen beliebigen Wert größer als 1 wird die Pufferung aktiviert. Nach dem Start des Sensors wird die Eigenschaft „bufferSize“ vom Backend auf den tatsächlichen Wert gesetzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QSensor::maxBufferSize “ und „ QSensor::efficientBufferSize “.

[read-only] busy : bool

Diese Eigenschaft enthält einen Wert, der angibt, ob der Sensor beschäftigt ist.

Manche Sensoren sind zwar im System vorhanden, stehen jedoch nicht zur Nutzung zur Verfügung. Diese Funktion gibt „true“ zurück, wenn der Sensor belegt ist. Sie können den Sensor in diesem Fall nicht mit „ start()“ abrufen.

Beachten Sie, dass diese Funktion nicht „true“ zurückgibt, wenn Sie den Sensor gerade nutzen, sondern nur, wenn ein anderer Prozess den Sensor nutzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch ` busyChanged()`.

[read-only] connectedToBackend : bool

Diese Eigenschaft enthält einen Wert, der angibt, ob der Sensor eine Verbindung zu einem Backend hergestellt hat.

Ein Sensor, der nicht mit einem Backend verbunden ist, kann keine nützlichen Funktionen ausführen.

Rufen Sie die Methode ` connectToBackend()` auf, um den Sensor zu zwingen, sofort eine Verbindung zu einem Backend herzustellen. Diese Methode wird automatisch aufgerufen, wenn Sie ` start()` aufrufen; Sie müssen dies also nur tun, wenn Sie Zugriff auf Sensoreigenschaften benötigen (z. B. um die Metadaten des Sensors abzufragen, bevor Sie ihn verwenden).

Zugriffsfunktionen:

[read-only] currentOrientation : int

Diese Eigenschaft enthält die aktuelle Ausrichtung, die zum Drehen der Messwerte verwendet wird.

Diese entspricht möglicherweise nicht der Bildschirmausrichtung. Im Modus „ FixedOrientation “ werden die Messwerte beispielsweise nicht gedreht, weshalb die Eigenschaft den Wert 0 annimmt.

Im Modus „ UserOrientation “ werden die Messwerte basierend auf der Eigenschaft „ userOrientation “ gedreht, weshalb diese Eigenschaft der Eigenschaft „ userOrientation “ entspricht.

Im Modus „ AutomaticOrientation “ werden die Messwerte entsprechend der Bildschirmausrichtung gedreht, weshalb diese Eigenschaft der aktuellen Bildschirmausrichtung entspricht.

Diese Eigenschaft wird vom Backend festgelegt und gilt nur für ausrichtbare Sensoren.

Zugriffsfunktionen:

Benachrichtigungssignal:

dataRate : int

Diese Eigenschaft gibt die Datenrate an, mit der der Sensor betrieben werden soll.

Gemessen in Hertz.

Die Datenrate ist die maximale Frequenz, mit der der Sensor Änderungen erfassen kann.

Die Einstellung dieser Eigenschaft ist nicht plattformübergreifend und kann zu Konflikten mit anderen Anwendungen führen. Informieren Sie sich in der Dokumentation zum Sensor-Backend und zur Plattform über etwaige Richtlinien bezüglich mehrerer Anwendungen, die eine Datenrate anfordern.

Der Standardwert (0) bedeutet, dass es für die App unerheblich ist, wie hoch die Datenrate ist. Anwendungen sollten in Erwägung ziehen, den aktuellen Wert zeitgesteuert abzufragen, oder sicherstellen, dass der Code zur Verarbeitung der Werte sehr schnell ausgeführt werden kann, da die Plattform möglicherweise Hunderte von Aktualisierungen pro Sekunde bereitstellt.

Dies sollte vor dem Aufruf von ` start()` festgelegt werden, da der Sensor Änderungen an diesem Wert möglicherweise nicht bemerkt, während er läuft.

Beachten Sie, dass es keinen Mechanismus gibt, um die aktuell von der Plattform verwendete Datenrate zu ermitteln.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch ` QSensor::availableDataRates`.

[read-only] description : QString

Diese Eigenschaft enthält eine beschreibende Zeichenfolge für den Sensor.

Zugriffsfunktionen:

[read-only] efficientBufferSize : int

Die Eigenschaft enthält die effizienteste Puffergröße. Normalerweise ist dieser Wert 1 (was bedeutet, dass keine bestimmte Größe am effizientesten ist). Einige Sensortreiber verfügen über einen FIFO-Puffer, wodurch es effizienter ist, Messwerte im Umfang der FIFO-Größe auf einmal zu übermitteln.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QSensor::bufferSize und QSensor::maxBufferSize.

[read-only] error : int

Diese Eigenschaft enthält den zuletzt am Sensor gesetzten Fehlercode.

Beachten Sie, dass Fehlercodes sensorspezifisch sind.

Zugriffsfunktionen:

Benachrichtigungssignal:

identifier : QByteArray

Diese Eigenschaft enthält die Backend-Kennung des Sensors.

Beachten Sie, dass die Kennung automatisch ausgefüllt wird, sobald der Sensor mit einem Backend verbunden ist. Wenn Sie eine Verbindung zu einem bestimmten Backend herstellen möchten, sollten Sie setIdentifier() vor connectToBackend() aufrufen.

Zugriffsfunktionen:

Notifier-Signal:

[read-only] maxBufferSize : int

Die Eigenschaft gibt die maximale Puffergröße an.

Beachten Sie, dass dieser Wert 1 sein kann; in diesem Fall unterstützt der Sensor keinerlei Pufferung. In diesem Fall gibt „ isFeatureSupported “ (QSensor::Buffering) ebenfalls „false“ zurück.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch „ QSensor::bufferSize “ und „ QSensor::efficientBufferSize “.

outputRange : int

Diese Eigenschaft enthält den vom Sensor verwendeten Ausgabebereich.

Dieser Wert gibt den Index in der Liste „ QSensor::outputRanges “ an, der verwendet werden soll.

Die Einstellung dieser Eigenschaft ist nicht portabel und kann zu Konflikten mit anderen Anwendungen führen. Informieren Sie sich in der Dokumentation zum Sensor-Backend und zur Plattform über etwaige Richtlinien bezüglich mehrerer Anwendungen, die einen Ausgabebereich anfordern.

Der Standardwert (-1) bedeutet, dass es für die App unerheblich ist, welcher Ausgabebereich verwendet wird.

Beachten Sie, dass es keinen Mechanismus gibt, um den aktuell von der Plattform verwendeten Ausgabebereich zu ermitteln.

Zugriffsfunktionen:

Siehe auch „ QSensor::outputRanges “.

[read-only] outputRanges : qoutputrangelist

Diese Eigenschaft enthält eine Liste der vom Sensor unterstützten Messbereiche.

Ein Sensor kann über mehr als einen Ausgangsbereich verfügen. In der Regel wird dies getan, um einen größeren Messbereich zu erzielen, wobei jedoch die Genauigkeit beeinträchtigt wird.

Beachten Sie, dass diese Angabe nicht zwingend erforderlich ist. Diese Information ist in der Regel nur für Sensoren verfügbar, die über wählbare Ausgangsbereiche verfügen (wie beispielsweise typische Beschleunigungssensoren).

Zugriffsfunktionen:

Siehe auch QSensor::outputRange und qoutputrangelist.

[read-only] reading : QSensorReading*

Diese Eigenschaft enthält die Leseklasse.

Die Leseklasse ermöglicht den Zugriff auf Sensorwerte. Das Leseobjekt ist ein flüchtiger Cache des zuletzt empfangenen Sensorwerts. Daher sollte die Anwendung die Werte sofort verarbeiten oder sie zur späteren Verarbeitung an einem Ort speichern.

Beachten Sie, dass hier 0 zurückgegeben wird, bis ein Sensor-Backend mit einem Backend verbunden ist.

Beachten Sie außerdem, dass die Messwerte nach dem Aufruf von ` start()` nicht sofort verfügbar sind. Anwendungen müssen warten, bis das Signal ` readingChanged()` ausgegeben wird.

Zugriffsfunktionen:

Notifier-Signal:

Siehe auch ` isConnectedToBackend()` und ` start()`.

skipDuplicates : bool

Gibt an, ob doppelte Messwerte ausgelassen werden sollen.

Wenn das Überspringen von Duplikaten aktiviert ist, werden aufeinanderfolgende Messwerte mit identischen oder sehr ähnlichen Werten ausgelassen. Dies trägt dazu bei, den Verarbeitungsaufwand zu reduzieren, da weniger Sensorwerte zur Verfügung stehen. Infolgedessen treffen die Messwerte in unregelmäßigen Abständen ein.

Das Überspringen von Duplikaten wird nicht nur für Messwerte aktiviert, die exakt identisch sind, sondern auch für solche, die einander sehr ähnlich sind, da jeder Sensor eine gewisse Schwankung aufweist, selbst wenn das Gerät nicht bewegt wird.

Die Unterstützung dieser Eigenschaft hängt vom Backend ab. Verwenden Sie ` isFeatureSupported()``, um zu prüfen, ob sie auf der aktuellen Plattform unterstützt wird.

Das Überspringen von Duplikaten ist standardmäßig deaktiviert.

Das Überspringen von Duplikaten wird beim Start des Sensors wirksam; eine Änderung der Eigenschaft bei aktivem Sensor hat keine unmittelbare Wirkung.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] type : const QByteArray

Diese Eigenschaft enthält den Typ des Sensors.

Zugriffsfunktionen:

userOrientation : int

Diese Eigenschaft enthält den Winkel, der im Modus „ UserOrientation “ zur Drehung der Messwerte verwendet wird.

Wenn die Eigenschaft „ axesOrientationMode “ auf „ UserOrientation “ gesetzt ist, wird der Winkel für die Drehung der Anzeigewerte aus dieser Eigenschaft übernommen. In anderen Modi hat die Eigenschaft keine Auswirkung.

Der Standardwert ist 0. Die einzigen gültigen Werte sind 0, 90, 180 und 270, da dies die einzigen möglichen Bildschirmausrichtungen sind.

Diese Eigenschaft gilt nur für ausrichtbare Sensoren.

Zugriffsfunktionen:

Benachrichtigungssignal:

QSensor *magnetometer = new QSensor(QMagnetometer::sensorType, this);

QMagnetometer *magnetometer = new QMagnetometer(this);

sensor.start();
if (sensor.isBusy()) {
    // need to wait for busyChanged signal and try again
}

sensor->start();
sensor->reading()->x(); // no data available

    connect(sensor, SIGNAL(readingChanged()), this, SLOT(checkReading()));
    sensor->start();
}
void MyClass::checkReading() {
    sensor->reading()->x();

typedef QList<qoutputrange> qoutputrangelist;

typedef QPair<int,int> qrange;

typedef QList<qrange> qrangelist;