HealthKit開發快速入門教程之HealthKit資料的操作

資料的表示

在HealthKit中，資料是最核心的元素。透過分析資料，人們可以看到相關的健康資訊。例如，透過統計步數資料，人們可以知道一天走的步數。本章將主要講解HealthKit資料構成的方式，以及如何規範的表達一個資料。

 資料的操作

在HealthKit中，資料都是與單位和值組成的，如圖2.1所示。此圖為一個睡眠分析的截圖。在此圖中59m就代表了一個資料。其中m為單位，59為基於單位的數值。本節將講解資料的建立、判斷、比較以及獲取等內容。

圖2.1  睡眠分析

2.1.1  建立資料

在HealthKit中資料都是由單位和值構成的。在使用資料之前，首先需要對資料進行建立。本小節將講解資料建立的兩個步驟：建立單位和建立基於單位的資料。

1.建立單位

在HealthKit中，為了讓資料具有實際物理意義，所以需要為資料中的值指定單位。HKUnit提供了便捷方法來建立HealthKit支援的所有基本單位。HKUnit是一個類。當我們要具體的使用它時，就需要對其進行例項化。例項化HKUnit需要使用到init(fromString:)方法。它可以用來對單位進行建立，並且此單位有一個描述性的字串，其語法形式如下：

convenience init!(fromString string: String!)

其中，string是一個字串，用來代表單位。此字串必須要符合HealthKit所支援的所有基本單位。Healthkit所支援的基本單位如附錄B所示。

【示例2-1：HKUnit-init】下面建立一個以米為單位的物件。程式碼如下：

此時執行程式，會看到如下的效果。

2.建立基於單位的資料

HKQuantity類儲存了給定單位的值，此值和單位就構成了資料。和HKUnit類一樣，在使用它時，需要進行例項化。例項化HKQuantity需要使用到init(unit:doubleValue:)方法。它可以用來建立一個quantity（數量）物件。其語法形式如下：

其中，unit用來指定一個單位物件；value用來指定基於單位的值，它是一個雙精度型別的資料。

【示例2-2：HKQuantity-init】下面表示某一個人在一段時間內所走的路程。程式碼如下：

此時執行程式，會看到如下的效果。

2.1.2  判斷、比較資料

比較和判斷是資料處理的基本操作。例如，透過比較的操作，可以讓使用者找出一組資料的最大值。本小節將詳細講解資料的判斷以及比較。

1.判斷單位是否為空

很多的單位有如m/s的情況，如果當兩個單位一樣時，此單位就會抵消，變為一個空的單位。為了避免這種情況的發生，HealthKit提供了一個isNull()方法。此方法用來判斷建立的單位是否為空，其語法形式如下：

其中，該方法的返回值型別為布林型別。當Bool為true時，表示建立的單位為空；當Bool為false時，表示建立的單位不為空。

【示例2-3：HKUnit-isNull】下面判斷給定的單位是否為空。程式碼如下：

此時執行程式，會看到如下的效果。

2.判斷資料的相容性

同型別單位和單位之間是可以進行轉換的，如以米為單位的資料和釐米為單位的資料，以千克為單位的資料和以克為單位的資料等。而相容性就是用來判斷資料和提供的單位之間是否可以進行轉換。在HealthKit中isCompatibleWithUnit(_:)方法可以用來對資料的相容性進行判斷，其語法形式如下：

其中，unit用來指定一個單位物件。該方法的返回值型別為布林型別。當Bool為true時，表示quantity物件和提供的單位相相容；當Bool為false時，表示quantity物件和提供的單位不相容。

【示例2-4：HKQuantity-isCompatibleWithUnit】判斷某人行走的路程是否可以與給定的單位進行轉換。程式碼如下：

此時執行程式，會看到如下的效果。

3.比較資料

同簡單的數值一樣，資料也可以進行比較的。在HealthKit中提供了compare(_:)方法，可以實現資料的比較功能，其語法形式如下：

func compare(_ quantity: HKQuantity!) -> NSComparisonResult

其中，quantity用來指定一個數量物件。該方法的返回值型別為NSComparisonResult列舉型別，其語法形式如下：

其中，OrderedAscending表示左邊的資料小於右邊的資料；OrderedSame表示兩個資料相等；OrderedDescending表示右邊的資料小於左邊的資料。

【示例2-5：HKQuantity-compare】下面對一個人4天的行走距離進行比較。程式碼如下：

此時執行程式，會看到如下的效果。

獲取資料

由於資料是由單位和數值組成的。有的時候，需要單獨獲取單位和數值。本小節將主要講解這兩個功能。

1.獲取單位

在建立單位時，我們提到了init(fromString:)方法，它可以用來對單位進行建立，並且此單位有一個描述性的字串，unitString屬性的功能就是用來獲取這個描述性的字串。其語法形式如下：

【示例2-6：HKUnit-unitString】建立一個單位，並獲取單位中描述性的字串。程式碼如下：

此時執行程式，會看到如下的效果。

2.獲取基於單位的值

有時我們只想檢視資料中的數值，而不是整個資料，需要使用到doubleValueForUnit(_:)方法。其語法形式如下：

其中，unit用來指定一個單位物件。該方法的返回值型別為雙精度型別。

【示例2-7：HKQuantity-doubleValueForUnit】獲取不同單位資料中的值。程式碼如下：

此時執行程式，會看到如下的效果。