
本文翻譯自蘋果官方文檔,譯者:@星夜暮晨、@有情況_R。活動任務讓用戶在半受控的環境下執行特定動作,此時 iPhone 的傳感器會被用來收集數據。例如,一個用於分析步態與平衡的活動任務,可能會要求用戶走上幾步,同時由 iPhone 的加速度傳感器記錄相應的樣本數據。
當前版本中,ResearchKit 框架包含五個預定義任務,可歸納為四大類:活動、健康、認知與聲音。下表總結了各個任務及其所收集的數據。

實例化預定義活動任務時,可以通過組合 ORKPredefinedTaskOption 常量來禁用某些默認包含的完成步驟。其他選項標志還可用於排除研究中不需要的特定類型數據。例如,若用戶需執行健康任務但不需要心率數據,可使用 ORKPredefinedTaskOptionExcludeHeartrate。
在健康任務中(ORKOrderedTask fitnessCheckTaskWithIdentifier:intendedUseDescription:walkDuration:restDuration:options),用戶行走一段特定時間(通常幾分鐘),傳感器數據通過任務視圖控制器的委托收集並返回,一般包括加速計、設備運動、計步器、位置數據,若可用還有心率數據。走路活動末期,若心率數據仍可有效收集,用戶會被要求坐下休息一段時間,數據收集會在此期間繼續進行。
以下屏幕截圖說明了健康任務的樣子:

所有數據都由 iOS 公開的 CoreMotion 與 HealthKit API 收集,並序列化成 JSON 格式。ResearchKit 框架本身不對數據進行分析。
在音頻任務中(ORKOrderedTask audioTaskWithIdentifier:intendedUseDescription:speechInstruction:shortSpeechInstruction:duration:recordingSettings:options),用戶先發出可識別的聲音,隨後一段音頻會被記錄下來。框架使用 AVFoundation 收集數據並在錄音過程中給出相關指示,但不進行任何音頻分析與處理,你可按需求自行定義音頻的處理方式。
以下截屏是音頻任務的例子:


在步行與平衡任務中(ORKOrderedTask shortWalkTaskWithIdentifier:intendedUseDescription:numberOfStepsPerLeg:restDuration:options),用戶在室內走一小段距離。這種半受控任務可用於收集步長、腳步平滑度、走路搖晃程度等客觀數據。
以下屏幕截圖是步行與平衡任務的例子:



在輕拍任務中(ORKOrderedTask twoFingerTappingIntervalTaskWithIdentifier:intendedUseDescription:duration:options),用戶快速交替地在觸摸屏上輕拍兩個目標。觸摸結果數據可用於評定速度、準確性與節奏等基礎運動能力。觸摸數據及來自 CoreMotion 的加速計數據均由公共 API 收集,框架不進行數據分析。
以下屏幕截圖是輕拍速度任務的例子:


在空間記憶任務中(ORKOrderedTask spatialSpanMemoryTaskWithIdentifier:intendedUseDescription:initialSpan:minimumSpan:maximumSpan:playSpeed:maxTests:maxConsecutiveFailures:customTargetImage:customTargetPluralName:requireReversal:options),用戶被要求觀察並回憶一系列遊戲中的持續時間段(如環境)。任務會收集可用於估算視覺空間與執行功能的數據。序列長度會在任務中自動變化:成功後增長、失敗後下降,並維持在 minimumSpan 與 maximumSpan 之間。playSpeed 可控制序列播放速度,customTargetImage 可自定義目標形狀,遊戲在達到 maxTests 次測試或連續 maxConsecutiveFailures 次錯誤時結束。
以下屏幕截圖是空間記憶任務的例子:



在 PSAT 任務中(ORKOrderedTask PSATTaskWithIdentifier:intendedUseDescription:presentationMode:interStimulusInterval:stimulusDuration:seriesLength:options),一個數字每隔 2-3 秒出現在屏幕上,用戶必須將每個新出現的數字與前一個相加。PSAT 可用於評估聽力與視覺信息處理速度、靈活度及計算能力,得分從幾個候選答案中選出正確的和,結果以 ORKPSATResult 對象表示。
以下屏幕截圖是 PSAT 任務的例子(視覺與聽覺部分是可選的):


在反應時間任務中(ORKOrderedTask reactionTimeTaskWithIdentifier:intendedUseDescription:maximumStimulusInterval:minimumStimulusInterval:thresholdAcceleration:numberOfAttempts:timeout:successSound:timeoutSound:failureSound:option),用戶被要求搖晃或移動設備以響應屏幕上的可視化信號。任務分為若干次完成,每次需用大於 thresholdAcceleration 預設值的加速度在規定時間內搖晃設備,全部成功後結束。該任務用於評估用戶對刺激的反應並計算反應時間。
以下屏幕截圖表現了反應時間任務的例子:


在測音任務中(ORKOrderedTask toneAudiometryTaskWithIdentifier:intendedUseDescription:speechInstruction:shortSpeechInstruction:toneDuration:options),用戶佩戴耳機聆聽不同音頻、不同聲道(左/右)的聲音,聲音會在不斷增強的過程中持續,直到用戶按下對應按鈕。測音任務基於用戶對廣范圍音頻的反應來測量其不同方面的聽音能力,收集的數據由特定音頻與聲道的聲音信號振幅組成。
以下屏幕截圖表現了測音任務:


在漢諾塔任務中(ORKOrderedTask towerOfHanoiTaskWithIdentifier:intendedUseDescription:numberOfDisks:options),用戶被要求用最少的移動次數解決傳統漢諾塔問題——將整疊圓盤移動到高亮平台上。該任務用於測量用戶的問題解決技巧,在用戶成功解決或承認無法解決時結束,結果以 ORKTowerOfHanoiResult 對象表示,包含每次移動記錄及問題是否解決的標記。
以下屏幕截圖是漢諾塔任務的例子:


在計時步行任務中(ORKOrderedTask timedWalkTaskWithIdentifier:intendedUseDescription:distanceInMeters:timeLimit:options),用戶被要求快速而安全地走完一段特定長度的路程,若反方向再走相同距離,任務會重新激活。與健康任務和短距離行走任務不同,計時步行強調行走的固定距離,用於測量用戶的下肢功能。收集的數據包括加速計、設備運動、計步器及位置(位置需用戶授權),結果以 ORKTimedWalkResult 對象表示。
以下屏幕截圖是計時步行的例子:



活動任務中的數據收集被記錄在內存中的 ORKResult 對象層次裡,由你決定如何序列化存儲或傳送。若數據過大無法在內存中傳送,可改用 ORKFileResult 對象,將數據直接寫入 ORKTaskViewController 的 outputDirectory 輸出目錄中的文件。推薦做法是每次任務創建一個新目錄,處理完結果後再刪除該目錄。
活躍步驟支持附加記錄結構(ORKRecorderConfiguration),它定義了應從傳感器或設備數據庫以何種間隔收集何種數據類型,例如:
計步器傳感器返回 CMPedometerData 對象,提供由協處理器計算的步數。
加速度計傳感器返回 CMAccelerometerData 對象,提供設備所受力大小的數據。
融合加速度計、陀螺儀與磁力計的設備運動返回 CMDeviceMotion 對象,提供設備方位與運動信息。
HealthKit 返回多種類型,如心率。
CoreLocation 返回融合 GPS、Wi-Fi 與信號基站的位置信息。
ResearchKit 預定義活躍任務所用的記錄器在寫入內置存儲時使用 NSFileProtectionCompleteUnlessOpen,並在記錄結束時將文件保護層級改為 NSFileProtectionComplete。
你也可以通過自定義 ORKActiveStep 與 ORKActiveStepViewController 來創建自己的活躍任務,並參考框架中已有的預定義任務進行設計。此外,一些通用步驟也很有幫助,例如 ORKCountdownStep 呈現帶動畫的倒計時器,ORKCompletionStep 則表示任務結束。
