---
title: "coordinateRateChange(to:options:)"
framework: avfoundation
role: symbol
role_heading: Instance Method
path: "avfoundation/avdelegatingplaybackcoordinator/coordinateratechange(to:options:)"
---

# coordinateRateChange(to:options:)

Coordinates a rate change across all participants, waiting for others to become ready, if necessary.

## Declaration

```swift
func coordinateRateChange(to rate: Float, options: AVDelegatingPlaybackCoordinatorRateChangeOptions = [])
```

## Parameters

- `rate`: The playback rate for the group to use.
- `options`: Additional configuration of the rate change.

## Discussion

Discussion When the rate changes from zero to nonzero, the coordinator may also wait for participant suspensions from the suspensionReasonsThatTriggerWaiting property. Don’t call this method if the rate change doesn’t affect the group, or if the group doesn’t have control over local playback temporarily. For example, don’t call the method for a pause that occurs due to an audio session interruption. In those cases, inform the coordinator by beginning a suspension with an appropriate reason. The suspension stops the coordinator from issuing further commands to its delegate. After beginning a suspension, you can reconfigure your app’s playback object as necessary. note: Calling this method while the coordinator is in a suspended state affects only the local playback object. It doesn’t affect group state, even after the suspension ends.

## See Also

### Coordinating state changes

- [coordinateSeek(to:options:)](avfoundation/avdelegatingplaybackcoordinator/coordinateseek(to:options:).md)
- [transitionToItem(withIdentifier:proposingInitialTimingBasedOn:)](avfoundation/avdelegatingplaybackcoordinator/transitiontoitem(withidentifier:proposinginitialtimingbasedon:).md)
- [reapplyCurrentItemStateToPlaybackControlDelegate()](avfoundation/avdelegatingplaybackcoordinator/reapplycurrentitemstatetoplaybackcontroldelegate().md)
- [AVDelegatingPlaybackCoordinatorSeekOptions](avfoundation/avdelegatingplaybackcoordinatorseekoptions.md)
- [AVDelegatingPlaybackCoordinatorRateChangeOptions](avfoundation/avdelegatingplaybackcoordinatorratechangeoptions.md)
