QSensor Class

Eigenschaft Dokumentation

active : bool

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

Sie ist true, wenn der Sensor aktiv ist (Werte liefert). Andernfalls ist dieser Wert falsch.

Beachten Sie, dass das Setzen dieses Wertes auf true keine unmittelbare Wirkung hat. Stattdessen wird der Sensor gestartet, sobald die Ereignisschleife erreicht ist.

Zugriffsfunktionen:

Melder-Signal:

alwaysOn : bool

Diese Eigenschaft enthält einen Wert, der angibt, ob der Sensor in Betrieb bleiben soll, wenn der Bildschirm ausgeschaltet ist.

Auf einigen Plattformen werden Sensoren ausgesetzt, wenn der Bildschirm ausgeschaltet wird. Wenn Sie diese Eigenschaft auf true setzen, wird der Sensor weiterlaufen.

Zugriffsfunktionen:

Benachrichtigungssignal:

[read-only] availableDataRates : const qrangelist

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

Dies ist eine Liste der Datenraten, die der Sensor unterstützt. Gemessen in Hertz.

Die Einträge in der Liste können diskrete Raten oder einen kontinuierlichen Bereich von Raten darstellen. Eine diskrete Rate ist dadurch gekennzeichnet, dass beide Werte gleich sind.

Beachten Sie, dass diese Angabe nicht zwingend erforderlich ist, da nicht alle Sensoren über eine bestimmte Geschwindigkeit verfügen, mit der sie arbeiten. In solchen Fällen ist die Liste leer.

Zugriffsfunktionen:

Siehe auch QSensor::dataRate und qrangelist.

axesOrientationMode : AxesOrientationMode

Diese Eigenschaft enthält den Modus, der sich darauf auswirkt, wie die Bildschirmausrichtung die Lesewerte verändert.

Wenn sie auf FixedOrientation gesetzt ist, was der Standardmodus ist, wird keine automatische Drehung auf die Lesung 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 Ablesewerte automatisch gedreht, wenn sich die Bildschirmausrichtung ändert. Die Bildschirmausrichtung wird also aufgehoben.

Nehmen wir als Beispiel an, dass das Gerät um 180 Grad gedreht wird und somit auch die Bildschirmausrichtung um 180 Grad gegenüber der ursprünglichen Ausrichtung gedreht wird. Ohne die automatische Achsenausrichtung würden sich nun die Messwerte ändern: Sowohl der X- als auch der Y-Wert würden negiert, so dass ein Anwendungsentwickler gezwungen wäre, die Negation im Anwendungscode manuell aufzuheben. Die automatische Achsenausrichtung tut dies automatisch, in diesem Modus wären die X- und Y-Werte dieselben wie bei der Standard-Bildschirmausrichtung.

Diese automatische Achsendrehung ist in einigen Anwendungsfällen praktisch, z. B. in einer Wasserwaagenanwendung, die anhand des X-Achsenwerts eines Beschleunigungsmessers misst, wie eben eine Oberfläche ist. Wenn sich die Ausrichtung des Geräts und des Bildschirms um 90 Grad ändert, braucht der Anwendungsentwickler nichts zu ändern, er kann den Wert der X-Achse weiter verwenden, auch wenn das Gerät gedreht wird. Ohne automatische Achsenausrichtung müsste der Anwendungsentwickler stattdessen auf die Y-Werte achten und somit der Anwendung Code hinzufügen, der je nach Bildschirmausrichtung eine andere Achse ausliest.

Der Modus UserOrientation ist dem Modus AutomaticOrientation sehr ähnlich, nur dass die Bildschirmausrichtung manuell gesteuert und nicht automatisch bestimmt wird. Der Winkel der Eigenschaft userOrientation wird dann zum Drehen der Lesewerte verwendet.

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

Diese Eigenschaft wird nur für ausrichtbare Sensoren verwendet.

Zugriffsfunktionen:

Melder-Signal:

bufferSize : int

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

Wird bufferSize größer als maxBufferSize eingestellt, wird maxBufferSize verwendet.

Die Pufferung ist eingeschaltet, wenn bufferSize größer als 1 ist. Der Sensor sammelt die angeforderte Anzahl von Proben und liefert sie alle auf einmal an die Anwendung. Es ist daher besonders wichtig, dass die Anwendung jeden Messwert sofort verarbeitet oder die Werte an anderer Stelle speichert.

Wenn stop() bei laufender Pufferung aufgerufen wird, wird der Teilpuffer nicht geliefert.

Wenn der Sensor mit der Option Pufferung gestartet wird, werden die Werte von diesem Moment an gesammelt. Es gibt keinen bereits existierenden Puffer, der genutzt werden kann.

Einige Backends unterstützen nur die Aktivierung oder Deaktivierung des Puffers und bieten keine Kontrolle über die Größe. In diesem Fall werden die Eigenschaften maxBufferSize und efficientBufferSize möglicherweise gar nicht gesetzt, obwohl die Pufferung unterstützt wird. Wenn Sie die Eigenschaft bufferSize auf einen Wert größer als 1 setzen, wird die Pufferung aktiviert. Nachdem der Sensor gestartet wurde, wird die Eigenschaft bufferSize vom Backend auf den aktuellen Wert gesetzt.

Zugriffsfunktionen:

Benachrichtigungssignal:

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

[read-only] busy : const bool

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

Einige Sensoren können im System vorhanden sein, aber nicht verwendet werden. Diese Funktion gibt true zurück, wenn der Sensor belegt ist. Sie können den Sensor dann nicht über start() aufrufen.

Beachten Sie, dass diese Funktion nicht true zurückgibt, wenn Sie den Sensor verwenden, sondern nur, wenn ein anderer Prozess den Sensor verwendet.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch busyChanged().

[read-only] connectedToBackend : const bool

Diese Eigenschaft enthält einen Wert, der angibt, ob der Sensor mit einem Backend verbunden ist.

Ein Sensor, der nicht mit einem Backend verbunden ist, kann nichts Nützliches tun.

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

Zugriffsfunktionen:

[read-only] currentOrientation : const int

Diese Eigenschaft enthält die aktuelle Ausrichtung, die für die Drehung der Messwerte verwendet wird.

Dies ist möglicherweise nicht die gleiche wie die Bildschirmausrichtung. Im Modus FixedOrientation werden die Messwerte beispielsweise nicht gedreht, weshalb die Eigenschaft 0 ist.

Im Modus UserOrientation werden die Messwerte auf der Grundlage der Eigenschaft userOrientation gedreht, und daher ist diese Eigenschaft gleich der Eigenschaft userOrientation.

Im Modus AutomaticOrientation werden die Messwerte auf der Grundlage der Bildschirmausrichtung gedreht, und daher entspricht diese Eigenschaft der aktuellen Bildschirmausrichtung.

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

Zugriffsfunktionen:

Melder-Signal:

dataRate : int

Diese Eigenschaft enthält die Datenrate, mit der der Sensor betrieben werden soll.

Gemessen in Hertz.

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

Die Einstellung dieser Eigenschaft ist nicht portabel und kann zu Konflikten mit anderen Anwendungen führen. Erkundigen Sie sich beim Sensor-Backend und in der Plattformdokumentation nach den Richtlinien für die Anforderung einer Datenrate durch mehrere Anwendungen.

Der Standardwert (0) bedeutet, dass es der Anwendung egal ist, wie hoch die Datenrate ist. Anwendungen sollten eine zeitgesteuerte Abfrage des aktuellen Wertes in Betracht ziehen oder sicherstellen, dass der Code, der die Werte verarbeitet, sehr schnell ausgeführt werden kann, da die Plattform möglicherweise Hunderte von Aktualisierungen pro Sekunde bereitstellt.

Dieser Wert 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 aktuelle Datenrate zu ermitteln, die von der Plattform verwendet wird.

Zugriffsfunktionen:

Benachrichtigungssignal:

Siehe auch QSensor::availableDataRates.

[read-only] description : const QString

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

Zugriffsfunktionen:

[read-only] efficientBufferSize : const int

Die Eigenschaft enthält die effizienteste Puffergröße. Normalerweise ist dies 1 (was bedeutet, dass keine bestimmte Größe am effizientesten ist). Einige Sensortreiber haben einen FIFO-Puffer, der es effizienter macht, Messwerte in der Größe des FIFOs auf einmal zu liefern.

Zugriffsfunktionen:

Benachrichtigungssignal:

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

[read-only] error : const int

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

Beachten Sie, dass Fehlercodes sensorspezifisch sind.

Zugriffsfunktionen:

Melder-Signal:

identifier : QByteArray

Diese Eigenschaft enthält den Backend-Bezeichner für den Sensor.

Beachten Sie, dass der Bezeichner automatisch ausgefüllt wird, wenn der Sensor mit einem Backend verbunden wird. Wenn Sie ein bestimmtes Backend verbinden möchten, sollten Sie setIdentifier() vor connectToBackend() aufrufen.

Zugriffsfunktionen:

Melder-Signal:

[read-only] maxBufferSize : const int

Die Eigenschaft enthält die maximale Puffergröße.

Beachten Sie, dass dieser Wert 1 sein kann, wenn der Sensor keine Pufferung unterstützt. 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 stellt den zu verwendenden Index in der Liste QSensor::outputRanges dar.

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

Der Standardwert (-1) bedeutet, dass es der Anwendung egal ist, was der Ausgabebereich ist.

Beachten Sie, dass es keinen Mechanismus gibt, um den aktuellen Ausgabebereich zu ermitteln, der von der Plattform verwendet wird.

Zugriffsfunktionen:

Siehe auch QSensor::outputRanges.

[read-only] outputRanges : const qoutputrangelist

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

Ein Sensor kann mehr als einen Ausgangsbereich haben. In der Regel wird dies getan, um einen größeren Messbereich auf Kosten einer geringeren Genauigkeit zu erhalten.

Beachten Sie, dass diese Information nicht zwingend erforderlich ist. Diese Information ist in der Regel nur für Sensoren verfügbar, die wählbare Ausgangsbereiche haben (wie z. B. typische Beschleunigungsaufnehmer).

Zugriffsfunktionen:

Siehe auch QSensor::outputRange und qoutputrangelist.

[read-only] reading : QSensorReading* const

Diese Eigenschaft enthält die Leseklasse.

Die Leseklasse ermöglicht den Zugriff auf Sensormesswerte. Das Leseobjekt ist ein flüchtiger Zwischenspeicher der zuletzt empfangenen Sensormesswerte, so dass die Anwendung die Messwerte sofort verarbeiten oder die Werte für eine spätere Verarbeitung irgendwo speichern sollte.

Beachten Sie, dass dies 0 zurückgibt, bis ein Sensor-Backend mit einem Backend verbunden ist.

Beachten Sie auch, 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 doppelten Messwerten aktiviert ist, werden aufeinanderfolgende Messwerte mit denselben oder sehr ähnlichen Werten ausgelassen. Dies trägt zur Verringerung des Verarbeitungsaufwands bei, da weniger Sensormesswerte zur Verfügung stehen. Dies hat zur Folge, dass die Messwerte in unregelmäßigen Abständen eintreffen.

Das Überspringen von Duplikaten wird nicht nur bei exakt gleichen Messwerten aktiviert, sondern auch bei sehr ähnlichen Messwerten, da jeder Sensor einen gewissen Jitter aufweist, selbst wenn das Gerät nicht bewegt wird.

Die Unterstützung für diese 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 wirksam, wenn der Sensor gestartet wird; eine Änderung der Eigenschaft, während der Sensor aktiv ist, hat keine unmittelbare Auswirkung.

Zugriffsfunktionen:

Melder-Signal:

[read-only] type : const QByteArray

Diese Eigenschaft enthält den Typ des Sensors.

Zugriffsfunktionen:

userOrientation : int

Diese Eigenschaft enthält den Winkel, der für die Drehung der Ablesewerte im Modus UserOrientation verwendet wird.

Wenn die Eigenschaft axesOrientationMode auf UserOrientation eingestellt ist, wird der Winkel für die Drehung der Ablesewerte von 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 ist nur für ausrichtbare Sensoren gültig.

Zugriffsfunktionen:

Melder-Signal:

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;