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 Plugins를 참조하십시오.

valid 속성을 사용하여 SatelliteSource 상태를 확인하십시오.

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 가 0(기본값)인 경우, 소스에 적합한 합리적인 타임아웃 기간으로 기본 설정됩니다.

start(), stop(), active도 참조하십시오 .