NsdkScanningSession

A session for 3D scanning and visualization functionality....

Declaration

final class NsdkScanningSession

Summary

A session for 3D scanning and visualization functionality. The scanning feature provides capabilities for capturing, processing, and exporting 3D scan data from AR sessions. Scans of a location can be processed by the Visual Positioning System's (VPS's) cloud services to enable VPS localization.

Methods

Name	Type	Summary
computeVoxels	void	Compute the voxelization of the scanned scene. Processing is asynchronous. Call this function and then call `getVoxelBuffer()` to retrieve voxel data. - Precondition: Voxel visualization must have been enabled in the configuration.
configure	void	Configures the session with the specified settings. - Attention: This method must be called while the session is stopped, or else configuration will fail. In that case, while this function returns without throwing, configuration will still fail asynchronously. Use `featureStatus()` to check that configuration has not failed. - Parameter config: An object that defines this session's behavior. Only settings that differ from the defaults will be applied. - Throws: `NsdkError.invalidArgument` if the configuration is invalid. Check NSDK's C logs for more information.
exportArchive	String?	Exports the scan data as an archive file. This method processes the saved scan data and exports it to a standard archive format that can be used with external 3D processing tools or Niantic's VPS map. - Note: This function is blocking and may take a while to execute. See `NsdkRecordingExporter` for a non-blocking alternative. - Precondition: Argument `metadata` must be a valid JSON object string. - Parameter metadata: Metadata dictionary to include with the export. Can be left empty. - Parameter exportAsVideo: If true, the RGB frames in the scan will be exported as an .mp4 video. If false, they will be individual image files. - Returns: The path of the archive file, if the export was successful, `nil` if otherwise. Export failure indicates something was wrong with the saved scan. - Throws: - `NsdkError.invalidOperation` if the scanning session did not have a saved scan to export.
exportSplitArchive	[String]?	Exports the scan data as multiple archive files. This method processes the saved scan data and exports it to multiple archive files based on the maxFramesPerArchive parameter. Each archive will contain at most maxFramesPerArchive frames. - Note: This function is blocking and may take a while to execute. - Precondition: Argument `metadata` must be a valid JSON object string. - Parameter metadata: Metadata dictionary to include with the export. Can be left empty. - Parameter maxFramesPerArchive: Maximum number of frames per archive file. - Parameter exportAsVideo: If true, the RGB frames in the scan will be exported as an .mp4 video. If false, they will be individual image files. - Returns: An array of paths to the archive files, if the export was successful, `nil` if otherwise. Export failure indicates something was wrong with the saved scan. - Throws: - `NsdkError.invalidOperation` if the scanning session did not have a saved scan to export.
featureStatus	NsdkFeatureStatus	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. - Returns: Feature status flags for any issues that have occurred
raycastBuffer	RaycastBuffer?	Get the most recently computed raycast buffers. Once the session has been started and all the requested data has been sent through the NsdkSession, a buffer should become available after a brief computation period. - Precondition: Raycast visualization must have been enabled in the configuration. - Returns: The most recently computed raycast buffers if available, nil if not.
recordingInfo	NsdkScanningSession.RecordingInfo	Returns information about the current recording. Call this method before `saveCurrentScan()` to ensure that the recording contains frames to save. Otherwise, the save operation may fail. - Returns: A `RecordingInfo` object containing details about the current recording. - Throws: An error if the underlying NSDK call fails. - Note: Make sure to call this method before `saveCurrentScan()` if you plan to save the current scan; otherwise, the save may fail.
saveCurrentScan	NsdkScanningSession.SaveInfo	Stops recording and asynchronously saves the recording to the configured path. Calling this function will stop the active recording, but `stop` must still be called afterward to completely shut down this session. - Parameters: - timeout: The maximum duration in seconds to wait for the save operation (default is 10 seconds). - pollingInterval: The interval in seconds to wait between progress checks (default is 0.1 seconds) - Returns: Information about the saved scan, including it's id and file location. - Throws: - `CancellationError` if the Task running this function was cancelled. - `TimeoutError` if the function timed out before it could complete execution. - `NsdkScanningSession.SaveError` if there was an error specific to the save operation. - SeeAlso: - `stop` - `configure(with:)`
start	void	Starts scanning. "Scanning" here may include up to three processes — recording input AR data, raycasting, and voxelization — depending on how the feature is configured. Raycasting and voxelization are useful for visualizing scanned areas and providing feedback to the user about their scan. - SeeAlso: `stop()` - SeeAlso: `configure(_:)`
stop	void	Stops scanning and discards any unsaved scan data. Halts any active scanning while keeping the scanner instance alive. You can restart scanning later by calling `start()`. - SeeAlso: `start()`
voxelBuffer	VoxelBuffer?	Get the most recently computed voxel data. Once the session has been started and all the requested data has been sent through the NsdkSession, a new buffer should become available after a brief computation period after `computeVoxels()` has been called. - Precondition: Voxel visualization must have been enabled in the configuration. - Returns: The most recently computed voxel data if available, nil if not.

Nested Types

Structs

Name	Type	Summary
Configuration	Configuration	Configuration structure for the scanning session.
RecordingInfo	RecordingInfo	Information about the recording generated during scanning.
SaveInfo	SaveInfo	Information about a save operation for a scan.

Enums

Name	Type	Summary
SaveError	SaveError	Errors that can occur during a save operation.

Relationships

conforms to: NsdkFeatureSession

Class NsdkScanningSession NsdkScanningSession

Declaration​

Summary​

Methods​

Nested Types​

Structs​

Enums​

Relationships​