---
title: "requestThumbnailImages(atTimes:timeOption:)"
framework: mediaplayer
role: symbol
role_heading: Instance Method
path: "mediaplayer/mpmovieplayercontroller/requestthumbnailimages(attimes:timeoption:)"
---

# requestThumbnailImages(atTimes:timeOption:)

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

## Declaration

```swift
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 doc://com.apple.mediaplayer/documentation/MediaPlayer/MPMovieTimeOption.

## Discussion

Discussion This method processes each thumbnail request separately and asynchronously. When the results for a single image arrive, the movie player posts a 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.

## See Also

### Generating thumbnail images

- [thumbnailImage(atTime:timeOption:)](mediaplayer/mpmovieplayercontroller/thumbnailimage(attime:timeoption:).md)
- [cancelAllThumbnailImageRequests()](mediaplayer/mpmovieplayercontroller/cancelallthumbnailimagerequests().md)