Mobile SDK Toast Messages¶
A toast provides simple feedback about an operation in a small popup at the bottom of the screen. It only fills the amount of space required for the message and is shown while the current activity remains visible and interactive. Toasts automatically disappear after a timeout, by tapping on it or if the reason for the toast is not valid anymore.
| “Walking improves accuracy” | “Wayfinding unavailable” | “Return to campus” |
|---|---|---|
| When SDK is not confident about the heading accuracy. It is dismissed by tapping on it or when heading accuracy becomes high. | When the user is more than 10 km away from the visible site. It is dismissed when the user gets less than 10 km closer to the visible site. | When the map is scrolled to a place outside of the site boundaries. It is dismissed when the user taps on it (which results in focusing to the last visible site), or scrolled back to a site. |
 |  |  |
| “Center my position” | “No bluetooth” | “Route Updated” |
|---|---|---|
| When the user is inside the site but is not within the visible viewport. It is dismissed when the user taps on it (which results in focusing on user location), or scrolled to a location where blue dot (user location) becomes visible on the screen. | When bluetooth service is disabled. It is dismissed when the device has bluetooth service enabled. This can be an indicator for failure to not have an indoor position or not being able to do wayfinding. | Within the scope of Pacman Wayfinding, this toast message is displayed when the user is rerouted. It is dismissed within a second automatically. |
 |  |  |
Tracking mode changes: Related toast messages are shown whenever there is a change in the tracking mode. These messages are dismissed automatically within a second.
| No tracking | Location Tracking | Location Tracking with Rotation |
|---|---|---|
 |  |  |
Content updates: They are shown when there is a version check followed by a content update. “Updating” (if content is already available), or “Preparing” (when content is fetched for the first time) toast messages are displayed during update operation. These toast messages are dismissed when the update is completed and “Up-to-date” toast message is displayed instead. “Up-to-date” toast message is dismissed automatically within a second.
| Preparing | Updating | Up-to-date |
|---|---|---|
 |  |  |
Toast messages can be enabled/disabled using PTRMapWidgetConfiguration.isToastMessagesEnabled flag.
Toast messages follows Listener/Handler architechture. For more details check the API Reference.