---
title: WKAudioFilePlayerItem
framework: watchkit
role: symbol
role_heading: Class
path: watchkit/wkaudiofileplayeritem
---

# WKAudioFilePlayerItem

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

## Declaration

```swift
class WKAudioFilePlayerItem
```

## Overview

Overview Create a player item for each 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 property to determine when it is valid to get the values of other properties. Specifically, wait until the status changes to 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:)](watchkit/wkaudiofileplayeritem/init(asset:).md)

### Getting Information About the Item

- [asset](watchkit/wkaudiofileplayeritem/asset.md)
- [status](watchkit/wkaudiofileplayeritem/status.md)
- [error](watchkit/wkaudiofileplayeritem/error.md)

### Managing the Playback Position

- [currentTime](watchkit/wkaudiofileplayeritem/currenttime.md)
- [setCurrentTime(_:)](watchkit/wkaudiofileplayeritem/setcurrenttime(_:).md)

### Accessing the Item’s Status

- [WKAudioFilePlayerItemStatus](watchkit/wkaudiofileplayeritemstatus.md)

## Relationships

### Inherits From

- [NSObject](objectivec/nsobject-swift.class.md)

### Conforms To

- [CVarArg](swift/cvararg.md)
- [CustomDebugStringConvertible](swift/customdebugstringconvertible.md)
- [CustomStringConvertible](swift/customstringconvertible.md)
- [Equatable](swift/equatable.md)
- [Hashable](swift/hashable.md)
- [NSObjectProtocol](objectivec/nsobjectprotocol.md)

## See Also

### Audio

- [Playing Background Audio](watchkit/playing-background-audio.md)
- [Adding a Now Playing View](watchkit/adding-a-now-playing-view.md)
- [WKInterfaceVolumeControl](watchkit/wkinterfacevolumecontrol.md)
- [PUICAutoLaunchAudioOptOut](bundleresources/information-property-list/puicautolaunchaudiooptout.md)
- [WKAudioFilePlayer](watchkit/wkaudiofileplayer.md)
- [WKAudioFileQueuePlayer](watchkit/wkaudiofilequeueplayer.md)
- [WKAudioFileAsset](watchkit/wkaudiofileasset.md)