<!--
{
  "availability" : [
    "macOS: 27.0.0 -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "SpatialPreview",
  "identifier" : "/documentation/SpatialPreview/SpatialPreviewSession",
  "metadataVersion" : "0.1.0",
  "role" : "Protocol",
  "symbol" : {
    "kind" : "Protocol",
    "modules" : [
      "Spatial Preview"
    ],
    "preciseIdentifier" : "s:14SpatialPreview0aB7SessionP"
  },
  "title" : "SpatialPreviewSession"
}
-->

# SpatialPreviewSession

A session that manages the lifecycle and connection state of a spatial preview on a visionOS device.

```
protocol SpatialPreviewSession : AnyObject, Observable
```

## Topics

### Instance Properties

[`var progress: ProgressReporter`](/documentation/SpatialPreview/SpatialPreviewSession/progress)

Reports the progress of the session

[`var state: SpatialPreviewSessionState`](/documentation/SpatialPreview/SpatialPreviewSession/state)

Can observe this state

### Instance Methods

[`func close() async throws`](/documentation/SpatialPreview/SpatialPreviewSession/close())

Gracefully close the session

## Relationships

### Conforming Types

[`USDPreviewSession`](/documentation/SpatialPreview/USDPreviewSession)

[`DocumentPreviewSession`](/documentation/SpatialPreview/DocumentPreviewSession)

### Inherits From

[`Observable`](/documentation/Observation/Observable)

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)