Name: headingChanged

Type: message

Syntax: headingChanged <pHeading>

Summary:

Sent to the current card of the defaultStack when the heading of the

device changes.

Introduced: 4.6.1

OS: ios, android

Platforms: mobile

Example:

on headingChanged theHeading

updateMapPosition theHeading

-- update the marker on the map showing the current heading

end headingChanged

Parameters:

pHeading:

The heading of the device, in degrees relative to true north if

available, otherwise relative to magnetic north

Description:

Handle the <headingChanged> message if you want to perform tasks when

the heading of the device changes.

The <headingChanged> message is sent to the current card of the

defaultStack when the heading of the device changes.

If heading tracking cannot be started (typically due to a lack of

calibration) then a <trackingError> message is sent instead.

References: iphoneSetHeadingCalibrationTimeout (command),

mobileCanTrackHeading (function), mobileCanTrackLocation (function),

mobileCurrentHeading (function),

iphoneHeadingCalibrationTimeout (function), trackingError (message)