Protocol

INSearchForMessagesIntentHandling

An interface that handles requests to search the current user’s messages.

Declaration

@protocol INSearchForMessagesIntentHandling

Overview

Use the methods of the INSearchForMessagesIntentHandling protocol to resolve, confirm, and handle requests to search the current user’s messages. Adopt this protocol in an object of your Intents extension capable of searching your app’s messages.

Siri delivers an INSearchForMessagesIntent object to your handler when the user asks to search their messages. The provided intent object contains the search parameters to use when matching messages. Use the methods of this protocol to resolve the search parameters, to perform the search, and to return the results.

Topics

Resolving the Intent Parameters

- resolveRecipientsForSearchForMessages:withCompletion:

Resolves the user’s input when they search for messages sent to specific people.

- resolveSendersForSearchForMessages:withCompletion:

Resolves the user’s input when they search for messages sent by specific people.

- resolveAttributesForSearchForMessages:withCompletion:

Resolves the user’s input when they search for messages with specific attributes.

- resolveDateTimeRangeForSearchForMessages:withCompletion:

Resolves the user’s input when they search for messages sent in a specific time period.

- resolveSpeakableGroupNamesForSearchForMessages:withCompletion:

Resolves the user’s input when they search for messages sent to a specific group of people.

- resolveGroupNamesForSearchForMessages:withCompletion:

Resolves the user’s input when they search for messages sent to a specific group of people.

Deprecated

Confirming the Response

- confirmSearchForMessages:completion:

Confirms whether you can perform the search.

Handling the Intent

- handleSearchForMessages:completion:

Performs the search and returns the results.

Required.

Relationships

Inherits From

See Also

Search for Messages

INSearchForMessagesIntent

A request to list the messages matching the specified criteria.

INSearchForMessagesIntentResponse

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

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software