QSensor Class

プロパティの説明

active : bool

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

センサーがアクティブ（値を返す）であれば true。そうでない場合は 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) も偽を返す。

アクセス関数

通知シグナル：

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;