resolveRecipients(for:with:)
Resolves the user’s input when it isn’t clear who the recipients of the message are.
Declaration
optional func resolveRecipients(for intent: INSendMessageIntent, with completion: @escaping @Sendable ([INSendMessageRecipientResolutionResult]) -> Void)optional func resolveRecipients(for intent: INSendMessageIntent) async -> [INSendMessageRecipientResolutionResult]Parameters
- intent:
The intent object that contains details about the user’s request. Use this object to get the initial information, if any, provided by the user.
- completion:
The block to execute with the resolution. You must execute this block while implementing this method. This block has no return value and takes the following parameter:
- resolutionResults
The object that contains the details of your proposed resolution. For each successful resolution, create a resolution object that includes the Inperson object representing the user who will receive the message.
Discussion
This method verifies the identity of the intended recipients. Always strive toward a successful resolution of the specified users, but ask for confirmation for one or more users if there is some uncertainty.
If multiple users match a single recipient, you might ask for disambiguation of the most likely candidates. When disambiguating users, provide as few choices as possible. If you find more than five possible users, consider another resolution.