QSensor Class

プロパティの説明

active : bool

このプロパティは、センサーがアクティブであるかどうかを示す値を保持する。

センサーがアクティブである（値を返す）場合、これは真である。そうでない場合は false となる。

この値をtrueに設定しても、すぐに効果が出るわけではないことに注意してください。代わりに、イベントループに到達した時点でセンサーが開始される。

アクセス関数

通知シグナル

alwaysOn : bool

このプロパティは、スクリーンがオフのときにセンサーが実行されたままであるべきかどうかを示す値を保持する。

プラットフォームによっては、画面がオフになったときにセンサーを一時停止するポリシーがあります。このプロパティをtrueに設定することで、センサーが実行され続けることを保証します。

アクセス関数

通知シグナル

[read-only] availableDataRates : const qrangelist

このプロパティは、センサーがサポートするデータレートを保持する。

センサーがサポートするデータレートのリストである。単位はヘルツ。

リスト内のエントリは、離散レートまたは連続レートの範囲を表すことができます。離散レートは両方の値が同じであることで示されます。

すべてのセンサーが動作するレートを持っているわけではないので、この情報は必須ではないことに注意してください。そのような場合、リストは空になります。

アクセス関数：

QSensor::dataRate およびqrangelistも参照のこと 。

axesOrientationMode : AxesOrientationMode

このプロパティは、画面の向きが読み取り値をどのように変更するかに影響するモードを保持する。

デフォルトのモードであるFixedOrientation に設定すると、自動回転は適用されません。これは、QSensor::AxesOrientation 機能をサポートしていないバックエンドで使用できる唯一のモードです。

AutomaticOrientation に設定すると、画面の向きが変わったときに読み取り値が自動的に回転する。事実上、画面の向きはキャンセルされる。

例として、デバイスが180度回転し、そのため画面の向きもネイティブの向きから180度回転したとします。自動軸オリエンテーションがなければ、読み取り値は変更されます。X値とY値の両方が否定され、アプリケーション開発者はアプリケーションコードで否定を手動でキャンセルすることを余儀なくされます。このモードでは、X と Y の値はデフォルトの画面の向きと同じになります。

この軸の自動回転は、例えば、加速度センサーのX軸の値を見て、表面がどの程度水平であるかを測定するバブル水準器アプリケーションなど、いくつかの用途で便利です。デバイスと画面の向きが90度変わっても、アプリケーション開発者は何も変更する必要がなく、デバイスが回転してもX軸の値を使い続けることができます。自動軸オリエンテーションがなければ、アプリケーション開発者は代わりにY値を見る必要があり、それによって、画面の向きによって異なる軸から読み取るコードをアプリケーションに追加することになります。

UserOrientation モードはAutomaticOrientation とよく似ていますが、画面の向きが自動的に決定されるのではな く、手動で制御されるだけです。userOrientation プロパティの角度は、読み取り値の回転に使用されます。

読み取り値の回転は画面の向きに基づいて行われるため、Z軸は画面に垂直であるため、Z値が変化することはありません。画面の向きは90度単位で変化するので、読み取り値の回転も90度単位で行われる。

このプロパティは、オリエンタブルセンサにのみ使用される。

アクセス関数

通知信号：

bufferSize : int

このプロパティはバッファのサイズを保持する。デフォルトでは、バッファサイズは1であり、これはバッファリングなしを意味する。最大バッファサイズが 1 の場合、バッファリングはセンサーによってサポートされていません。

bufferSizeをmaxBufferSize より大きく設定すると、maxBufferSize 。

bufferSize が 1 より大きい場合、バッファリングはオンになります。センサーは要求された数のサンプルを収集し、一度にアプリケーショ ンに配信します。センサーは要求された数のサンプルを収集し、一度に全てアプリケーションに配信する。アプリケーションには、変更された読み取り値のバーストとして配信されるため、アプリケーションは各読み取り値を即座に処理するか、どこかに保存することが特に重要である。

バッファリングが進行中にstop() が呼び出された場合、部分的なバッファは配信されません。

センサがバッファリングオプション付きで起動されると、その時点から値が収集されます。既存のバッファを利用することはできません。

いくつかのバックエンドはバッファの有効化または無効化のみをサポートし、サイズの制御は行いません。この場合、maxBufferSize およびefficientBufferSize プロパティは、バッファリングがサポートされているにもかかわらず、まったく設定されない可能性があります。bufferSize プロパティを 1 より大きい値に設定すると、バッファリングが有効になる。センサーの起動後、bufferSize プロパティはバックエンドによって実際の値に設定される。

アクセス関数

アクセス関数： Notifier シグナル：

QSensor::maxBufferSize およびQSensor::efficientBufferSizeも参照のこと 。

[read-only] busy : const bool

このプロパティは、センサがビジー状態であるかどうかを示す値を保持する。

センサーによっては、システム上にあるが使用できない場合がある。センサーがビジー状態の場合、この関数は true を返します。センサーをstart() することはできません。

センサーを使用している場合、この関数は真を返さないことに注意してください。

アクセス関数

通知シグナル：

busyChanged()も参照のこと 。

[read-only] connectedToBackend : const bool

このプロパティは、センサーがバックエンドに接続しているかどうかを示す値を保持する。

バックエンドに接続されていないセンサーは、何も役に立ちません。

センサーを直ちにバックエンドに接続させるには、connectToBackend() メソッドを呼び出します。このメソッドはstart() を呼び出すと自動的に呼び出されるので、センサーのプロパティにアクセスする必要がある場合にのみ実行する必要がある（例えば、センサーのメタデータを使用する前にポーリングする）。

アクセス関数

[read-only] currentOrientation : const int

このプロパティは、読み取り値の回転に使用される現在の向きを保持する。

これは画面の向きと同じではないかもしれない。例えば、FixedOrientation モードでは、読み取り値は回転されないため、このプロパティは 0 となる。

UserOrientation モードでは、userOrientation プロパティに基づいて読み取り値が回転されるため、このプロパティはuserOrientation プロパティと等しくなります。

AutomaticOrientation モードでは、読み取り値は画面の向きに基づいて回転されるため、このプロパティは現在の画面の向きと等しくなる。

このプロパティはバックエンドによって設定され、オリエンテッドセンサーに対してのみ有効である。

アクセス関数

通知シグナル：

dataRate : int

このプロパティは、センサーが実行されるべきデータレートを保持する。

単位はヘルツ。

データレートはセンサーが変化を検出できる最大周波数である。

このプロパティの設定はポータブルではなく、他のアプリケーションとの競合を引き起こす可能性があります。データレートを要求する複数のアプリケーションに関するポリシーについては、センサーのバックエンドやプラットフォームのドキュメントを確認してください。

デフォルト値（0）は、アプリがデータレートを気にしないことを意味する。プラットフォームは毎秒数百回のアップデートを提供する可能性があるため、アプリケーションはタイマベースの現在値のポーリングを使用するか、値を処理するコードが非常に高速に実行できるようにすることを検討する必要があります。

この値は、start()を呼び出す前に設定されるべきである。なぜなら、センサーは実行中にこの値の変化に気づかない可能性があるからである。

プラットフォームが現在使用しているデータレートを決定するメカニズムはないことに注意。

アクセス関数

Notifier シグナル：

QSensor::availableDataRatesも参照のこと 。

[read-only] description : const QString

このプロパティは、センサーの説明文字列を保持する。

アクセス関数

[read-only] efficientBufferSize : const int

このプロパティは、最も効率的なバッファサイズを保持する。通常これは1である（特定のサイズが最も効率的でないことを意味する）。センサードライバーによっては、FIFOバッファを持ち、一度にFIFOサイズ分の読み取り値を配信する方が効率的なものもある。

アクセス機能：

ノーティファイア信号：

QSensor::bufferSize およびQSensor::maxBufferSizeも参照のこと 。

[read-only] error : const int

このプロパティは、センサーに設定された最後のエラーコードを保持する。

エラーコードはセンサー固有のものであることに注意。

アクセス関数

通知信号

identifier : QByteArray

このプロパティはセンサーのバックエンド識別子を保持する。

この識別子は、センサがバックエンドに接続されたときに自動的に入力されることに注意しましょう。特定のバックエンドに接続したい場合は、connectToBackend() の前に setIdentifier() を呼び出す必要があります。

アクセス関数

Notifier シグナル：

[read-only] maxBufferSize : const int

このプロパティは、最大バッファサイズを保持する。

この場合、センサーはバッファリングをサポートしません。その場合、isFeatureSupported(QSensor::Buffering) も false を返します。

アクセス関数

通知シグナル：

QSensor::bufferSize およびQSensor::efficientBufferSizeも参照のこと 。

outputRange : int

本プロパティは、センサーが使用する出力レンジを保持する。

この値は、使用するQSensor::outputRanges リストのインデックスを表す。

このプロパティの設定はポータブルではなく、他のアプリケーションとの競合を引き起こす可能性があります。出力範囲を要求する複数のアプリケーションに関するポリシーについては、センサーのバックエンドとプラットフォームのドキュメントを確認してください。

デフォルト値（-1）は、アプリが出力範囲を気にしないことを意味する。

プラットフォームが現在使用している出力範囲を決定するメカニズムはないことに注意。

アクセス関数：

QSensor::outputRangesも参照の こと。

[read-only] outputRanges : const qoutputrangelist

このプロパティは、センサーがサポートする出力レンジのリストを保持する。

センサは複数の出力レンジを持つことができる。通常、これは精度を下げる代償として、より広い測定範囲を与えるために行われる。

この情報は必須ではないことに注意。この情報は通常、選択可能な出力レンジを持つセンサー（一般的な加速度センサーなど）でのみ利用可能です。

アクセス関数：

QSensor::outputRange およびqoutputrangelistも参照してください 。

[read-only] reading : QSensorReading* const

このプロパティは、読み取りクラスを保持する。

読み取りクラスはセンサーの読み取り値へのアクセスを提供します。読み取り値オブジェクトは、受信した最新のセンサー読み取り値の揮発性キャッシュであるため、アプリケーションは読み取り値を即座に処理するか、後の処理のためにどこかに保存する必要があります。

センサーがバックエンドに接続されるまでは 0 を返すことに注意してください。

また、start()が呼び出された後、読み取り値はすぐには利用できないことに注意すること。アプリケーションはreadingChanged() シグナルが発せられるのを待つ必要がある。

アクセス関数

Notifier シグナル：

isConnectedToBackend() およびstart()も参照のこと 。

skipDuplicates : bool

重複する読み取り値を省略するかどうかを示す。

重複スキップが有効な場合、同一または非常に類似した値を持つ連続した読み取り値は省略されます。これにより、利用可能なセンサーの読み取り値が少なくなるため、処理量の削減に役立ちます。その結果、読み取り値は不規則な間隔で到着します。

重複スキップは、全く同じ読み取り値だけでなく、非常に類似した読み取り値に対しても有効である。

このプロパティのサポートはバックエンドに依存する。現在のプラットフォームでサポートされているかどうかを確認するには、isFeatureSupported() を使用してください。

重複スキップはデフォルトでは無効です。

重複スキップはセンサーが起動したときに有効になるため、センサーがアクティブな状態でプロパティを変更しても、即座に反映されることはありません。

アクセス関数

通知シグナル

[read-only] type : const QByteArray

本プロパティは、センサーのタイプを保持する。

アクセス関数

userOrientation : int

本プロパティは、UserOrientation モードにおいて、読取値の回転に使用する角度を保持する。

axesOrientationMode プロパティがUserOrientation に設定されている場合、読み取り値の回転に使用される角度はこのプロパティから取得される。その他のモードでは、このプロパティは何の効果もない。

デフォルトは0である。有効な値は0、90、180、270のみである。

このプロパティは、オリエンタブルセンサにのみ有効である。

アクセス関数：

通知シグナル：

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;