Back to Qt.io
Contact Us Blog Download Qt

QSensorReading Class

QSensorReading クラスは、センサーからの読み取り値を保持します。詳細...

ヘッダー #include <QSensorReading>
CMake： find_package(Qt6 REQUIRED COMPONENTS Sensors)
target_link_libraries(mytarget PRIVATE Qt6::Sensors)
qmake： QT += sensors
を継承する： QObject
継承される
13 タイプ

QAccelerometerReading,QAmbientLightReading,QAmbientTemperatureReading,QCompassReading,QGyroscopeReading,QHumidityReading,QLightReading,QMagnetometerReading,QOrientationReading,QPressureReading,QProximityReading,QRotationReading, andQTiltReading

プロパティ

パブリック関数

void setTimestamp(quint64 timestamp)
quint64 timestamp() const
QVariant value(int index) const
int valueCount() const

マクロ

DECLARE_READING(classname)
IMPLEMENT_READING(classname)

詳細説明

QSensorReadingはそれ自体では特に役に立たないことに注意。各センサーの興味深いデータはQSensorReadingのサブクラスで定義される。

プロパティ ドキュメント

[read-only] timestamp : const quint64

このプロパティは、読み取り値のタイムスタンプを保持する。

タイムスタンプの値は、固定点からのマイクロ秒です。タイムスタンプを使用して、2つのセンサーの読み取り値がどの程度離れているかを確認することができます。

異なるセンサーからのセンサーのタイムスタンプは直接比較できないかもしれないことに注意してください（参照するために異なる固定点を選択する可能性があるため）。

いくつかのプラットフォームはタイムスタンプを正しく配信しないことに注意してください。アプリケーションは、時折タイムスタンプが後ろにジャンプする問題に備える必要がある。

関数にアクセスする：

quint64 timestamp() const

メンバー関数ドキュメント

void QSensorReading::setTimestamp(quint64 timestamp)

timestamp を設定する。

timestamp()も参照のこと 。

quint64 QSensorReading::timestamp() const

読み取りのタイムスタンプを返す。

メモ： timestamp プロパティのゲッター関数。

setTimestamp()も参照 。

QVariant QSensorReading::value(int index) const

index にあるプロパティの値を返す。

この関数は、データ関数を直接呼び出すよりも遅いことに注意してください。

以下は、さまざまな方法でプロパティを取得する例です。

直接アクセスするのが最もパフォーマンスが良いですが、アクセスするデータに関するコンパイル時の知識が必要です。

QAccelerometerReading *reading = ...;
qreal x = reading->x();

名前を使ってプロパティにアクセスすることもできます。この場合、QObject::property （）を呼び出す必要があります。

qreal x = reading->property("x").value<qreal>();

最後に、数値インデックスを使って値にアクセスすることもできます。

qreal x = reading->value(0).value<qreal>();

value()でアクセスできるのは、QSensorReading のサブクラスでQ_PROPERTY() と宣言されたプロパティだけです。

valueCount() およびQObject::property()も参照して ください。

int QSensorReading::valueCount() const

読み込みが持つ余分なプロパティの数を返す。

QSensorReading で宣言されたプロパティはカウントされないことに注意してください。

例として、このクラスには3つのプロパティが定義されているため、QAccelerometerReading 。

マクロ・ドキュメント

DECLARE_READING(classname)

DECLARE_READING マクロは、いくつかの必須メソッドを読みクラスに追加する。

このマクロはすべてのリーディング・クラスに使用する必要があります。読み込みクラスのclassname を渡してください。

class MyReadingPrivate;

class MyReading : public QSensorReading
{
    Q_OBJECT
    Q_PROPERTY(qreal myprop READ myprop)
    DECLARE_READING(MyReading)
public:
    qreal myprop() const;
    void setMyprop(qreal myprop);
};

IMPLEMENT_READING()も参照してください 。

IMPLEMENT_READING(classname)

IMPLEMENT_READING マクロは、読み取りクラスに必要なメソッドを実装する。

このマクロはすべての読み取りクラスに使用する必要があります。ヘッダー・ファイルではなく、単一のコンパイル・ユニット（ソース・ファイル）に配置する必要があります。読み取りクラスのclassname を渡してください。

IMPLEMENT_READING(MyReading)

DECLARE_READING()も参照 。

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.