Troubleshooting

Some Apple Immersive Video (.aivu) files may lag during playback at an exhibition, depending on the M-series processor in the device. In this case, Apple suggests using a bitrate of 150 Mb/s.

If your Apple Vision Pro is paired to the correct account and both apps are open but the headset still shows as offline, the Wi-Fi network is the most likely cause.

Pairing and account status travel over the internet, while the app finds your Apple Vision Pro on the local network. A firewall can block that local traffic and leave the internet connection untouched. The headset stays paired, but the app never sees it.

Quick test:

1. Start a personal hotspot on a phone.
2. Connect the Apple Vision Pro and your Mac, iPhone, or iPad to that hotspot.
3. Open both apps and check whether the headset appears.

If it appears on the hotspot, a firewall on your usual Wi-Fi network is blocking the connection. Ask whoever manages that network to allow local network communication between devices.

If your Apple Vision Pro isn't being recognised, check two things - one on your Mac, iPhone, or iPad, and the other on the Apple Vision Pro.

On Mac:

1. Open System Settings.
2. Go to Privacy & Security.
3. Select Local Network.
4. Check that the toggle for “Spatial Companion” is on.

On Apple Vision Pro:

1. Open Settings.
2. Go to Apps.
3. Select Spatial Companion.
4. Check that the toggle for “Local Network” is on.

If the issue persists, try logging out and back in.