<!--
{
  "documentType" : "article",
  "framework" : "WatchKit",
  "identifier" : "/documentation/WatchKit/media-player-options",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Media Player Options"
}
-->

# Media Player Options

Keys indicating media playback options.

## Topics

### Constants

[`let WKMediaPlayerControllerOptionsAutoplayKey: String`](/documentation/WatchKit/WKMediaPlayerControllerOptionsAutoplayKey)

The option to play a media file automatically when it is displayed. The value of this key is an <doc://com.apple.documentation/documentation/Foundation/NSNumber> object containing a Boolean value indicating whether the media file should begin playing automatically when the interface is displayed. Playback is also contingent upon the file being available and ready to play on Apple Watch. If you do not specify this option, the user must initiate playback.

[`let WKMediaPlayerControllerOptionsStartTimeKey: String`](/documentation/WatchKit/WKMediaPlayerControllerOptionsStartTimeKey)

The number of seconds into the media file at which to begin playback. The value of this key is an <doc://com.apple.documentation/documentation/Foundation/NSNumber> object containing an <doc://com.apple.documentation/documentation/Foundation/TimeInterval> value. Playback begins at the specified number of seconds past the original start point of the media file. If you do not specify this option, playback begins at the beginning of the media file.

[`let WKMediaPlayerControllerOptionsVideoGravityKey: String`](/documentation/WatchKit/WKMediaPlayerControllerOptionsVideoGravityKey)

The behavior for resizing the video to fit the available space. The value of this key is an <doc://com.apple.documentation/documentation/Foundation/NSNumber> object containing an appropriate constant of the [`WKVideoGravity`](/documentation/WatchKit/WKVideoGravity) type.

[`let WKMediaPlayerControllerOptionsLoopsKey: String`](/documentation/WatchKit/WKMediaPlayerControllerOptionsLoopsKey)

The behavior for playing the media in a loop. The value of this key is an <doc://com.apple.documentation/documentation/Foundation/NSNumber> object containing a Boolean value. Set the value to <doc://com.apple.documentation/documentation/Swift/true> to play the media file in a loop. If this key is not present, the media file plays one time and then ends.



---

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)