{"id":12620,"date":"2019-01-02T10:37:50","date_gmt":"2019-01-02T10:37:50","guid":{"rendered":"https:\/\/www.mindinventory.com\/blog\/integrating-siri-in-third-party-apps\/"},"modified":"2024-10-03T09:39:19","modified_gmt":"2024-10-03T09:39:19","slug":"integrating-siri-in-third-party-apps","status":"publish","type":"post","link":"https:\/\/www.mindinventory.com\/blog\/integrating-siri-in-third-party-apps\/","title":{"rendered":"The Entire Process of Integrating Siri in the Third-Party Apps"},"content":{"rendered":"

Ever since Apple introduced its voice recognition assistant in 2011, the Artificial Intelligence (AI) based technology is going great guns. Following its successful launch, there were further enhancements and the WWDC Apple Event in 2017 saw the vital announcement of Siri integration with the third-party apps.<\/p>\n

However, this integration was limited to a few apps only such as messaging, payments, photo search, and booking apps. With the release of iOS 11, this list was further extended and one also witnessed the introduction of SiriKit.<\/p>\n

The introduction of\u00a0SiriKit\u00a0has added another feather into the cap. This framework has simplified the task of the\u00a0iOS\u00a0app developers<\/a> to a great extent. It has become much easier to add new customized features to Siri, which is then integrated with the third-party apps. But it\u00a0must be\u00a0noted that you can get access to the benefits of\u00a0SiriKit\u00a0only if you are using\u00a0iOS\u00a010 or the advanced versions.<\/p>\n

One of the major factors that have led to\u00a0the increment of\u00a0the popularity of\u00a0Siri is that the users\u2019 just need to give a voice command and the task\u00a0is performed. So, whether it is paying a monthly electric bill, or adding a new item into your online shopping cart, use voice command to get the work done.<\/p>\n

If we talk about the stat and figures, then\u00a0according to Business Insider<\/a>, about 70% of the iPhone users agree that they have used Siri sometimes or rarely. On the other hand,\u00a0Statista, reports<\/a>\u00a0that 51% of Americans comprehensively and clearly understand the usage of Siri in their devices.<\/p>\n

In fact, the addition of functionality has indeed become easier as it needs to be implemented with the help of SiriKit.<\/p>\n

Here we would have a detailed discussion on how to integrate the Siri with a third-party app.<\/p>\n

<\/span>Selecting a Particular Niche<\/span><\/h2>\n

First things first, you need to choose a particular domain or niche or the app based on the app activity. However, it must be noted that SiriKit does not support all app domains; so, you have limited choice. For example, you can choose messaging apps, payment, workouts, image searching, climate and radio etc. You can find more options from the SiriKit Programming Guide.<\/p>\n

Siri makes use of the intents to perform the tasks. When the user wants Siri to fulfil a task, it would send the user intent with other details to the handler of that intent. The intent comprise of its own protocol, which the manager incorporates for that intent. You also get the advantage of expanding the default User Interface in the Siri window.<\/p>\n

<\/span>Building a Cocoa Touch Framework<\/span><\/h2>\n

Once you have chosen the app domain, the next task is to build a Cocoa Touch framework for the application. You should remember to receive the Siri support through the integration of the Intents Extension and that you cannot use the codes directly.<\/p>\n

Therefore, you need to take the help of the Cocoa Touch framework. For this, you have to first visit the Xcode menu and then choose File\u2013>New\u2013>Target. This will set up the Cocoa Touch Framework.<\/p>\n

In the next step, you would be asked to choose the template that you want to use for the target. Then you would get across a window where you can change the template option and name your framework. You need to verify carefully that the framework contains the similar project and check the insert in application field.<\/p>\n

<\/span>The Addition of Classes to Framework<\/span><\/h2>\n

Upon the completion of the above task, the next job in hand is adding the classes to the framework. You can add the classes, which highlight your domain of the user request sending the requests for the backend development process.<\/p>\n

In case, your class is already integrated move on to the name of your framework. Now, you need to eliminate the class from the key target and add them manually to the framework target.<\/p>\n

<\/span>The Integration of the Intent Handler<\/span><\/h2>\n

Now we have reached the most crucial step of integrating the Siri in third-party apps. Here we have to implement the intent handler. But before you go into the details, the first job in hand is to add an intent extension target to your app.<\/p>\n

You can do this by the following process- File\u2013>New\u2013>Target. Next choose the Intents Extension. At this stage you will be required to fill out a name such as the SiriIntentExtension<\/span>.\u201d<\/p>\n

Now you also have to add a few data to the Info.plist\u201d file of the \u201cSiriIntentExtension<\/span>\u201d<\/p>\n

<key>NSExtension<\/key>\n<dict>\n<key>NSExtensionAttributes<\/key>\n<dict>\n<key>IntentsSupported<\/key>\n<array>\n<string>INSendMessageIntent<\/string>\n<\/array>\n<\/dict>\n<key>NSExtensionPointIdentifier<\/key>\n<string>com.apple.intents-service<\/string>\n<key>NSExtensionPrincipalClass<\/key>\n<string>$(PRODUCT_MODULE_NAME).IntentHandler<\/string>\n<\/dict>\n<\/pre>\n
You need to denote the supported intents list. In case you are reducing the accessibility of the intents for the locked devices, it is important to detail out the restricted intents list with the help of IntentsRestrictedWhileLocked<\/span> button.<\/p>\n
On the other hand, we have the NSExtensionPrincipalClass<\/span> key offering the name of the class in the IntentsExtension<\/span> deciding the name of the handler for the intent. You can name this class as IntentHandler<\/span>.<\/p>\n
This is an easy step to follow:<\/p>\n
import Intents\nclass IntentHandler: INExtension {\n   override func handler(for intent: INIntent) -> Any? {\n     return MessagesIntentHandler()\n   }\n}\n<\/pre>\n
As we can see there is a return of instance of MessagesIntentHandler<\/span> for the specified intent as we focused only on a single intent type. But in case of various intents, you need to check the intent handler for<\/p>\n
if intent is INSendMessageIntent {\n  return MessagesIntentHandler()\n}\n<\/pre>\n
The name MessagesIntentHandler is a class and the happening place. So if you want to incorporate this class you can follow the code below.<\/p>\n
class MessagesIntentHandler: NSObject, \nINSendMessageIntentHandling {\n...\n}\n<\/pre>\n
You need the support of NSObjectProtocol<\/span> if you want to run the INSendMessageIntentHandling<\/span> protocol. This protocol has one compulsory and four other optional functions. If we talk about the four optional functions then these are:<\/p>\n
The first is known as the resolveRecipients(forSendMessage:with:)<\/span> where you have to specify the name of the recipient for the given intent. If you are using single intent, please acknowledge the entire suggested recipients. This will prevent Siri from asking the users to resolve the recipient issue.<\/p>\n
func resolveRecipients(forSendMessage intent: INSendMessageIntent, with completion: @escaping ([INPersonResolutionResult]) -> Void) {\n  guard let recipients = intent.recipients else {\n    completion([])\n    return\n   }\n   let resolutionResults = recipients.map { \n  INPersonResolutionResult.success(with: $0) }\n    completion(resolutionResults)\n}\n<\/pre>\n
Using the code above you have chosen the recipients from the intent to offer a solution for each of these.<\/p>\n
The second optional function is resolveContent (forSendMessage: with \ud83d\ude42<\/span>. It helps in the validation of the input test. Check out the following code which is for filtering empty requests.<\/p>\n
func resolveContent(forSendMessage intent: INSendMessageIntent, with completion: @escaping (INStringResolutionResult) -> Void) {\n   if let text = intent.content, !text.isEmpty {\n     completion(INStringResolutionResult.success(with: text))\n   } else {\n     completion(INStringResolutionResult.needsValue())  \n   } \n }\n<\/pre>\n
The users have to get authorized before they can use the app and get access to the SiriIntentExtention<\/span>\u2019s functionality. If you want to check the authorization of the users make sure the INSendMessageIntentHandling<\/span> protocol has the confirm(sendMessage:completion:)<\/span> function.<\/p>\n
func confirm(sendMessage intent: INSendMessageIntent, completion: @escaping (INSendMessageIntentResponse) -> Void) {\n   let userActivity = NSUserActivity(activityType: String(describing: INSendMessageIntent.self))\n   let responseCode: INSendMessageIntentResponseCode\n   if !NetworkReachability.isReachable {\n     userActivity.userInfo = [\"error\": SiriIntentError.noInternetConnection]\n     responseCode = .failureMessageServiceNotAvailable\n   } else if !UserSession.hasAuthorizedSession() {\n     userActivity.userInfo = [\"error\": SiriIntentError.notAuthorized]  \n     responseCode = .failureRequiringAppLaunch\n   } else {\n    responseCode = .success\n   }\n   let response = INSendMessageIntentResponse(code: responseCode, userActivity: userActivity)\n  completion(response)\n}\n<\/pre>\n
You need to verify the authorization of the user along with checking the internet connectivity as well. Do remember that NSUserActivity<\/span> is accessible only if the application is opened. If you are unable to verify you get an error such as failureRequiringAppLaunch<\/span>.<\/p>\n
Siri will prompt the user to open his application. Once the app gets opened, you would sort out the userActivity<\/span> and probably retry for authorization. We can how get the code for the last main function such as<\/p>\n
func handle(sendMessage intent: INSendMessageIntent, completion: @escaping (INSendMessageIntentResponse) -> Void) {\n  MessageResolver.resolveSiriRequest(with: intent.content) { message in\n   self.apiClient.send(message: message) { error in\n    let responseCode: INSendMessageIntentResponseCode\n    let userActivity = NSUserActivity(activityType: NSStringFromClass(INSendMessageIntent.self))\n    if let error = error {\n      userActivity.userInfo = [\"error\": error]\n      responseCode = .failure\n    } else {\n      responseCode = .success\n    }\n    let response = INSendMessageIntentResponse(code: responseCode, userActivity: userActivity)\ncompletion(response)\n    }\n  }\n}\n<\/pre>\n
Here we try to solve the user domain issue by sending a wrapped message to the server intent.content<\/span>. This is the user-recorded text message. In case you do not succeed in the task, you can send a failure response code. In such a case the Siri would inform the user that their request wasn\u2019t successfully sent.<\/p>\n
If you want to get more information on integration of the MessageIntentHandler<\/span>, do consult the GitHub. Don\u2019t forget to add the NSSiriUsageDescription<\/span> key to the app\u2019s Info.plist.<\/p>\n
<\/span>The Testing<\/span><\/h2>\n
Now the last task is testing whether the integration of Siri in third-party app was successful or not. In order to do so we have to imagine any app name for example, say Beautiful and the NSSiriUsageDescription<\/span>.<\/p>\n
After this try using Siri and say Beautiful a message saying test message. You get across to the next screen as below:<\/p>\n
\"testing\"<\/p>\n
Well, there is another alternative as well in which you can access the functionality with the process of authorization, which will lead you to the screen below:<\/p>\n
\"testing\"<\/p>\n
<\/span>Topnotch Third-Party Apps using Siri<\/span><\/h2>\n
It is noteworthy that some top-notch brands are using Siri in their third-party apps. Some worthy names include Uber, Skype, Lyft, Pinterest, Whatsapp, LinkedIn, and others.<\/p>\n
<\/span>Important Tips for Developing the Extension<\/span><\/h2>\n