The handler interface for searching the user’s photos.


@protocol INSearchForPhotosIntentHandling


Use the methods of the INSearchForPhotosIntentHandling protocol to resolve, confirm, and handle requests to search the photos in your app. Adopt this protocol in an object of your Intents extension that is capable of performing the search and determining the number of results. Siri does not display the photos found during the search. After a successful search, Siri launches your app to display the photos.

Siri delivers an INSearchForPhotosIntent object to your handler when the user asks to search their photos. The provided intent object contains the parameters to use when searching for the photos. Use the methods of this protocol to resolve the search parameters, to perform the search, and to return the number of photos that match the criteria.


Resolving the Intent Parameters

- resolveDateCreatedForSearchForPhotos:withCompletion:

Resolves the taken dates for the photos.

- resolveAlbumNameForSearchForPhotos:withCompletion:

Resolves the name of the photo album containing the photos.

- resolveSearchTermsForSearchForPhotos:withCompletion:

Resolves any search terms provided by the user.

Confirming the Response

- confirmSearchForPhotos:completion:

Confirms whether you can perform the search.

Handling the Intent

- handleSearchForPhotos:completion:

Handles searching the photos and returning the number of results.



Inherits From

See Also

Search for Photos

Searching for Photos

Use SiriKit to search for photos managed by your app.


A request for the list of photos that match the specified criteria.


Your app’s response to a search for photos intent.