<!--
{
  "availability" : [
    "iOS: 3.2.0 - 9.0.0",
    "iPadOS: 3.2.0 - 9.0.0",
    "macCatalyst: 13.1.0 - 13.1.0"
  ],
  "documentType" : "symbol",
  "framework" : "MediaPlayer",
  "identifier" : "/documentation/MediaPlayer/MPMoviePlayerController/thumbnailImage(atTime:timeOption:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Media Player",
      "MediaPlayer"
    ],
    "preciseIdentifier" : "c:objc(cs)MPMoviePlayerController(im)thumbnailImageAtTime:timeOption:"
  },
  "title" : "thumbnailImage(atTime:timeOption:)"
}
-->

# thumbnailImage(atTime:timeOption:)

Captures and returns a thumbnail image from the current movie.

```
func thumbnailImage(atTime playbackTime: TimeInterval, timeOption option: MPMovieTimeOption) -> UIImage!
```

## Parameters

`playbackTime`

The time at which to capture the thumbnail image. The time value represents the number of seconds from the beginning of the current movie.

`option`

The option to use when determining which specific frame to use for the thumbnail image. For a list of possible values, see [`MPMovieTimeOption`](/documentation/MediaPlayer/MPMovieTimeOption).

## Return Value

An image object containing the image from the movie or `nil` if the thumbnail could not be captured.

## Discussion

This method captures the thumbnail image synchronously from the current movie (which is accessible from the [`MPMovieSourceType.unknown`](/documentation/MediaPlayer/MPMovieSourceType/unknown) property).

> Note:
> This method is not successful when the source URL is an HTTP Live Streaming (HLS) content source. The returned value for an HLS source is an empty `UIImage` object. See [HTTP Live Streaming Overview](https://developer.apple.com/library/archive/documentation/NetworkingInternet/Conceptual/StreamingMediaGuide/Introduction/Introduction.html#//apple_ref/doc/uid/TP40008332).

---

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)