<!--
{
  "availability" : [
    "watchOS: 2.0.0 - 6.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "WatchKit",
  "identifier" : "/documentation/WatchKit/WKAudioFileQueuePlayer",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "WatchKit"
    ],
    "preciseIdentifier" : "c:objc(cs)WKAudioFileQueuePlayer"
  },
  "title" : "WKAudioFileQueuePlayer"
}
-->

# WKAudioFileQueuePlayer

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

```
class WKAudioFileQueuePlayer
```

## Overview

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`](/documentation/WatchKit/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 [`replaceCurrentItem(with:)`](/documentation/WatchKit/WKAudioFilePlayer/replaceCurrentItem(with:)) method and uses it to end playback of one item and start playback of another.

## Topics

### Creating a Queue Player

[`init(items:)`](/documentation/WatchKit/WKAudioFileQueuePlayer/init(items:))

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

### Managing Items

[`items`](/documentation/WatchKit/WKAudioFileQueuePlayer/items)

The array of queued items.

[`advanceToNextItem()`](/documentation/WatchKit/WKAudioFileQueuePlayer/advanceToNextItem())

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

[`appendItem(_:)`](/documentation/WatchKit/WKAudioFileQueuePlayer/appendItem(_:))

Adds the specified item to the end of the queue.

[`removeItem(_:)`](/documentation/WatchKit/WKAudioFileQueuePlayer/removeItem(_:))

Removes the specified item from the queue.

[`removeAllItems()`](/documentation/WatchKit/WKAudioFileQueuePlayer/removeAllItems())

Removes all items from the queue.


---

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)