{"id":22554,"date":"2015-11-09T14:28:16","date_gmt":"2015-11-09T22:28:16","guid":{"rendered":"https:\/\/blog.xamarin.com\/?p=22554"},"modified":"2015-11-09T14:28:16","modified_gmt":"2015-11-09T22:28:16","slug":"getting-started-with-handoff-in-ios","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/xamarin\/getting-started-with-handoff-in-ios\/","title":{"rendered":"Getting Started with Handoff in iOS"},"content":{"rendered":"

\"handoff_icon\"The users of your application should always be at the center of the functionality you implement. With the beautiful, seamless user experiences that exist in popular mobile apps today, users have high expectations for a great mobile experience. Adding handoff to your iOS apps helps easily deliver a seamless user experience between Apple devices logged into the same iCloud account. Also known as Continuity<\/i>, Handoff<\/a> was introduced by Apple in iOS 8 and OS X Yosemite. It allows users to\u00a0start an activity on one of their Apple devices and continue that same activity on another of device. Have you ever noticed an app icon on the bottom left corner of your iPhone’s lock screen? This was an app giving you the option to continue an activity that you had already started on your iPad or your Mac. In this blog post, I will explain how to implement handoff in your iOS apps and the improvements\u00a0Apple has added\u00a0to the Handoff APIs in iOS 9, specifically to NSUserActivity.<\/p>\n

Introducing the NSUserActivity<\/h2>\n

One thing that you need to know for this blog post is exactly what a NSUserActivity<\/a> is and how it works. The NSUserActivity class is the primary object in a Handoff exchange and is used to encapsulate the state of a User Activity that is available to pass between Apple devices. Here’s a diagram of what a Handoff looks like:<\/p>\n

\"Handoff<\/p>\n

In this diagram you’ll notice that the devices need to be logged into the same iCloud account. You can get more details about NSUserActivity class from Apple’s documentation<\/a>.<\/p>\n

NSUserActivity\u00a0for iOS 9<\/h2>\n

In iOS 9, the NSUserActivity class that is used for Handoff now gives developers some additional benefits<\/a>. In iOS 8, Activities were only used for Handoff, but with the release of iOS 9 Activities are used for App Search, Siri Suggestions, and Siri Smart Reminders. This means it’s very easy to add App Search<\/a> capabilities to an app that is already using Handoff, or vice versa!<\/p>\n

How To Implement Handoff<\/h2>\n

Implementing Handoff in a Xamarin.iOS app requires you to create a User Activity Object, update the object’s state to track the activity, and continue the activity on a receiving device. For this post, we are going to use an app that has four tabs, each with a web browser in them, and Handoff the most recent tab to another device.<\/p>\n

Note:<\/b> Please make sure you enable Handoff<\/a>\u00a0in your Xamarin app before you start adding the new functionality.<\/p>\n

Getting Set Up<\/h3>\n

1. Add NSUserActivityTypes to your info.plist.<\/span><\/p>\n

a. Since I have four tabs in my app, I’m going to add four Activity Types to my info.plist file like this:<\/p>\n

\"Activity<\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

2. Add NSUserActivity constants to AppDelegate.<\/p>\n

a.\u00a0Notice that my constants are consistent with the values in my info.plist.<\/p>\n

public NSString UserActivityTab1 = new NSString (\"com.xamarin.monkeybrowser.tab1\");\npublic NSString UserActivityTab2 = new NSString (\"com.xamarin.monkeybrowser.tab2\");\npublic NSString UserActivityTab3 = new NSString (\"com.xamarin.monkeybrowser.tab3\");\npublic NSString UserActivityTab4 = new NSString (\"com.xamarin.monkeybrowser.tab4\");\n<\/pre>\n
Creating a NSUserActivity<\/h3>\n
In my app, I want to create a new NSUserActivity each time a user enters a new URL in the WebView.<\/p>\n
1. On each ViewController, I want to add a public NSUserActivity object:<\/p>\n
public NSUserActivity UserActivity { get; set; }\n<\/pre>\n
2. Now, in the method used to navigate to a new URL, I’ll create a new NSUserActivity (after invalidating the existing one:<\/p>\n
if (UserActivity != null) {\n     UserActivity.Invalidate();\n     UserActivity = null;\n}\nUserActivity = new NSUserActivity (ThisApp.UserActivityTab1){\n     Title = \"Weather Tab\",\n     SupportsContinuationStreams = true\n};\n<\/pre>\n
3. Finally, I’ll add some User Info to the new Activity and I’ll make it the Current<\/em> activity.<\/p>\n
var userInfo = new NSMutableDictionary ();\nuserInfo.Add (new NSString (\"Url\"), new NSString (url));\nUserActivity.AddUserInfoEntries (userInfo);\nUserActivity.BecomeCurrent ();\n<\/pre>\n
Continuing an Activity<\/h3>\n
1. Add a PerformHandoff method to each ViewController:<\/p>\n
public void PerformHandoff(NSUserActivity activity) \n{\n     var url = activity.UserInfo [\"Url\"].ToString ();\n     URL.Text = url;\n     WebView.LoadRequest(new NSUrlRequest(NSUrl.FromString(url)));\n     UserActivity = activity;\n     UserActivity.BecomeCurrent ();\n}\n<\/pre>\n
2. Add properties to UIApplicationDelegate for each ViewController so that I can access the PerformHandoff<\/em> method I just implemented:<\/p>\n
public FirstViewController Tab1 { get; set; }\npublic SecondViewController Tab2 { get; set;}\npublic ThirdViewController Tab3 { get; set; }\npublic FourthViewController Tab4 { get; set; }\n<\/pre>\n
3. Override the ContinueUserActivity<\/em> method in App Delegate:<\/p>\n
public override bool ContinueUserActivity (UIApplication application, NSUserActivity userActivity, UIApplicationRestorationHandler completionHandler)\n{\n     switch (userActivity.ActivityType) {\n          case \"com.xamarin.monkeybrowser.tab1\":\n\t       Tab1.PerformHandoff (userActivity);\n\t       completionHandler (new NSObject[]{Tab1});\n\t       break;\n\t  case \"com.xamarin.monkeybrowser.tab2\":\n\t       Tab2.PerformHandoff (userActivity);\n\t       completionHandler (new NSObject[]{Tab2});\n\t       break;\n\t  case \"com.xamarin.monkeybrowser.tab3\":\n\t       Tab3.PerformHandoff (userActivity);\n\t       completionHandler (new NSObject[]{Tab3});\n\t       break;\n\t  case \"com.xamarin.monkeybrowser.tab4\":\n\t       Tab4.PerformHandoff (userActivity);\n\t       completionHandler (new NSObject[]{Tab4});\n\t       break;\n     }\n     return true;\n}\n<\/pre>\n
Additional Resources<\/h2>\n
We have a detailed Introduction to Handoff<\/a> guide that has more screenshots and details on how to gracefully handle failures with handoff, best practices, and more. There’s also a sample handoff app<\/a> for iOS 8 that you could easily add some code to that makes each of\u00a0the NSUserActivity used for Handoff searchable through spotlight<\/a>.\t\t<\/p>\n","protected":false},"excerpt":{"rendered":"
The users of your application should always be at the center of the functionality you implement. With the beautiful, seamless user experiences that exist in popular mobile apps today, users have high expectations for a great mobile experience. Adding handoff to your iOS apps helps easily deliver a seamless user experience between Apple devices logged […]<\/p>\n","protected":false},"author":544,"featured_media":22593,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[2],"tags":[6],"class_list":["post-22554","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-developers","tag-ios"],"acf":[],"blog_post_summary":"
The users of your application should always be at the center of the functionality you implement. With the beautiful, seamless user experiences that exist in popular mobile apps today, users have high expectations for a great mobile experience. Adding handoff to your iOS apps helps easily deliver a seamless user experience between Apple devices logged […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/22554","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/users\/544"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/comments?post=22554"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/posts\/22554\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/media?parent=22554"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/categories?post=22554"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/xamarin\/wp-json\/wp\/v2\/tags?post=22554"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}