---
title: "setIntendedSpatialExperience:options:error:"
framework: AVFAudio
role: symbol
role_heading: Instance Method
platforms: [visionOS 1.0+]
path: "avfaudio/avaudiosession/setintendedspatialexperience:options:error:"
---

# setIntendedSpatialExperience:options:error:

Sets the spatial audio experience your app intends to provide the user.

## Declaration

```occ
- (BOOL) setIntendedSpatialExperience:(AVAudioSessionSpatialExperience) intendedSpatialExperience options:(NSDictionary<NSString *,id> *) options error:(NSError **) error;
```

## Parameters

- `intendedSpatialExperience`: The spatial audio experience to set.
- `options`: A dictionary of options that customize the experience.
- `error`: If an error occurs, an object that provides the details of the error.

## Topics

### Spatial experience options

- [AVAudioSessionSpatialExperienceOptionAnchoringStrategy](avfaudio/avaudiosessionspatialexperienceoptionanchoringstrategy.md)
- [AVAudioSessionSpatialExperienceOptionSceneIdentifier](avfaudio/avaudiosessionspatialexperienceoptionsceneidentifier.md)
- [AVAudioSessionSpatialExperienceOptionSoundStageSize](avfaudio/avaudiosessionspatialexperienceoptionsoundstagesize.md)
- [AVAudioSessionSpatialExperienceOption](avfaudio/avaudiosessionspatialexperienceoption.md)

## See Also

### Configuring the spatial experience

- [intendedSpatialExperience](avfaudio/avaudiosession/intendedspatialexperience-qlty.md)
- [AVAudioSessionSpatialExperience](avfaudio/avaudiosessionspatialexperience-c.enum.md)
- [AVAudioSession.SoundStageSize](avfaudio/avaudiosession/soundstagesize.md)
- [intendedSpatialExperienceOptions](avfaudio/avaudiosession/intendedspatialexperienceoptions.md)
- [AVAudioSessionSpatialExperienceOption](avfaudio/avaudiosessionspatialexperienceoption.md)
- [isNowPlayingCandidate](avfaudio/avaudiosession/isnowplayingcandidate.md)
- [setIsNowPlayingCandidate(_:)](avfaudio/avaudiosession/setisnowplayingcandidate(_:).md)