<!--
{
  "availability" : [
    "visionOS: 27.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVKit",
  "identifier" : "/documentation/AVKit/AVPortalViewport/aspectRatio-3jqur",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "AVKit"
    ],
    "preciseIdentifier" : "c:objc(cs)AVPortalViewport(py)aspectRatio"
  },
  "title" : "aspectRatio"
}
-->

# aspectRatio

The aspect ratio of the portal frame.

```
@property (nonatomic, strong, nullable) NSNumber * aspectRatio;
```

## Discussion

This value determines the width-to-height ratio of the portal frame.
Common aspect ratios include:

- 1.78 (16:9) for standard widescreen content
- 2.35 or 2.39 for cinematic widescreen content
- 1.33 (4:3) for traditional content

When nil, the system defaults to a 16:9 (1.78) aspect ratio.

> Important: The system may adjust values outside typical ranges to ensure a comfortable viewing experience.

---

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)