watchOS Complications deep link to a page in the app

Question

I am trying to build an app that supports multiple complication families on watch OS2 like modular large, utilitarian large, circular small etc, each showing various meaningful information from the app. I know complications is little similar to the glances we have since OS1 in terms of user interaction i.e, it opens the app on user clicking on it and no special interaction over there.

In glance I was able to do a deep link to the app based on current glance content but I am looking for a way to do the same with complications.

So my question is when the user clicks on my app's complication will I get any sort of context information saying this complication was clicked etc. I am thinking like if I may get a CLKComplication Object in the context.

Any help is appreciated.

Answer 1

In ClockKit/CLKDefines.h you can find the CLKLaunchedTimelineEntryDateKey constant.
But you can't define your own user info to help you determine what to do when your app is launched.

From the CLKComplicationDataSource Protocol Reference:

CLKLaunchedTimelineEntryDateKey

A key indicating the date with which the complication was launched. The value of this key is an NSDate object. When the user taps your complication, ClockKit includes this key in the dictionary passed to the handleUserActivity: method of the extension delegate.

Available in watchOS 2.0 and later.

Answer 2

Since you can get the tapped timeline entry's date via CLKLaunchedTimelineEntryDateKey, you can get the complication type (family) by making "fixed second" for specific type's timeline entry.

Fixed second should be calculated by NSDateComponents and then convert to NSDate that you can pass to CLKComplicationTimelineEntry.

For example, you can specify modularSmall entry's date end with 10 seconds but modularLarge entry's date end with 20 seconds. So, tapped entry with date 9:41:10 AM should be a modularSmall type, and entry with date 9:41:20 AM should be a modularLarge type.