HKQuantity

Наследование

NSObject
HKQuantity

NSObject
HKQuantity

Соответствует

Оператор импорта

Swift

import HealthKit

Objective C

@import HealthKit;

Доступность

Доступный в iOS 8.0 и позже.

HealthKit использует объекты количества хранить числовые данные. Количества хранят значение для данного модуля. Можно запросить значение в любых совместимых модулях. Например, если можно создать свойство длины в футах, можно тогда запросить значение в метрах. Объект количества автоматически преобразовывает свое значение в требуемые модули по мере необходимости.

Количества являются неизменными объектами: Когда объект сначала создается и не может измениться, их значения установлены.

Разделение на подклассы примечаний

Как много классов HealthKit, HKQuantity класс не является растяжимым и не должен быть разделен на подклассы. Помочь способствовать совместному использованию данных между приложениями, HKQuantity объекты используют только модули, определенные HKUnit класс.

Создание количеств


    
    init (unit:doubleValue:)
    + quantityWithUnit:doubleValue:

Инстанцирует и возвращает новый объект количества.

Объявление

Swift

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

Objective C

+ (instancetype)quantityWithUnit:(HKUnit *)unit doubleValue:(double)value

Параметры

`unit`	Модули для данного значения. Это определяет набор совместимых модулей. Например, при создании количества с модулем метра это совместимо с любыми другими модулями длины.
`value`	Значение этого количества, измеренное использование параметра модуля.

Возвращаемое значение

Недавно инстанцированный экземпляр количества.

Обсуждение

HealthKit использует объекты количества хранить данные для выборок количества. Для получения дополнительной информации об использовании объектов количества посмотрите Ссылку класса HKQuantitySample.

Оператор импорта

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

Доступный в iOS 8.0 и позже.

Работа с модулями

isCompatibleWithUnit (_:) - isCompatibleWithUnit:

Возвращает булево значение, указывающее, совместимо ли количество с предоставленным модулем.

Объявление

Swift

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

Objective C

- (BOOL)isCompatibleWithUnit:(HKUnit *)unit

Параметры

unit

Целевой модуль.

Возвращаемое значение

Yes если количество совместимо; иначе, NOfalse.

Обсуждение

Отдельные модули совместимы, если они измеряют ту же функцию. Например, все модули длины совместимы. Все массовые модули также совместимы. Однако модуль длины не совместим с массовым модулем.

Если уравнение, определяющее модули, совместимо, комплексные единицы совместимы. В частности это должно использовать тех же операторов, и операнды должны быть совместимыми. Например, метры в секунду и мили в час совместимы. Левые операнды являются оба модулями длины, правильные операнды являются оба единицами измерения времени, и они все используют оператор деления.

Оператор импорта

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

Доступный в iOS 8.0 и позже.


    
    doubleValueForUnit (_:)
    - doubleValueForUnit:

Возвращает значение количества в предоставленном модуле.

Объявление

Swift

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

Objective C

- (double)doubleValueForUnit:(HKUnit *)unit

Параметры


      unit

Целевой модуль. Если количество не совместимо с этим модулем, оно выдает исключение (NSInvalidArgumentException).

Возвращаемое значение

Значение количества в предоставленных модулях.

Обсуждение

Этот метод преобразовывает значение количества в желаемые модули. Вы не должны знать исходные модули количества. Можно запросить значение в любых модулях, которые Вы хотите, пока они совместимы с количеством. Это позволяет каждому приложению (или каждой локали) работа с ее предпочтительными модулями.

В большинстве случаев Вы знаете, какие модули совместимы с данным количеством от контекста. Для наблюдения типов модуля, связанных с различными демонстрационными типами количества, посмотрите идентификаторы типов в Ссылке Констант HealthKit.

Если необходимо программно проверить, совместим ли определенный модуль с определенным количеством, вызовите количество isCompatibleWithUnit: метод.

Оператор импорта

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

Доступный в iOS 8.0 и позже.

См. также

– isCompatibleWithUnit:

Сравнение количеств


    
    выдержите сравнение (_:)
    - выдержите сравнение:

Сравнивает два значения после преобразования их к тем же модулям.

Объявление

Swift

func compare(_ quantity: HKQuantity) -> NSComparisonResult

Objective C

- (NSComparisonResult)compare:(HKQuantity *)quantity

Параметры


      quantity

Количество для сравнения. Этот метод выдает исключение, если количества не имеют совместимых модулей (NSInvalidArgumentException).

Возвращаемое значение

NSOrderedDescending если параметр является меньше, чем получатель. NSOrderedAscending если параметр больше, чем получатель. NSOrderedSame если количества равны.

Обсуждение

Возвраты, являются ли параметром количества меньше, чем, равный, или больше, чем текущее количество. Этот метод автоматически преобразовывает количества в те же модули прежде, чем сравнить значения. Просто необходимо гарантировать, чтобы количества имели совместимые модули.

В большинстве случаев совместимые модули ясны из контекста. Для наблюдения типов модуля, связанных с различными демонстрационными типами количества, посмотрите идентификаторы типов в Ссылке Констант HealthKit.

Оператор импорта

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

Доступный в iOS 8.0 и позже.

См. также

– isCompatibleWithUnit: