Our experience using ResearchKit and intro to CareKit and HealthKit

1. iPhone, una herramienta médica
Helen Olhausen y Washington Miranda

2. ResearchKit
Open Source
Researchers
Users
Physician
Charts
Forms
Pre-built UI
HealthKit
CoreMotion
CareKit
Extensible

3. CareKit
• Care Cards
• Symptom and Measurement Tracker
• Insights
• Connect
• Care Plan Store

4. Care Card

5. Symptom and
Measurement
Tracker

6. Insights

7. Connect

8. ResearchKit
• Informed Consent
• Surveys and Active Tasks
• Dashboard

9. Consent

10. Surveys

11. Active Tasks

12. Dashboard

13. Dashboard

14. 3 Modules
Survey - Consent - Active Tasks

15. Cada actividad que se pide al usuario realizar se modela como una Task

18. The “easy”
Consent - Survey

19. Consent
ORKConsentDocument
• public var sections: [ORKStepConsentSection]?
• ORKStepConsentSection
public init(type: ORKConsentSectionType)
tiene section types por defecto

20. Surveys
• ORKNavigableOrderedTask
•ORKOrderedTask

21. Surveys
ORKNavigableOrderedTask
• overrides `stepAfterStep`
- (ORKStep *)stepAfterStep:(ORKStep *)step withResult:(ORKTaskResult *)result
La usamos cuando queremos que nuestro proximo step, dependa del resultado del
step anterior, para esto definimos reglas ORKStepNavigationRule, como por ejemplo:
// if user answers 'No' take it to the end of the survey
let resultSelector = ORKResultSelector(resultIdentifier: "physical_activity_pain")
let predicateNonEligibleSurvey = ORKResultPredicate.
predicateForBooleanQuestionResultWithResultSelector(resultSelector,expectedAnswer: false)
let predicateRule = ORKPredicateStepNavigationRule(resultPredicatesAndDestinationStepIdentifiers:
[(predicateNonEligibleSurvey,
summaryStep.identifier)])
physicalActivityTask.setNavigationRule(predicateRule, forTriggerStepIdentifier:"physical_activity_pain")

22. ORKInstructionStep
ORKQuestionStep
ORKFormStep
Surveys Steps

23. The “not so easy”
Active Task

24. Active Tasks
Active Step
• Interactivo
• Recolección de datos usando sensores

25. Active Step
• Es donde se realmente se “hace el trabajo”

26. import UIKit
import ResearchKit
class WalkTillStationaryTaskStep: ORKActiveStep {
var maxStationaryDuration : NSTimeInterval!
static func stepViewControllerClass() -> AnyObject {
return WalkTillStationaryTaskStepViewController.self
}
override init(identifier: String) {
super.init(identifier: identifier)
self.shouldShowDefaultTimer = false
}
required init(coder aDecoder: NSCoder) {
super.init(coder: aDecoder)
self.shouldShowDefaultTimer = false
}
// por defecto si no se define un stepDuration, la actividad comienza como finalizada
func startsFinished() -> Bool {
return false
}
}
Caso Particular
• Terminar el step cuando el usuario deja de caminar por mas de un minuto
• Subclass ORKActiveStep
• Implementar stepViewControllerClass(), este método le dice al task view controller qué Step view controller
instanciar cuando va a presentar este Step

27. • Subclass ORKActiveStepViewController
import UIKit
import ResearchKit
import CoreMotion
class WalkTillStationaryTaskStepViewController: ORKActiveStepViewController {
…
override func viewDidLoad() {
super.viewDidLoad()
self.customView = WalkTillStationaryContentView()
…
override func start() {
super.start()
// Start Timers
self.startStationaryTimer()
self.startElapsedTimer()
// Start self recorders
// start tracking user activity
self.startUpdateActivity()
// start pedometer
self.startPedometer()
}
override func suspend() {
super.suspend()
motionActivitiyManager.stopActivityUpdates()
}
…
private func stationaryTimerDidFire() {
// user has been stationary for more than one minute
self.suspend()
self.finish()
}
…

28. • Subclass ORKActiveStepCustomView
provee la vista custom del view controller
public var customView: UIView?
• Active step life cycle
override start, suspend, resume, finish
• Data collection
public var recorders: [AnyObject]? (read-only)
Los recorders se generan cuando comienza el step basándose en las `recorder
configuration` para ese step
var recorderConfigurations = [ORKRecorderConfiguration]()
recorderConfigurations += [ORKPedometerRecorderConfiguration(identifier: "pedometer")]
• Output directory
taskViewController.outputDirectory
• CoreMotion

29. var steps = [ORKStep]()
let countdownStep = ORKCountdownStep(identifier: "countdown_step")
countdownStep.stepDuration = 5.0
steps += [countdownStep]
var recorderConfigurations = [ORKRecorderConfiguration]()
recorderConfigurations += [ORKPedometerRecorderConfiguration(identifier: "pedometer")]
let walkingStep = WalkTillStationaryTaskStep(identifier: "walk_step")
walkingStep.title = NSLocalizedString("Continue walking as much as you can", comment: "")
walkingStep.text = NSLocalizedString("Hit the stop button to stop exercise", comment: "")
walkingStep.shouldContinueOnFinish = true
walkingStep.optional = false
steps += [walkingStep]
let task = ORKOrderedTask(identifier: “walk_stationary_task”, steps: steps)
let taskViewController = ORKTaskViewController(task: activity.task, taskRunUUID: activity.taskUUID)
taskViewController.delegate = self
taskViewController.outputDirectory = NSFileManager.defaultManager().URLsForDirectory(.DocumentDirectory,
inDomains: .UserDomainMask).first!
self.presentViewController(taskViewController, animated: true, completion: nil)
Declaro el step para ser usado en una Task

30. Getting Results
extension JoinViewController : ORKTaskViewControllerDelegate {
func taskViewController(taskViewController: ORKTaskViewController, didFinishWithReason reason:
ORKTaskViewControllerFinishReason, error: NSError?) {
if reason == .Completed {
if taskViewController.task?.identifier == "registrationTask" {
self.handleUserRegistration(taskViewController.result)
} else if taskViewController.task?.identifier == "registrationAdditionalTask" {
self.handleUserAdditionalInfo(taskViewController.result)
}
}
self.dismissViewControllerAnimated(true, completion: nil)
}
}
• Los identificadores únicos toman importancia
let joinTask = ORKOrderedTask(identifier: "registrationTask", steps: [
consentStep,
shareStep,
healthDataStep,
registrationStep
]
)
let taskViewController = ORKTaskViewController(task: joinTask, taskRunUUID: nil)
taskViewController.delegate = self
self.presentViewController(taskViewController, animated: true, completion: nil)
Presentando un taskViewController
Delegate

31. if let results = taskResult.results as? [ORKStepResult] {
for stepResult: ORKStepResult in results {
for result: ORKResult in stepResult.results! {
if let questionResult = result as? ORKQuestionResult {
if let answer = questionResult.answer {
if questionResult.identifier == "ORKRegistrationFormItemEmail" {
// do something
}
}
}
if let questionResult = result as? ORKChoiceQuestionResult {
if questionResult.identifier == ActivitiesListRow.SurgicalHistoryIdentifier.rawValue {
// do something
}
Iterando por identifier
Iterando por el tipo de result

32. HealthKit
import UIKit
import HealthKit
class DailyHealthManager {
static let sharedInstance = DailyHealthManager()
lazy var healthStore: HKHealthStore = HKHealthStore()
// MARK: Healthkit read and write values
let healthDataItemsToRead: Set<HKObjectType> = [
HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierStepCount)!,
HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierDistanceWalkingRunning)!,
HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierFlightsClimbed)!
]
let healthDataItemsToWrite: Set<HKSampleType> = [
HKQuantityType.quantityTypeForIdentifier(HKQuantityTypeIdentifierStepCount)!
]
func getHealthAuthorization(completion: (success: Bool, error: NSError?) -> Void) {
// Get authorization to access the data
healthStore.requestAuthorizationToShareTypes(healthDataItemsToWrite, readTypes: healthDataItemsToRead) {
success, error in
completion(success:success, error:error)
}
}
• Pedir autorización para lecura y escritura de datos

33. private func queryDistance(predicate: NSPredicate?, _ sortDescriptor: NSSortDescriptor) {
let distance = HKQuantityType.quantityTypeForIdentifier(HKQuantityTypeIdentifierDistanceWalkingRunning)!
let sumOption = HKStatisticsOptions.CumulativeSum
healthStore.executeQuery(
HKStatisticsQuery(quantityType: distance,
quantitySamplePredicate: predicate,
options: sumOption) { [unowned self] query, result, error in
if let sumQuantity = result?.sumQuantity() {
// do something
}
}
)
}
• Queries

34. We are hiring!
team@decemberlabs.com