Managers¶
In our SDKs we have objects called “Managers” available
As the SDKs started packing in more functionality, we have decided to divide it into smaller dedicated and independent components (Managers). For example, PoiManager
packs all POI related functionality, including listing all POIs and performing a POI search. PathManager
, on the other hand, packs all pathfinding related functionality.
There are a couple of important design considerations behind Managers.
- All Managers are accessed via the top class (eg.
Pointr.shared.poiManager
) - Managers are only accessible once the SDK has started. If you try to access a manager before starting the SDK, you will get a
null
object, exceptPermissionManager
that is always accessible. - Several Managers support callbacks of some kind, including the existance of Delegates for iOS versions of the SDK.
Important Managers¶
This is the list of managers that are particularly important, being either required to use the SDK, or required to use the most popular features.
Other Managers¶
These are less commonly used managers.
Managers Descriptions¶
AppStateManager¶
This manager is used to track the application state (for example if it is running or on background).
ConfigurationManager¶
This manager purpose is get or update the configuration of Pointr SDK and its components.
DataManager¶
The DataManager is essential for the SDK since it is used to load all kinds of data, like sites, geofences, etc. This manager allows you to check if the data has been downloaded, reload data, check downloads in progress, etc.
Note
You can also use other managers to check if the content they manage is ready to be used.
GeofenceManager¶
With this manager is possible to know if a device entered or left a Geofenced area, assuming location capabilities are enabled.
ObstacleManager¶
This manager use is mostly listing the obstacles (like walls) that exist in a site.
PathManager¶
This manager handles all path-finding related features, like start a path session (path session gives you live updates on the path) between user’s location and another location, calculate static paths, distances, etc.
PermissionManager¶
The Permission Manager was added in Pointr 7.0, its main purpose is the handling of permissions settings from the operating system, for example knowing if the user allowed or not the use of Bluetooth, Camera, etc. It also allows the requesting of such permissions to the user.
PoiManager¶
Point of Interests Manager main purpose is allow the listing of Points of Interests, searching them, checking if POI data is loaded for a specific site and other tasks.
PositionManager¶
This manager purpose is to provide updates related to the user’s location, like the current position, position states and level change.
GraphManager¶
This manager is related to the node graph on a building.
Warning
Although this manager is related to graph, if you need Path Finding, use PathManager.
SiteManager¶
This manager provides the list of all available sites and basic information about the buildings and levels, like title, internal and external identifiers, geo location, etc.
UserManager¶
The User Manager is not particularly important, there is no need to use it for most cases. Its major utility is allowing the applicaiton to save locally the language preference of the logged in user, so the interface can display its contents in the correct language.