您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

ResearchKit 官方文檔詳解:創建調查(Surveys)

編輯:iOS 開發基礎

本文翻譯自蘋果官方文檔,譯者:@星夜暮晨、@有情況_R。調查任務(Survey Task)是表示一系列問題的步驟對象(ORKStep)集合,例如「您正在服用何種藥物?」或「您昨晚睡了幾個小時?」。你可以收集單個步驟的調查結果,也可以收集整個任務的結果。創建用以展示調查的任務,步驟為:創建一個或多個步驟、創建任務、收集調查結果。

1. 創建步驟

調查模塊不僅提供只包含一個問題的問題步驟(ORKQuestionStep),還提供可包含多個項目的表單步驟(ORKFormStep);此外還可使用指示步驟(ORKInstructionStep)介紹調查信息或提供指示。每個步驟都有自己的步驟視圖控制器,定義展示該類步驟的界面。任務視圖控制器展示步驟時會實例化合適的步驟視圖控制器。如有必要,可通過實現 ORKTaskViewControllerDelegate 委托方法自定義步驟視圖控制器的細節,如按鈕標題與風格。

指示步驟

指示步驟用以說明任務目的並提供指示,ORKInstructionStep 包含標識符、標題、文本、詳情文本與一張圖片。它不收集數據,但仍會生成一個空的 ORKStepResult 來記錄指示顯示的時間。

將此步驟置入任務並展示,會產生如下效果:

問題步驟

問題步驟(ORKQuestionStep)代表一個簡單問題,由簡短的 title 與更詳細的 text 組成,可通過設置回答格式配置用戶可輸入的數據類型,並可通過 optional 屬性允許用戶跳過問題。對於數字和文本格式,placeholder 屬性可在輸入框中給出提示。問題步驟會生成一個 ORKQuestionResult 子類來報告用戶的回答。

將問題步驟添加到任務並展示,會生成如下屏幕:

表單步驟

當用戶需同時回答多個相互關聯的問題時,最好使用表單步驟(ORKFormStep),將它們集中在一個頁面展示。表單步驟可包含多個項目(ORKFormItem),每個項目都能有自己的回答格式;也可通過一個僅含標題的「虛擬」表單項目構成多個章節。表單步驟的結果與問題步驟類似,只是每個表單項目中都包含問題結果,可用表單項目的 identifier 屬性獲取相應結果。

以下代碼展示了如何創建一個包含基礎問題、並用 HealthKit 默認值填充輸入框的表單:

ORKFormStep *step = [[ORKFormStep alloc] initWithIdentifier:kFormIdentifier title:@"表單" text:@"單頁展示含有多個輸入框的表單組"]; NSMutableArray *items = [NSMutableArray new]; ORKAnswerFormat *genderFormat = [ORKHealthKitCharacteristicTypeAnswerFormat answerFormatWithCharacteristicType: [HKCharacteristicType characteristicTypeForIdentifier:HKCharacteristicTypeIdentifierBiologicalSex]]; [items addObject: [[ORKFormItem alloc] initWithIdentifier:kGenderItemIdentifier text:@"性別" answerFormat:genderFormat]]; [items addObject: [[ORKFormItem alloc] initWithSectionTitle:@"基本信息"]]; ORKAnswerFormat *bloodTypeFormat = [ORKHealthKitCharacteristicTypeAnswerFormat answerFormatWithCharacteristicType: [HKCharacteristicType characteristicTypeForIdentifier:HKCharacteristicTypeIdentifierBloodType]]; [items addObject: [[ORKFormItem alloc] initWithIdentifier:kBloodTypeItemIdentifier text:@"血型" answerFormat:bloodTypeFormat]]; ORKAnswerFormat *dateOfBirthFormat = [ORKHealthKitCharacteristicTypeAnswerFormat answerFormatWithCharacteristicType: [HKCharacteristicType characteristicTypeForIdentifier:HKCharacteristicTypeIdentifierDateOfBirth]]; ORKFormItem *dateOfBirthItem = [[ORKFormItem alloc] initWithIdentifier:kDateOfBirthItemIdentifier text:@"出生日期" answerFormat:dateOfBirthFormat]; dateOfBirthItem.placeholder = @"出生日期"; [items addObject:dateOfBirthItem]; step.formItems = items;

上述代碼會生成類似以下的界面:

回答格式

在 ResearchKit 中,回答格式(Answer Format)決定了用戶應如何回答問題或表單項目。例如「從 1 到 10,您感受到的疼痛是多少?」這類問題,可用標度回答格式(ORKScaleAnswerFormat)並設置 minimum 與 maximum 屬性來獲得所需范圍。下方截圖展示了框架提供的標準回答格式:

此外,框架還提供特殊回答格式,用於詢問用戶可能已存儲在「健康」應用中的數據或體征。使用 HealthKit 回答格式時,任務視圖控制器會自動彈出健康數據訪問請求窗口(若尚未獲授權),並在獲授權後自動從健康數據庫填充當前值。

2. 創建調查任務

創建完一個或多個步驟後,創建 ORKOrderedTask 對象持有這些步驟。以下代碼展示了將一個是非步驟添加到任務的過程:

// 創建一個准備包含在任務當中的是非步驟 ORKStep *booleanStep = [[ORKQuestionStep alloc] initWithIdentifier:kNutritionIdentifier]; booleanStep.title = @"您是否在服用保健品?"; booleanStep.answerFormat = [ORKBooleanAnswerFormat new]; booleanStep.optional = NO; // 創建一個含有此步驟的任務 ORKOrderedTask *task = [[ORKOrderedTask alloc] initWithIdentifier:kTaskIdentifier steps:@[booleanStep]];

你必須為每個步驟設置唯一的字符串標識符,因為它是將任務層次中的步驟與結果層次中的步驟結果連接起來的關鍵。要展示任務,將其賦給任務視圖控制器並展示:

ORKTaskViewController *taskViewController = [[ORKTaskViewController alloc] initWithTask:task taskRunUUID:nil]; taskViewController.delegate = self; [self presentViewController:taskViewController animated:YES completion:nil];

注意:ORKOrderedTask 假定始終展示所有問題,不會根據上一題的回答決定下一題。若要引入條件邏輯,需繼承 ORKOrderedTask 或自行實現 ORKTask 協議。

3. 收集結果

任務視圖控制器的 result 屬性返回任務結果。每個用戶查看的步驟視圖控制器都會生成一個步驟結果(ORKStepResult),用戶前往下一步時,任務視圖控制器會收集這些結果並生成 ORKTaskResult。任務結果與步驟結果都是結果的集合,可包含其他結果對象。結果類型取決於步驟類型:問題步驟生成 ORKQuestionResult,表單步驟為每個表單項目生成問題結果,帶記錄器的活動任務通常為每個記錄器生成結果。

結果的層級與任務、步驟的輸入模型層級非常契合:

每個結果都包含一個標識符(用於連接結果與生成它的模型對象),以及 startDate 與 endDate(可用於推斷用戶回答該步驟花費的時間)。

決定下一個步驟的步驟結果

有時在展示下一步前需知曉當前步驟的結果。例如某步驟詢問「您當前有發熱症狀麼?」,若回答「是」,下一題可能是「您當前的體溫是多少?」,否則可能是「您還有其他的健康問題嗎?」。要增加自定義條件行為,可使用有序任務(ORKOrderedTask)或可導航的有序任務(ORKNavigableOrderedTask),重載 stepAfterStep:withResult、stepBeforeStep:withResult: 等方法(需調用 super)。

有序任務:諸如調查或活動任務之類的順序(靜態)任務可用有序任務表示。以下例子演示如何繼承 ORKOrderedTask,根據用戶對是非問題的回答提供不同步驟集:

- (ORKStep*)stepAfterStep:(ORKStep*)step withResult:(id)result{ NSString *identifier = step.identifier; if ([identifier isEqualToString:self.qualificationStep.identifier]) { ORKStepResult *stepResult = [result stepResultForStepIdentifier:identifier]; ORKQuestionResult *result = (ORKQuestionResult *)stepResult.firstResult; if ([result isKindOfClass:[ORKBooleanQuestionResult class]]) { ORKBooleanQuestionResult *booleanResult = result; NSNumber *booleanAnswer = booleanResult.booleanAnswer; if (booleanAnswer) { return booleanAnswer.boolValue ? self.regularQuestionStep : self.terminationStep; } } } return [super stepAfterStep:step withResult:result]; }

可導航的有序任務(ORKNavigableOrderedTask)從有序任務繼承行為,並額外提供根據回答展示不同步驟組的功能。當用戶在不同步驟間導航時,可通過添加條件步驟導航規則來控制流向;同一個步驟不能添加多個導航規則,若添加多個,最新的規則會替代其他規則。例如可用 ORKPredicateStepNavigationRule 根據回答顯示調查問題,或用 ORKDirectStepNavigationRule 定義隨機跳轉。以下例子演示如何添加導航規則,在用戶未選擇「頭痛」時前往「其他症狀」步驟:

ORKNavigableOrderedTask *task = [[ORKNavigableOrderedTask alloc] initWithIdentifier:StepNavigationTaskIdentifier steps:steps]; ORKPredicateStepNavigationRule *predicateRule = nil; NSPredicate *predicateHeadache = [ORKResultPredicate predicateForChoiceQuestionResultWithResultIdentifier:@"symptom" expectedString:@"headache"]; NSPredicate *predicateNotHeadache = [NSCompoundPredicate notPredicateWithSubpredicate:predicateHeadache]; predicateRule = [[ORKPredicateStepNavigationRule alloc] initWithResultPredicates:@[ predicateNotHeadache ] destinationStepIdentifiers:@[ @"other_symptom" ]]; [task setNavigationRule:predicateRule forTriggerStepIdentifier:@"symptom"];

在任務完成後存儲結果

任務完成後可將結果存儲或上傳,方式包括將結果層級序列化、使用內置的 NSSecureCoding 支持,或採用應用支持的其他格式化方式。若任務能生成文件輸出,文件通常會被 ORKFileResult 對象引用,並放置於任務視圖控制器設置的輸出目錄中。以下示例中,任務成功完成後結果會通過 NSKeyedArchiver 歸檔,同時演示了如何獲取恢復數據:

- (void)taskViewController:(ORKTaskViewController *)taskViewController didFinishWithReason:(ORKTaskViewControllerFinishReason)reason error:(NSError *)error { switch (reason) { case ORKTaskViewControllerFinishReasonCompleted: { // 首先將結果對象進行歸檔 NSData *data = [NSKeyedArchiver archivedDataWithRootObject:taskViewController.result]; // 將數據存儲在硬盤上進行文件保護,或者安全地上傳到遠程服務器 break; } case ORKTaskViewControllerFinishReasonFailed: case ORKTaskViewControllerFinishReasonDiscarded: // 通常而言,應當丟棄該結果,考慮清除輸出目錄的內容 break; case ORKTaskViewControllerFinishReasonSaved: { NSData *data = [taskViewController restorationData]; // 持續存儲恢復的數據,以便之後可以使用 break; } } }
  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved