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

# WKAudioFilePlayerItem

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

```
class WKAudioFilePlayerItem
```

## Overview

Create a player item for each [`WKAudioFileAsset`](/documentation/WatchKit/WKAudioFileAsset) object you want to play and use the player item to observe the state of the audio during playback. You can then associate the player item with an audio queue or player object to control the playback.

The value of the player item’s presentation-related properties are not valid until the underlying asset is loaded. Use the value of the [`status`](/documentation/WatchKit/WKAudioFilePlayerItem/status) property to determine when it is valid to get the values of other properties. Specifically, wait until the status changes to [`WKAudioFilePlayerItemStatus.readyToPlay`](/documentation/WatchKit/WKAudioFilePlayerItemStatus/readyToPlay) to access relevant properties.

If you want to play an asset more than once within a queue of items, you must create separate player items for each placement in the queue.

## Topics

### Creating a Player Item

[`init(asset:)`](/documentation/WatchKit/WKAudioFilePlayerItem/init(asset:))

Creates and returns a player item for the specified audio file asset.

### Getting Information About the Item

[`asset`](/documentation/WatchKit/WKAudioFilePlayerItem/asset)

The audio file asset being managed.

[`status`](/documentation/WatchKit/WKAudioFilePlayerItem/status)

The status of the player item.

[`error`](/documentation/WatchKit/WKAudioFilePlayerItem/error)

An error that describes the cause of a failure.

### Managing the Playback Position

[`currentTime`](/documentation/WatchKit/WKAudioFilePlayerItem/currentTime)

The current playback point, measured in seconds, from the beginning of the audio file.

[`setCurrentTime(_:)`](/documentation/WatchKit/WKAudioFilePlayerItem/setCurrentTime(_:))

Sets the playback point, measured in seconds, from the beginning of the audio file.

### Accessing the Item’s Status

[`WKAudioFilePlayerItemStatus`](/documentation/WatchKit/WKAudioFilePlayerItemStatus)

Constants that represent the status of a player item.

### Receiving Notifications

[`WKAudioFilePlayerItemTimeJumpedNotification`](/documentation/WatchKit/WKAudioFilePlayerItemTimeJumpedNotification)

A notification that the item’s current time has changed discontinuously.

[`WKAudioFilePlayerItemDidPlayToEndTimeNotification`](/documentation/WatchKit/WKAudioFilePlayerItemDidPlayToEndTimeNotification)

A notification that the item has played successfully to its end.

[`WKAudioFilePlayerItemFailedToPlayToEndTimeNotification`](/documentation/WatchKit/WKAudioFilePlayerItemFailedToPlayToEndTimeNotification)

A notification that the item failed to play to its end.


---

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)