HealthKit开发快速入门教程之HealthKit数据的操作

数据的表示

在HealthKit中，数据是最核心的元素。通过分析数据，人们可以看到相关的健康信息。例如，通过统计步数数据，人们可以知道一天走的步数。本章将主要讲解HealthKit数据构成的方式，以及如何规范的表达一个数据。

2.1  数据的操作

在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】下面创建一个以米为单位的对象。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
• var myunit=HKUnit(fromString: "m")                                                       //创建单位对象
• println(myunit)
• }
• ……
• }

此时运行程序，会看到如下的效果。

• m

2.创建基于单位的数据

HKQuantity类存储了给定单位的值，此值和单位就构成了数据。和HKUnit类一样，在使用它时，需要进行实例化。实例化HKQuantity需要使用到init(unit:doubleValue:)方法。它可以用来创建一个quantity（数量）对象。其语法形式如下：

• convenience init!(unit unit: HKUnit!,
• doubleValue value: Double)

其中，unit用来指定一个单位对象；value用来指定基于单位的值，它是一个双精度类型的数据。

【示例2-2：HKQuantity-init】下面表示某一个人在一段时间内所走的路程。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
• var myunit=HKUnit(fromString: "km")                                                //创建长度单位
• var mydistance=HKQuantity(unit: myunit, doubleValue: 10)    //创建长度数据对象
• println("一段时间后，某人行走的路程为：\(mydistance)")
• }
• ……
• }

此时运行程序，会看到如下的效果。

• 一段时间后，某人行走的路程为：10 km

2.1.2  判断、比较数据

比较和判断是数据处理的基本操作。例如，通过比较的操作，可以让用户找出一组数据的最大值。本小节将详细讲解数据的判断以及比较。

1.判断单位是否为空

很多的单位有如m/s的情况，如果当两个单位一样时，此单位就会抵消，变为一个空的单位。为了避免这种情况的发生，HealthKit提供了一个isNull()方法。此方法用来判断创建的单位是否为空，其语法形式如下：

• func isNull() -> Bool

其中，该方法的返回值类型为布尔类型。当Bool为true时，表示创建的单位为空；当Bool为false时，表示创建的单位不为空。

【示例2-3：HKUnit-isNull】下面判断给定的单位是否为空。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
• var unit1:HKUnit=HKUnit(fromString: "m/m")
• //判断
•  if((unit1.isNull()) == true){
•             println("unit1对象为空")
•         }else{
•             println("unit1对象不为空")
•         }
• var unit2=HKUnit(fromString: "m/s")
• //判断
•  if((unit2.isNull()) == true){
•             println("unit2对象为空")
•         }else{
•             println("unit2对象不为空")
•         }
• }
• ……
• }

此时运行程序，会看到如下的效果。

• unit1对象为空
• unit2对象不为空

2.判断数据的兼容性

同类型单位和单位之间是可以进行转换的，如以米为单位的数据和厘米为单位的数据，以千克为单位的数据和以克为单位的数据等。而兼容性就是用来判断数据和提供的单位之间是否可以进行转换。在HealthKit中isCompatibleWithUnit(_:)方法可以用来对数据的兼容性进行判断，其语法形式如下：

• func isCompatibleWithUnit(_ unit: HKUnit!) -> Bool

其中，unit用来指定一个单位对象。该方法的返回值类型为布尔类型。当Bool为true时，表示quantity对象和提供的单位相兼容；当Bool为false时，表示quantity对象和提供的单位不兼容。

【示例2-4：HKQuantity-isCompatibleWithUnit】判断某人行走的路程是否可以与给定的单位进行转换。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
• var unit1=HKUnit(fromString: "km")                                                   //创建一个长度单位
• var distance=HKQuantity(unit: unit1, doubleValue: 10)                          //创建一个长度数据对象
• var unit2=HKUnit(fromString: "m")                                                     //创建第二个长度单位
• //判断兼容
•   if(distance.isCompatibleWithUnit(unit2)){
•             println("distance与unit2兼容")
•         }else{
•             println("distance与unit2不兼容")
•         }
• var unit3=HKUnit(fromString: "s")                                                                //创建一个时间单位
• //判断兼容
•   if(distance.isCompatibleWithUnit(unit3)){
•             println("distance与unit3兼容")
•         }else{
•             println("distance与unit3不兼容")
•         }
• ……
• }

此时运行程序，会看到如下的效果。

• distance与unit2兼容
• distance与unit3不兼容

3.比较数据

同简单的数值一样，数据也可以进行比较的。在HealthKit中提供了compare(_:)方法，可以实现数据的比较功能，其语法形式如下：

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

其中，quantity用来指定一个数量对象。该方法的返回值类型为NSComparisonResult枚举类型，其语法形式如下：

• enum NSComparisonResult : Int {
• case OrderedAscending
• case OrderedSame
• case OrderedDescending
• }

其中，OrderedAscending表示左边的数据小于右边的数据；OrderedSame表示两个数据相等；OrderedDescending表示右边的数据小于左边的数据。

【示例2-5：HKQuantity-compare】下面对一个人4天的行走距离进行比较。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
• var unit1=HKUnit(fromString: "km")                                                   //创建一个千米单位
• var distance1=HKQuantity(unit: unit1, doubleValue: 10)               //创建第一天行走距离对象
• var unit2=HKUnit(fromString: "m")                                                     //创建一个米单位
• var distance2=HKQuantity(unit: unit2, doubleValue: 10000)                 //创建第二天行走距离对象
• var distance3=HKQuantity(unit: unit2, doubleValue: 10)               //创建第三天行走距离对象
• var distance4=HKQuantity(unit: unit2, doubleValue: 500)            //创建第四天行走距离对象
• //比较大小
•  if(distance1.compare(distance2)==NSComparisonResult.OrderedSame){
•             println("两天所走的路程一样")
•         }
• //比较大小
•   if(distance3.compare(distance2)==NSComparisonResult.OrderedAscending){
•             println("第2天走的要比第3天走的要多")
•         }
• //比较大小
•  if(distance4.compare(distance3)==NSComparisonResult.OrderedDescending){
•             println("第3天走的要比第4天走的要少")
•         }
• }
• ……
• }

此时运行程序，会看到如下的效果。

• 两天所走的路程一样
• 第2天走的要比第3天走的要多
• 第3天走的要比第4天走的要少

2.1.3  获取数据

由于数据是由单位和数值组成的。有的时候，需要单独获取单位和数值。本小节将主要讲解这两个功能。

1.获取单位

在创建单位时，我们提到了init(fromString:)方法，它可以用来对单位进行创建，并且此单位有一个描述性的字符串，unitString属性的功能就是用来获取这个描述性的字符串。其语法形式如下：

• var unitString: String! { get }

【示例2-6：HKUnit-unitString】创建一个单位，并获取单位中描述性的字符串。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
•  var unit=HKUnit(fromString: "km")
•         println(unit.unitString)                                                                //获取字符串
• }
• ……
• }

此时运行程序，会看到如下的效果。

• km

2.获取基于单位的值

有时我们只想查看数据中的数值，而不是整个数据，需要使用到doubleValueForUnit(_:)方法。其语法形式如下：

• func doubleValueForUnit(_ unit: HKUnit!) -> Double

其中，unit用来指定一个单位对象。该方法的返回值类型为双精度类型。

【示例2-7：HKQuantity-doubleValueForUnit】获取不同单位数据中的值。代码如下：

• import UIKit
• import HealthKit
• class ViewController: UIViewController {
• override func viewDidLoad() {
• super.viewDidLoad()
• // Do any additional setup after loading the view, typically from a nib.
• var unit1=HKUnit(fromString: "km")                                                   //创建一个千米单位
• var distance=HKQuantity(unit: unit1, doubleValue: 10)                          //创建一个长度数据对象
•  println(distance.doubleValueForUnit(unit1))                                 //获取数值
• var unit2=HKUnit(fromString: "m")                                                     //创建一个米单位
• println(distance.doubleValueForUnit(unit2))                                 //获取基于米单位的数值
• }
• ……
• }

此时运行程序，会看到如下的效果。

• 10.0
• 10000.0

本文选自：HealthKit开发快速入门教程大学霸资料，转载请注明出处，尊重技术尊重IT人！