QGeoSatelliteInfoSource Class

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

멤버 함수 문서

[explicit] QGeoSatelliteInfoSource::QGeoSatelliteInfoSource(QObject *parent)

지정된 parent 를 가진 위성 소스를 생성합니다.

[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() 신호가 발신됩니다.

타임아웃이 0인 경우, 타임아웃은 소스에 적합한 합리적인 시간으로 기본 설정됩니다.

다른 업데이트 요청이 진행 중일 경우 이 메서드는 아무 작업도 수행하지 않습니다. 그러나 startUpdates()이 이미 호출되어 정기적인 업데이트가 진행 중일 때도 이 메서드를 호출할 수 있습니다.

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

startUpdates() 또는 requestUpdate()가 호출되면, 현재 사용 중인 위성 수에 대한 업데이트가 있을 때 이 신호가 발생합니다.

이 위성들은 "위치 결정(fix)"을 얻는 데 사용되는 위성, 즉 현재 위치를 파악하는 데 사용되는 위성들입니다.

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()

정기적인 간격으로 업데이트를 전송하지 않습니다.