Skip to main content
API Reference com.nianticspatial.nsdk.mapping

DeviceMappingSession

↳ extends SessionBase
A session for locally creating VPS maps from AR data. The device mapping feature provides capabilities for locally building persistent maps that can be used for Visual Positioning System (VPS) localization. These maps capture the visual features and spatial structure of an environment.

Declaration

class DeviceMappingSession

Properties

NameTypeSummary
ardkHandleLong
-

Functions

NameTypeSummary
configurevoid
Configure the session with the specified settings. > Note: It is only valid to call this when the session is stopped. > Note: Configuration is asynchronous and can fail later, even if this call does not throw an error. Use [featureStatus()] to check there are no issues.
featureStatusFeatureStatus
Reports errors that have occurred within processes running inside this feature. Check this periodically to see if any errors have occurred with processes running inside this feature. Once an error has been flagged, it will remain flagged until the culprit process has been run again and completed successfully.
onDestroyvoid
-
onInitvoid
-
startvoid
Start the mapping session. This starts some underlying processes that need to be running before actual mapping can begin, downloading the model containing the mapping algorithm. It does not actually start the map building process, which needs to be invoked separately with [startCreating].
startCreatingvoid
Begin a mapping sequence. This begins building an on-device map that can be used for VPS.
stopvoid
Stop all mapping processes. This halts active mapping while keeping the mapping instance alive. You can restart mapping later with [start].
stopCreatingvoid
Stop the current mapping sequence. This stops adding new frames to the current on-device VPS Map.