SatelliteSource QML Type

SatelliteSourceクラスは、衛星情報を提供します。詳細...

• 継承メンバを含む全メンバ一覧

プロパティ

• active : bool
• name : string
• parameters : list<PluginParameter>
• satellitesInUse : list<geoSatelliteInfo>
• satellitesInView : list<geoSatelliteInfo>
• sourceError : enumeration
• updateInterval : int
• valid : bool

方法

• var backendProperty(string name)
• bool setBackendProperty(string name, var value)
• void start()
• void stop()
• void update(int timeout)

詳細説明

SatelliteSourceクラスは、使用中の衛星や表示中の衛星に関する情報を提供する。このクラスはQGeoSatelliteInfoSource をQMLで表現したものです。

C++の同等クラスと同様に、このクラスは様々なプラグインをサポートしています。name プロパティを使用して、使用するプラグインの名前を指定し、必要に応じてPluginParameterを指定します。name プロパティが設定されていない場合は、デフォルトのプラグインが使用されます。使用可能なプラグインの詳細については、Qt Positioning プラグインを参照してください。

SatelliteSource の状態を確認するには、valid プロパティを使用します。

updateInterval プロパティを使用して、アプリケーションが衛星情報の更新を受信する頻度を指定します。start （）、stop （）、update （）メソッドを使用して、SatelliteSourceの動作を制御することができます。また、active プロパティを設定すると、start （）またはstop （）を呼び出すことと同じになります。

SatelliteSource がアクティブな場合、satellitesInView およびsatellitesInUse プロパティを使用して、衛星情報の更新を取得できます。

衛星情報の更新中にエラーが発生した場合は、sourceError プロパティを使用して、実際のエラー・コードを取得します。

使用例

次の例は、NMEAプラグインを使用して、衛星情報の更新を毎秒受信し、表示中の衛星数と使用中の衛星数をコンソールに出力する SatelliteSource を示しています。

SatelliteSource {
    id: source
    name: "nmea"
    active: true
    updateInterval: 1000
    PluginParameter { name: "nmea.source"; value: "serial:/dev/ttyACM0" }

    onSatellitesInUseChanged: {
        console.log("Satellites in use:", source.satellitesInUse.length)
    }
    onSatellitesInViewChanged: {
        console.log("Satellites in view:", source.satellitesInView.length)
    }
}

QGeoSatelliteInfoSource 、PluginParameter 、geoSatelliteInfoも参照して ください。

プロパティ・ドキュメント

active : bool

このプロパティは、衛星ソースがアクティブであるかどうかを示す。このプロパティをfalse に設定すると、stop を呼び出すことと同じになり、このプロパティをtrue に設定すると、start を呼び出すことと同じになる。

start 、stop 、updateも参照 。

name : string

このプロパティは、現在衛星情報を提供しているプラグインの固有の内部名を保持する。

このプロパティを設定すると、SatelliteSource が特定のバックエンド・プラグインを使用するようになります。name プロパティが変更された時点でSatelliteSource がアクティブな場合、それは非アクティブになります。指定したバックエンドをロードできない場合、衛星ソースは無効になります。

name プロパティを変更すると、updateInterval プロパティも変更されることがある。

parameters : list<PluginParameter> [default read-only]

このプロパティは、プラグインパラメータのリストを保持します。

PluginParameterも参照してください 。

satellitesInUse : list<geoSatelliteInfo> [read-only]

このプロパティは、現在使用中の衛星のリストを保持する。これらは「フィックス」を取得するために使用される衛星、つまり現在位置を決定するために使用される衛星です。

satellitesInView : list<geoSatelliteInfo> [read-only]

このプロパティは、現在見えている衛星のリストを保持する。

sourceError : enumeration [read-only]

このプロパティは、バックエンドデータプロバイダで最後に発生したエラーを保持します。

updateInterval : int

このプロパティは、希望する更新間隔をミリ秒単位で保持する。

valid : bool [read-only]

このプロパティは、SatelliteSource オブジェクトがデータを提供する有効なバックエンドプラグインを取得している場合はtrue となり、そうでない場合はfalse となる。

アプリケーションは、このプロパティをチェックして、衛星情報の提供がランタイムプラットフォーム上で利用可能かどうかを判断し、それに応じて対応する必要がある。

メソッド・ドキュメント

var backendProperty(string name)

name というバックエンド固有のプロパティが存在する場合、その値を返す。そうでない場合は、初期化されていないSatelliteSource で呼び出された場合も含めて、返り値は無効です。

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

bool setBackendProperty(string name, var value)

name というバックエンド固有のプロパティをvalue に設定します。成功した場合は true を返し、そうでない場合は false を返します（初期化されていないSatelliteSource で呼び出された場合を含む）。

backendProperty()も参照 。

void start()

衛星ソースからの更新を要求する。設定されている場合はupdateInterval を使用し、設定されていない場合はデフォルトの間隔を使用する。利用可能なソースがない場合、このメソッドは機能しません。

stop()、update() およびactiveも参照 。

void stop()

サテライト・ソースからの更新を停止する。利用可能なソースがない場合、またはソースがアクティブでない場合、このメソッドは動作しない。

start()、update() およびactiveも参照 。

void update(int timeout = 0)

衛星ソースに単一の更新を要求する便利なメソッド。利用可能なソースがない場合、このメソッドは何の効果もない。

サテライト・ソースがアクティブでない場合は、更新を受信するまでの間、または要求がタイムアウトするまでアクティブになります。リクエストのタイムアウト時間はプラグイン固有です。

timeout はミリ秒単位で指定する。timeout がゼロ (デフォルト値) の場合、ソースに適したタイムアウト時間がデフォルトになります。

start()、stop()、activeも参照 。