<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "RealityKit",
  "identifier" : "/documentation/RealityKit/VideoPlayerComponent/desiredSpatialVideoMode",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "RealityKit"
    ],
    "preciseIdentifier" : "s:17RealityFoundation20VideoPlayerComponentV014desiredSpatialC4ModeAC0gcH0Ovp"
  },
  "title" : "desiredSpatialVideoMode"
}
-->

# desiredSpatialVideoMode

The viewer’s selected spatial video rendering mode.

```
var desiredSpatialVideoMode: VideoPlayerComponent.SpatialVideoMode { get set }
```

## Discussion

This is the desired spatial video rendering mode that will be attempted if the content is able to support the requested mode. If the content is not spatial video then the rendering of the video will default back to screen.

---

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)