<!--
{
  "availability" : [
    "iOS: 15.0.0 -",
    "iPadOS: 15.0.0 -",
    "macCatalyst: 15.0.0 -",
    "macOS: 12.0.0 -",
    "tvOS: 17.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "PHASE",
  "identifier" : "/documentation/PHASE/PHASEConeDirectivityModelParameters",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "PHASE"
    ],
    "preciseIdentifier" : "c:objc(cs)PHASEConeDirectivityModelParameters"
  },
  "title" : "PHASEConeDirectivityModelParameters"
}
-->

# PHASEConeDirectivityModelParameters

An object that directs sound in a cone-shaped curve that extends from a sound source.

```
class PHASEConeDirectivityModelParameters
```

## Overview

This class determines that a particular frequency range in the audio spectrum emits sound in an area defined by a mathematical cone. PHASE refers to each frequency segment along the audio spectrum as a *subband*. This class contains an array of `subbands` that each direct sound in a unique cone shape. The framework outputs a blend of a frequency’s adjacent subbands for all frequencies that lie outside of those specified in the `subbands` array.

### Emit Sound in the Shape of a Cone

The following code defines a cone directivity model with two subbands. The first subband emits sound in a narrow region and the second subband outputs sound in a wider region.

```swift
let simpleCone = PHASEConeDirectivityModelParameters()

let coneSegment1 = PHASEConeDirectivityModelSubbandParameters()
coneSegment1.frequency = 500.0
coneSegment1.innerAngle = 60.0
coneSegment1.outerAngle = 80.0
coneSegment1.outerGain = 0.5

let coneSegment2 = PHASEConeDirectivityModelSubbandParameters()
coneSegment2.frequency = 5000.0
coneSegment2.innerAngle = 30.0
coneSegment2.outerAngle = 40.0
coneSegment2.outerGain = 0.3

simpleCone.subbands.add(coneSegment1)
simpleCone.subbands.add(coneSegment2)

spatialMixer.listenerDirectivityModelParameters = simpleCone
```

![An illustration of two different cone directivity configurations. On the left, a narrow cone contains a slightly narrower cone. A callout extends from the outer cone’s point that indicates its angle is 40 degrees. A callout extends from the inner cone’s point that indicates its angle is 30 degrees. On the right, a wide cone rests inside a slightly wider cone. A callout extends from the outer cone’s point that indicates its angle is 80 degrees. A callout extends from the inner cone’s point that indicates its angle is 60 degrees. In both configurations, a sphere rests on the cone’s point to indicate the user’s position in relation to the cone. ](images/com.apple.phase/media-3887365@2x.png)

## Topics

### Creating the Cone Directivity Model Parameters

[`-  initWithSubbandParameters:`](/documentation/PHASE/PHASEConeDirectivityModelParameters/init(subbandParameters:))

Creates an object that directs sound in a cone-shaped curve that extends from a sound source.

### Defining Subbands

[`subbandParameters`](/documentation/PHASE/PHASEConeDirectivityModelParameters/subbandParameters)

An array of frequencies that describe varying sound emission across the spectrum.

## Relationships

### Conforms To

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

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

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

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

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

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

### Inherits From

[`PHASEDirectivityModelParameters`](/documentation/PHASE/PHASEDirectivityModelParameters)

---

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)