<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: 17.0.0 -",
    "macOS: 14.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "DockKit",
  "identifier" : "/documentation/DockKit/DockAccessory/setFramingMode(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "DockKit"
    ],
    "preciseIdentifier" : "s:7DockKit0A9AccessoryC14setFramingModeyyAC0eF0OYaKF"
  },
  "title" : "setFramingMode(_:)"
}
-->

# setFramingMode(_:)

Customize the dock accessory’s tracking behavior.

```
final func setFramingMode(_ mode: DockAccessory.FramingMode) async throws
```

## Parameters

`mode`

The framing mode to set tracking to. See [`DockAccessory.FramingMode`](/documentation/DockKit/DockAccessory/FramingMode-swift.enum) for more information.

## Discussion

Use this method to change where DockKit places a subject within the frame. For example, a face may be on the left or right side within the video. If you disable system tracking, this setting applies locally to the current dock accessory only. Otherwise, this setting applies to any active camera stream.

Set the frame mode to the desired value before performing your own custom tracking.

The default is [`DockAccessory.FramingMode.automatic`](/documentation/DockKit/DockAccessory/FramingMode-swift.enum/automatic). See [`DockAccessory.FramingMode`](/documentation/DockKit/DockAccessory/FramingMode-swift.enum) for other values you can use to override.

> Throws: ``doc://com.apple.DockKit/documentation/DockKit/DockKitError/notConnected`` if device isn’t connected, or ``doc://com.apple.DockKit/documentation/DockKit/DockKitError/notSupported`` in macOS.

---

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)