The number of times a sound will return to the beginning, upon reaching the end, to repeat playback.
- iOS 2.2+
- macOS 10.7+
- Mac Catalyst 13.0+Beta
- tvOS 9.0+
- watchOS 3.2+
A value of
0, which is the default, means to play the sound once. Set a positive integer value to specify the number of times to return to the start and play again. For example, specifying a value of
1 results in a total of two plays of the sound. Set any negative integer value to loop the sound indefinitely until you call the
Configuring and Controlling Playback
Plays a sound asynchronously.
Plays a sound asynchronously, starting at a specified point in the audio output device’s timeline.
Pauses playback; sound remains ready to resume playback from where it left off.
Stops playback and undoes the setup needed for playback.
Prepares the audio player for playback by preloading its buffers.
A Boolean value that indicates whether the audio player is playing (
YES) or not (
The playback volume for the audio player, ranging from
1.0 on a linear scale.
The audio player’s stereo pan position.
The audio player’s playback rate.
A Boolean value that specifies whether playback rate adjustment is enabled for an audio player.
The delegate object for the audio player.
A protocol that allows a delegate to respond to audio interruptions and audio decoding errors, and to the completion of a sound’s playback.
The audio player’s settings dictionary, containing information about the sound associated with the player.
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