QGeoSatelliteInfoSource Class

// Emit updates every 10 seconds if available
QGeoSatelliteInfoSource *source = QGeoSatelliteInfoSource::createDefaultSource(0);
if (source)
    source->setUpdateInterval(10000);

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

[virtual noexcept] QGeoSatelliteInfoSource::~QGeoSatelliteInfoSource()

衛星ソースを破壊する。

[static] QStringList QGeoSatelliteInfoSource::availableSources()

利用可能なソースプラグインのリストを返します。利用可能な場合は、デフォルトのシステムバックエンドも含みます。

[virtual, since 6.2] QVariant QGeoSatelliteInfoSource::backendProperty(const QString &name) const

name というバックエンド固有のプロパティの値を返します。そうでない場合、返される値は無効です。

この関数は Qt 6.2 で導入されました。

setBackendPropertyも参照してください 。

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(QObject *parent)

システムのデフォルトの衛星更新情報ソース、または最も優先順位の高い利用可能なプラグインから読み込む、 指定されたparent を持つソースを作成して返します。

システムにデフォルトの衛星ソースがない場合、有効なプラグインが見つからない場合、またはユーザが衛星データにアクセスする権限を持っていない場合は、nullptr 。

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createDefaultSource(const QVariantMap &parameters, QObject *parent)

システムのデフォルトの衛星データ・ソース、または利用可能な優先順位が最も高いプラグインから読み込む、指定されたparent を持つ衛星ソースを作成して返す。

システムにデフォルトの衛星ソースがない場合、有効なプラグインが見つからない場合、またはユーザが衛星情報にアクセスする権限を持っていない場合は、nullptr を返します。

このメソッドは、parameters をファクトリーに渡し、ソースを設定します。

この関数は Qt 5.14 で導入されました。

[static] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, QObject *parent)

sourceName という名前のプラグインをロードすることで、指定されたparent を持つソースを作成して返します。

プラグインが見つからない場合はnullptr を返します。

[static, since Qt 5.14] QGeoSatelliteInfoSource *QGeoSatelliteInfoSource::createSource(const QString &sourceName, const QVariantMap &parameters, QObject *parent)

sourceName という名前のプラグインをロードすることにより、指定されたparent を持つ衛星ソースを作成し、返します。

プラグインが見つからない場合は、nullptr を返します。

このメソッドは、parameters をファクトリに渡し、ソースを構成します。

この関数は Qt 5.14 で導入されました。

[pure virtual] QGeoSatelliteInfoSource::Error QGeoSatelliteInfoSource::error() const

最後に発生したエラーを返します。

[signal] void QGeoSatelliteInfoSource::errorOccurred(QGeoSatelliteInfoSource::Error satelliteError)

このシグナルはエラーが発生した後に発せられる。satelliteError パラメーターには、発生したエラーのタイプが記述される。

[pure virtual slot] void QGeoSatelliteInfoSource::requestUpdate(int timeout = 0)

現在の衛星情報を取得し、その情報を用いてsatellitesInViewUpdated() およびsatellitesInUseUpdated() を送出する。与えられたtimeout （ミリ秒単位）以内に現在の衛星情報が見つからなかった場合、またはtimeout がminimumUpdateInterval() によって返された値より小さい場合、UpdateTimeoutError を持つerrorOccurred() シグナルが発行される。

タイムアウトがゼロの場合、タイムアウトのデフォルトは、ソースに適した妥当なタイムアウト時間になります。

別の更新要求が進行中の場合、これは何もしない。ただし、startUpdates() がすでに呼び出されていて、通常の更新が進行中であっても呼び出すことができます。

[signal] void QGeoSatelliteInfoSource::satellitesInUseUpdated(const QList<QGeoSatelliteInfo> &satellites)

startUpdates() またはrequestUpdate() が呼び出された場合、このシグナルは、現在使用中の衛星の数が更新 されたときに発せられる。

これらの衛星は、"フィックス"、つまり現在位置を決定するために使用される衛星である。

satellites パラメータには、現在使用中の衛星が格納される。

[signal] void QGeoSatelliteInfoSource::satellitesInViewUpdated(const QList<QGeoSatelliteInfo> &satellites)

startUpdates()またはrequestUpdate()が呼び出された場合、 このシグナルは、現在表示中の衛星について更新があったときに発せられる。

satellites パラメータには、現在表示中の衛星が格納される。

[virtual, since 6.2] bool QGeoSatelliteInfoSource::setBackendProperty(const QString &name, const QVariant &value)

name というバックエンド固有のプロパティをvalue に設定します。成功した場合はtrue を返し、失敗した場合はfalse を返す。バックエンド固有のプロパティを使用すると、実行時にサテライト情報サブシステムの動作を設定できます。

この関数は Qt 6.2 で導入されました。

backendPropertyも参照してください 。

QString QGeoSatelliteInfoSource::sourceName() const

使用中のサテライト・ソース実装の一意の名前を返します。

これは、特定のサテライト・ソース実装の新しいインスタンスを作成するためにcreateSource() に渡すことができる名前と同じです。

[pure virtual slot] void QGeoSatelliteInfoSource::startUpdates()

一定間隔で更新情報を発信開始。更新は、新しい衛星情報が利用可能になるたびに行われる。

衛星情報が取得できなかったり、何らかのタイムアウトが発生した場合、satellitesInViewUpdated() とsatellitesInUseUpdated() シグナルが空のパラメータリストで発行されることがあります。

satellitesInViewUpdated() およびsatellitesInUseUpdated()も参照して ください。

[pure virtual slot] void QGeoSatelliteInfoSource::stopUpdates()

定期的な更新を停止する。