---
title: farFieldInput
framework: avfaudio
role: symbol
role_heading: Type Property
path: avfaudio/avaudiosession/categoryoptions-swift.struct/farfieldinput
---

# farFieldInput

This option should be used if a session prefers to use FarFieldInput when available. This option is only valid with categories that support input - playAndRecord, record, and AVAudioSessionMultiRoute with dualRoute.

## Declaration

```swift
static var farFieldInput: AVAudioSession.CategoryOptions { get }
```

## Discussion

Discussion This option requires AVAudioSessionCategoryOptionAllowBluetoothHFP to be set. Otherwise error will be returned. Support for this can be queried on input ports via the BluetoothMicrophone interface on a port, via its member farFieldCapture.isSupported. Active sessions can see if far-field input is enabled on a bluetooth audio device by querying the BluetoothMicrophone interface of the input port of the current route for: farFieldCapture.isEnabled.

## See Also

### Inspecting the category configuration

- [category](avfaudio/avaudiosession/category-swift.property.md)
- [availableCategories](avfaudio/avaudiosession/availablecategories.md)
- [AVAudioSession.Category](avfaudio/avaudiosession/category-swift.struct.md)
- [categoryOptions](avfaudio/avaudiosession/categoryoptions-swift.property.md)
- [AVAudioSession.CategoryOptions](avfaudio/avaudiosession/categoryoptions-swift.struct.md)