Instance Property

rate

The audio player’s playback rate.

Declaration

@property float rate;

Discussion

This property’s default value of 1.0 provides normal playback rate. The available range is from 0.5 for half-speed playback through 2.0 for double-speed playback.

To set an audio player’s playback rate, you must first enable rate adjustment as described in the enableRate property description.

See Also

Configuring and Controlling Playback

- play

Plays a sound asynchronously.

- playAtTime:

Plays a sound asynchronously, starting at a specified point in the audio output device’s timeline.

- pause

Pauses playback; sound remains ready to resume playback from where it left off.

- stop

Stops playback and undoes the setup needed for playback.

- prepareToPlay

Prepares the audio player for playback by preloading its buffers.

- setVolume:fadeDuration:

Fades to a new volume over a specific duration.

playing

A Boolean value that indicates whether the audio player is playing (YES) or not (NO).

volume

The playback volume for the audio player, ranging from 0.0 through 1.0 on a linear scale.

pan

The audio player’s stereo pan position.

enableRate

A Boolean value that specifies whether playback rate adjustment is enabled for an audio player.

numberOfLoops

The number of times a sound will return to the beginning, upon reaching the end, to repeat playback.

delegate

The delegate object for the audio player.

AVAudioPlayerDelegate

A protocol that allows a delegate to respond to audio interruptions and audio decoding errors, and to the completion of a sound’s playback.

settings

The audio player’s settings dictionary, containing information about the sound associated with the player.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software