Protocol

INSearchCallHistoryIntentHandling

The handler interface for searching the user’s call history.

Overview

Use the methods of the INSearchCallHistoryIntentHandling protocol to resolve, confirm, and handle requests to search for calls in the user’s call history. Adopt this protocol in an object of your Intents extension that is capable of performing the search and determining if any matching records are found. Siri does not display the call information found during the search. After a successful search, Siri launches your app to display that information.

Siri delivers an INSearchCallHistoryIntent object to your handler when the user asks to search their call history. The provided intent object contains the search parameters, such as any contacts involved in the call or the range of dates to search. Use the methods of this protocol to resolve the search parameters and to perform the search.

Topics

Handling the Intent

func handle(intent: INSearchCallHistoryIntent, completion: (INSearchCallHistoryIntentResponse) -> Void)

Called when it is time to search the user’s call history.

Required.

Confirming the Response

func confirm(intent: INSearchCallHistoryIntent, completion: (INSearchCallHistoryIntentResponse) -> Void)

Called when it is time for you to validate that you can perform the search.

Resolving Details of the Intent

func resolveCallType(for: INSearchCallHistoryIntent, with: (INCallRecordTypeResolutionResult) -> Void)

Called when you need to resolve the search criteria for the call type.

Deprecated
func resolveRecipient(for: INSearchCallHistoryIntent, with: (INPersonResolutionResult) -> Void)

Called when you need to resolve the search criteria for the recipients.

func resolveUnseen(for: INSearchCallHistoryIntent, with: (INBooleanResolutionResult) -> Void)

Called when you need to resolve whether you can search for calls that the user has not yet seen.

Relationships

Inherits From

See Also

Search the Call History

class INSearchCallHistoryIntent

A request to list the calls matching the specified criteria.

class INSearchCallHistoryIntentResponse

Your app’s response to a search call history intent.