An object that controls playback of one or more audio items.


@interface WKAudioFileQueuePlayer : WKAudioFilePlayer


Items are stored in a queue and played sequentially. When playback of the current item ends, playback of the next item begins automatically.

Because this class is a subclass of WKAudioFilePlayer, it inherits the same playback controls and state information as its superclass. You can use the inherited methods to start and stop playback or change the playback rate. You can also get information about the current status of the player, including the elapsed playback time for the currently playing item. This method also implements the inherited replaceCurrentItemWithPlayerItem: method and uses it to end playback of one item and start playback of another.


Creating a Queue Player

+ queuePlayerWithItems:

Creates and returns a player initialized with an array of items.

Managing Items


The array of queued items.

- advanceToNextItem

Ends playback of the current item and begins playing the next item in the queue.

- appendItem:

Adds the specified item to the end of the queue.

- removeItem:

Removes the specified item from the queue.

- removeAllItems

Removes all items from the queue.


Inherits From

See Also


Playing Background Audio

Enable background audio in your app to provide a seamless playback experience.

Adding a Now Playing View

Provide a view that controls the currently playing audio from your app.


An interface element that lets users control the audio volume from the watch or a paired iPhone.

property list key PUICAutoLaunchAudioOptOut

A Boolean value indicating whether a watchOS app should opt out of automatically launching when its companion iOS app starts playing audio content.

Name: Opt out of Auto-launch Audio App (Watch)

An object that controls playback of a single audio item.


An object that manages the presentation state of an audio file while it is being played.


An object that stores a reference to an audio file and provides metadata information about that file.