HKQuantitySample

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

NSObject
HKObject
HKSample
HKQuantitySample

NSObject
HKObject
HKSample
HKQuantitySample

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

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

Swift

import HealthKit

Objective C

@import HealthKit;

Доступность

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

HKQuantitySample класс является конкретным подклассом HKSample класс. HealthKit использует выборки количества для представления данных с помощью единственного числового значения. HealthKit обеспечивает широкий диапазон типов количества, позволяя Вам отследить много различных функций здоровья и пригодности.

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

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

Как много классов HealthKit, HKQuantitySample класс не должен быть разделен на подклассы.

Можно расшириться HKQuantitySample класс путем добавления метаданных с пользовательскими ключами как подходящих для приложения. Для получения дополнительной информации посмотрите quantitySampleWithType:quantity:startDate:endDate:metadata:.

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


    
    init (type:quantity:startDate:endDate:)
    + quantitySampleWithType:quantity:startDate:endDate:

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

Объявление

Swift

convenience init!(type quantityType: HKQuantityType!, quantity quantity: HKQuantity!, startDate startDate: NSDate!, endDate endDate: NSDate!)

Objective C

+ (instancetype)quantitySampleWithType:(HKQuantityType *)quantityType quantity:(HKQuantity *)quantity startDate:(NSDate *)startDate endDate:(NSDate *)endDate

Параметры

`quantityType`	Тип количества используется для этой выборки.
`quantity`	Выборка типа. Количество должно использовать модули, которые совместимы с предоставленным типом количества. Если модули не совместимы, этот метод выдает исключение (`NSInvalidArgumentException`).
`startDate`	Дата начала выборки. Эта дата должна быть равна или ранее, чем дата окончания; иначе, этот метод выдает исключение (`NSInvalidArgumentException`).
`endDate`	Дата окончания выборки. Эта дата должна быть равна или позже, чем дата начала; иначе, этот метод выдает исключение (`NSInvalidArgumentException`).

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

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

Обсуждение

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

Swift

let quantityType =
HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierHeartRate)
let bpm = HKUnit(fromString: "count/min")
let quantity = HKQuantity(unit: bpm, doubleValue: 72.0)
let quantitySample = HKQuantitySample(type: quantityType,
quantity: quantity,
startDate: start,
endDate: end)

Objective C

HKQuantityType *quantityType =
[HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierHeartRate];
HKUnit *bpm = [HKUnit unitFromString:@"count/min"];
HKQuantity *quantity = [HKQuantity quantityWithUnit:bpm
doubleValue:72.0];
HKQuantitySample *sample =
[HKQuantitySample quantitySampleWithType:quantityType
quantity:quantity
startDate:start
endDate:end];

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

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

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

См. также

+ quantitySampleWithType:quantity:startDate:endDate:metadata:
+ quantityTypeForIdentifier:
quantityType
количество
startDate
endDate


    
    init (type:quantity:startDate:endDate:metadata:)
    + quantitySampleWithType:quantity:startDate:endDate:metadata:

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

Объявление

Swift

convenience init!(type quantityType: HKQuantityType!, quantity quantity: HKQuantity!, startDate startDate: NSDate!, endDate endDate: NSDate!, metadata metadata: [NSObject : AnyObject]!)

Objective C

+ (instancetype)quantitySampleWithType:(HKQuantityType *)quantityType quantity:(HKQuantity *)quantity startDate:(NSDate *)startDate endDate:(NSDate *)endDate metadata:(NSDictionary *)metadata

Параметры

`quantityType`	Тип количества используется для этой выборки.
`quantity`	Количество для этой выборки. Количество должно использовать модули, которые совместимы с предоставленным типом количества. Если модули не совместимы, этот метод выдает исключение (`NSInvalidArgumentException`).
`startDate`	Дата начала выборки. Эта дата должна быть равна или ранее, чем дата окончания; иначе, этот метод выдает исключение (`NSInvalidArgumentException`).
`endDate`	Дата окончания выборки. Эта дата должна быть равна или позже, чем дата начала; иначе, этот метод выдает исключение (`NSInvalidArgumentException`).
`metadata`	Словарь метаданных содержит дополнительную информацию, описывающую эту выборку. Ключи словаря - все `NSString` объекты. Значения могут быть `NSString` объекты, `NSNumber` объекты, или `NSDate` объекты. Для полного списка предопределенных ключей метаданных посмотрите Ключи Метаданных. Используя предопределенные ключи помогает упростить совместное использование данных между приложениями; однако, Вы также призваны создать свои собственные, пользовательские ключи по мере необходимости для расширения возможностей выборки количества HealthKit.

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

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

Обсуждение

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

Swift

let metadata = [HKMetadataKeyUDIDeviceIdentifier:UDIDeviceIdentifier,
HKMetadataKeyUDIProductionIdentifier:UDIProductionIdentifier,
HKMetadataKeyDigitalSignature:digitalSignature,
HKMetadataKeyTimeZone:timeZone]
let quantityType =
HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierHeartRate)
let bpm = HKUnit(fromString: "count/min")
let quantity = HKQuantity(unit: bpm, doubleValue: 72.0)
let quantitySample = HKQuantitySample(type: quantityType,
quantity: quantity,
startDate: start,
endDate: end,
metadata: metadata)

Objective C

NSDictionary *metadata =
@{HKMetadataKeyUDIDeviceIdentifier:UDIDeviceIdentifier,
HKMetadataKeyUDIProductionIdentifier:UDIProductionIdentifier,
HKMetadataKeyDigitalSignature:digitalSignature,
HKMetadataKeyTimeZone:timeZone};
HKQuantityType *quantityType =
[HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierHeartRate];
HKUnit *bpm = [HKUnit unitFromString:@"count/min"];
HKQuantity *quantity = [HKQuantity quantityWithUnit:bpm
doubleValue:72.0];
HKQuantitySample *sample =
[HKQuantitySample quantitySampleWithType:quantityType
quantity:quantity
startDate:start
endDate:end
metadata:metadata];

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

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

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

См. также

+ quantitySampleWithType:quantity:startDate:endDate:
+ quantityTypeForIdentifier:
quantityType
количество
startDate
endDate
метаданные

Получение данных свойства

quantity Свойство

Количество для этой выборки. (только для чтения)

Объявление

Swift

var quantity: HKQuantity! { get }

Objective C

@property(readonly, strong) HKQuantity *quantity

Обсуждение

Для наблюдения типа модулей, совместимых с этим количеством, ищите идентификатор типа количества выборки в Ссылке Констант HealthKit.

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

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

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

Тип количества для этой выборки. (только для чтения)

Объявление

Swift

var quantityType: HKQuantityType! { get }

Objective C

@property(readonly, strong) HKQuantityType *quantityType

Обсуждение

Это свойство содержит ссылку на sampleType свойство, снятое как HKQuantityType объект.

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

Objective C

@import HealthKit;

Swift

import HealthKit

Доступность

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

Константы

Ключи предиката количества
Константы, которые могут использоваться для создания строк формата предиката.

Объявление

Swift

let HKPredicateKeyPathQuantity: String

Objective C

NSString * const HKPredicateKeyPathQuantity

Константы
- HKPredicateKeyPathQuantity
  
  Ключевой путь к количеству выборки.
  
  Эта константа обеспечивает ключевой путь к количеству выборки. Используйте эту константу каждый раз, когда Вы хотите включать количество выборки в строку формата предиката. Добавьте «%K» заполнителя к строке формата, и затем передайте эту константу как параметр.
  
  Также используйте predicateForQuantitySamplesWithOperatorType:quantity: метод для создания предикатов, соответствующих количество выборки.
  
  Доступный в iOS 8.0 и позже.