---
title: WKInterfaceMovie
framework: watchkit
role: symbol
role_heading: Class
path: watchkit/wkinterfacemovie
---

# WKInterfaceMovie

An interface element that lets you play video and audio content in your watchOS app.

## Declaration

```swift
class WKInterfaceMovie
```

## Overview

Overview A movie object displays a poster image with a play button on top of it. When the user taps the play button, WatchKit plays the movie in a modal interface. Do not subclass or create instances of this class yourself. Instead, define outlets in your interface controller class and connect them to the corresponding objects in your storyboard file. For example, to refer to a movie object in your interface, define a property with the following syntax in your interface controller class: During the initialization of your interface controller, WatchKit creates any needed movie objects and assigns them to their associated outlets. At that point, you can use those objects to make changes to the onscreen content. Do not attempt to play audio or video content while gathering heart rate data using Health Kit. If you use this class to play media, WatchKit automatically disables the gathering of heart rate data. Supported Media Formats The following table lists the encoding information to use when creating media files to play on a user’s Apple Watch. For audio and video assets played directly from your app, keep your clips relatively short. Short clips consume less space on disk, use less power, and take less time to download.  |   |   |  Interface Builder Configuration Options Xcode lets you configure information about your movie interface object in your storyboard file. The following table lists the attributes you can configure and their meaning.  |   |   |

## Topics

### Setting the Movie Attributes

- [setMovieURL(_:)](watchkit/wkinterfacemovie/setmovieurl(_:).md)
- [setVideoGravity(_:)](watchkit/wkinterfacemovie/setvideogravity(_:).md)
- [setPosterImage(_:)](watchkit/wkinterfacemovie/setposterimage(_:).md)
- [setLoops(_:)](watchkit/wkinterfacemovie/setloops(_:).md)

### Initializing for SwiftUI

- [init()](watchkit/wkinterfacemovie/init().md)

## Relationships

### Inherits From

- [WKInterfaceObject](watchkit/wkinterfaceobject.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

### Images and movies

- [WKInterfaceImage](watchkit/wkinterfaceimage.md)
- [WKImage](watchkit/wkimage.md)
- [WKImageAnimatable](watchkit/wkimageanimatable.md)
- [WKInterfaceInlineMovie](watchkit/wkinterfaceinlinemovie.md)
- [WKInterfaceHMCamera](watchkit/wkinterfacehmcamera.md)
- [WKVideoGravity](watchkit/wkvideogravity.md)
