<!--
{
  "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/requestThumbnailImages(atTimes:timeOption:)",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "Media Player",
      "MediaPlayer"
    ],
    "preciseIdentifier" : "c:objc(cs)MPMoviePlayerController(im)requestThumbnailImagesAtTimes:timeOption:"
  },
  "title" : "requestThumbnailImages(atTimes:timeOption:)"
}
-->

# requestThumbnailImages(atTimes:timeOption:)

Captures one or more thumbnail images asynchronously from the current movie.

```
func requestThumbnailImages(atTimes playbackTimes: [Any]!, timeOption option: MPMovieTimeOption)
```

## Parameters

`playbackTimes`

An array of <doc://com.apple.documentation/documentation/Foundation/NSNumber> objects containing the times at which to capture the thumbnail images. Each 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 each thumbnail image. For a list of possible values, see [`MPMovieTimeOption`](/documentation/MediaPlayer/MPMovieTimeOption).

## Discussion

This method processes each thumbnail request separately and asynchronously. When the results for a single image arrive, the movie player posts a [`MPMoviePlayerThumbnailImageRequestDidFinishNotification`](/documentation/MediaPlayer/MPMoviePlayerThumbnailImageRequestDidFinishNotification) notification with the results for that image. Notifications are posted regardless of whether the image capture was successful or failed. You should register for this notification prior to calling this method.

> Note:
> This method is not not called when the source URL is an HTTP Live Streaming (HLS) content source. 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)