Displays a modal interface for playing the specified media file.
- watchOS 2.0+
The URL of the media file you want to play. The URL must specify a file; streamed media is not supported. The file may contain audio, video, or both.
If you specify a URL for a file on a remote server, this method downloads the file first and displays a progress indicator showing the progress of the operation. Because WatchKit uses App Transport Security (ATS) when downloading files from a web server, the file must be on a secure server, and the URL must use the
httpsscheme. If your server does not support ATS–level security, download the file yourself before playing it.
An optional dictionary of playback options for the media file. For a list of keys to include in the dictionary, see Media Player Options.
The block to execute when playback ends. Use this block to determine the status of playback and to perform any cleanup. This block has no return value and takes the following parameters:
A Boolean value indicating whether the media file finished playing. The value is
trueif the end of the media file was reached or
falseif playback ended prematurely.
The time (in seconds) at which playback ended. When the
Play To End
false, you can use the value in this property to determine when playback stopped. You might use that value as the start time if you play the content again.
An error object if a problem occurred. Use the error object to determine the cause of the problem and take any appropriate actions, such as notifying the user.
Use this method to present short media clips to the user. This method executes asynchronously, returning shortly after you call it. During a subsequent run loop cycle, the system presents a media interface controller over the current interface controller. For video, the interface controller displays the video content along with controls to start and stop playback. For audio, the interface controller displays information about the content being played. Always call this method from your WatchKit extension’s main thread.
When the user dismisses the interface, or when you dismiss the media player programmatically, WatchKit calls the block provided in the
completion parameter. Use that block to find out how much of the media file was played or other relevant information. For example, you might note the stopping point and start playback of the same clip from that point later.
Table 1 lists the encoding information to use when creating media files. 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.
Video codec: H.264 High Profile
Bit rate: 160 kpbs at up to 30 fps
Full screen resolution: 208 x 260 in portrait orientation
16:9 resolution: 320 x 180 in landscape orientation
Audio bit rate: 32 kpbs stereo
Bit rate: 32 kbps stereo
Any audio you play using this method is routed to a paired Bluetooth audio device if one is available. If no Bluetooth audio device is available, audio is routed to to the Apple Watch speaker.