<!--
{
  "availability" : [
    "iOS: -",
    "iPadOS: -",
    "macCatalyst: -",
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ImmersiveMediaSupport",
  "identifier" : "/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Immersive Media Support"
    ],
    "preciseIdentifier" : "s:21ImmersiveMediaSupport0aB21RemotePreviewReceiverC"
  },
  "title" : "ImmersiveMediaRemotePreviewReceiver"
}
-->

# ImmersiveMediaRemotePreviewReceiver

An observable object that helps applications handle receiving commands and data sent from an immersive media remote preview sender object.

```
class ImmersiveMediaRemotePreviewReceiver
```

## Overview

This object helps applications receiving Immersive Video over the network with the intent of rendering a preview playback.

To properly render an immersive video preview, the receiver also needs access to:

- The current [`ImmersiveVideoFrame`](/documentation/ImmersiveMediaSupport/ImmersiveVideoFrame) to render.
- The current [`VenueDescriptor`](/documentation/ImmersiveMediaSupport/VenueDescriptor) for rendering.
- The current [`PresentationDescriptor`](/documentation/ImmersiveMediaSupport/PresentationDescriptor) that describes one or more [`PresentationCommand`](/documentation/ImmersiveMediaSupport/PresentationCommand)instances active for the current frame.

## Topics

### Initializers

[`init() async throws`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/init())

Creates a preview receiver object.

### Instance Properties

[`var frame: ImmersiveVideoFrame?`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/frame)

The current remote preview of an immersive video frame.

[`var presentationDescriptor: PresentationDescriptor?`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/presentationDescriptor)

The current remote immersive video presentation descriptor.

[`var states: some AsyncSequence<ImmersiveMediaRemotePreviewReceiver.Status, Never>`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/states)

The states to use for monitoring the current state of the preview receiver so the app can monitor events.

[`var venueDescriptor: VenueDescriptor?`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/venueDescriptor)

The current remote immersive video venue descriptor.

### Instance Methods

[`func start(connection: NWConnection) async throws`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/start(connection:))

Performs the necessary steps to start receiving remote Immersive video frames using the given network connection.

[`func stop()`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/stop())

Stops receiving remote immersive video frames.

### Enumerations

[`enum Status`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver/Status)

A value that represents the status of the immersive media remote preview receiver object.

## Relationships

### Conforms To

[`Escapable`](/documentation/Swift/Escapable)

[`SendableMetatype`](/documentation/Swift/SendableMetatype)

[`Copyable`](/documentation/Swift/Copyable)

[`Sendable`](/documentation/Swift/Sendable)

[`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)