Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка платформы HealthKit ссылка класса HKStatistics

Опции
Развертывание Target:

На этой странице
Язык:

HKStatistics

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

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

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

Swift

import HealthKit

Objective C

@import HealthKit;

Доступность

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

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

По умолчанию эти запросы автоматически объединяют данные от всех Ваших источников данных прежде, чем выполнить вычисления. Если Вы хотите объединить данные сами, можно установить HKStatisticsOptionSeparateBySource опция. Можно тогда запросить статистические данные для каждого источника отдельно.

Запрашивая данные от объекта статистики, Ваш запрос должен соответствовать опции, которые Вы использовали при создании запроса. Например, если Вы создаете запрос с помощью HKStatisticsOptionDiscreteAverage опция, необходимо получить доступ к результатам с помощью averageQuantity метод.

Для получения дополнительной информации о вычислении статистических данных посмотрите HKStatisticsQuery Ссылка класса. Для вычисления статистики по серии временных интервалов посмотрите HKStatisticsCollectionQuery Ссылка класса.

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

    Запуск периода времени включен в эти статистические данные. (только для чтения)

    Объявление

    Swift

    var startDate: NSDate! { get }

    Objective C

    @property(readonly, strong) NSDate *startDate

    Обсуждение

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

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    endDate

  • endDate Свойство

    Конец периода времени включен в эти статистические данные. (только для чтения)

    Объявление

    Swift

    var endDate: NSDate! { get }

    Objective C

    @property(readonly, strong) NSDate *endDate

    Обсуждение

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

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    startDate

  • quantityType Свойство

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

    Объявление

    Swift

    var quantityType: HKQuantityType! { get }

    Objective C

    @property(readonly, strong) HKQuantityType *quantityType

    Обсуждение

    Тип количества из запроса статистики раньше генерировал эти статистические данные.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

  • sources Свойство

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

    Объявление

    Swift

    var sources: [AnyObject]! { get }

    Objective C

    @property(readonly, strong) NSArray *sources

    Обсуждение

    Если HKStatisticsOptionSeparateBySource опция была указана, это свойство содержит массив всех источников, включенных в вычисления. Если HKStatisticsOptionSeparateBySource опция не была указана, свойство содержит nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

Получение данных статистики
  • averageQuantity () - averageQuantity

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

    Объявление

    Swift

    func averageQuantity() -> HKQuantity!

    Objective C

    - (HKQuantity *)averageQuantity

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

    Если HKStatisticsOptionDiscreteAverage опция была установлена, этот метод возвращает объект количества, содержащий среднее значение всех выборок, соответствующих запрос; иначе, это возвращается nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – averageQuantityForSource:
    startDate
    endDate

  • averageQuantityForSource (_:) - averageQuantityForSource:

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

    Объявление

    Swift

    func averageQuantityForSource(_ source: HKSource!) -> HKQuantity!

    Objective C

    - (HKQuantity *)averageQuantityForSource:(HKSource *)source

    Параметры

    source

    Источник данных от объекта статистики sources массив.

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

    Если оба HKStatisticsOptionDiscreteAverage опция и HKStatisticsOptionSeparateBySource опция была установлена, этот метод возвращает объект количества. Этот объект содержит среднее значение от всех выборок, соответствующих запрос и создававшихся указанным источником. Если опции статистики не были оба установлены, этот метод возвраты nil

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – averageQuantity
    startDate
    endDate
    источники

  • maximumQuantity () - maximumQuantity

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

    Объявление

    Swift

    func maximumQuantity() -> HKQuantity!

    Objective C

    - (HKQuantity *)maximumQuantity

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

    Если HKStatisticsOptionDiscreteMax опция была установлена, этот метод возвращает объект количества, содержащий максимальное значение от всех выборок, соответствующих запрос; иначе, это возвращается nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – maximumQuantityForSource:
    startDate
    endDate

  • maximumQuantityForSource (_:) - maximumQuantityForSource:

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

    Объявление

    Swift

    func maximumQuantityForSource(_ source: HKSource!) -> HKQuantity!

    Objective C

    - (HKQuantity *)maximumQuantityForSource:(HKSource *)source

    Параметры

    source

    Источник данных от объекта статистики sources массив.

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

    Если оба HKStatisticsOptionDiscreteMax опция и HKStatisticsOptionSeparateBySource опция была установлена, этот метод возвращает объект количества. Этот объект содержит максимальное значение от всех выборок, соответствующих запрос и создававшихся указанным источником. Если опции статистики не были оба установлены, этот метод возвраты nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – maximumQuantity
    startDate
    endDate
    источники

  • minimumQuantity () - minimumQuantity

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

    Объявление

    Swift

    func minimumQuantity() -> HKQuantity!

    Objective C

    - (HKQuantity *)minimumQuantity

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

    Если HKStatisticsOptionDiscreteMin опция была установлена, этот метод возвращает объект количества, содержащий минимальное значение от всех выборок, соответствующих запрос; иначе, это возвращается nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – minimumQuantityForSource:
    startDate
    endDate

  • minimumQuantityForSource (_:) - minimumQuantityForSource:

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

    Объявление

    Swift

    func minimumQuantityForSource(_ source: HKSource!) -> HKQuantity!

    Objective C

    - (HKQuantity *)minimumQuantityForSource:(HKSource *)source

    Параметры

    source

    Источник данных от объекта статистики sources массив.

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

    Если оба HKStatisticsOptionDiscreteMin опция и HKStatisticsOptionSeparateBySource опция была установлена, этот метод возвращает объект количества. Этот объект содержит минимальное значение от всех выборок, соответствующих запрос и создававшихся указанным источником. Если опции статистики не были оба установлены, этот метод возвраты nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – minimumQuantity
    startDate
    endDate
    источники

  • sumQuantity () - sumQuantity

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

    Объявление

    Swift

    func sumQuantity() -> HKQuantity!

    Objective C

    - (HKQuantity *)sumQuantity

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

    Если HKStatisticsOptionCumulativeSum опция была установлена, этот метод возвращает объект количества, содержащий минимальное значение от всех выборок, соответствующих запрос; иначе, это возвращается nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – sumQuantityForSource:
    startDate
    endDate

  • sumQuantityForSource (_:) - sumQuantityForSource:

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

    Объявление

    Swift

    func sumQuantityForSource(_ source: HKSource!) -> HKQuantity!

    Objective C

    - (HKQuantity *)sumQuantityForSource:(HKSource *)source

    Параметры

    source

    Источник данных от объекта статистики sources массив.

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

    Если оба HKStatisticsOptionCumulativeSum опция и HKStatisticsOptionSeparateBySource опция была установлена, этот метод возвращает объект количества. Этот объект содержит сумму всех выборок, соответствующих запрос и создававшихся указанным источником. Если опции статистики не были оба установлены, этот метод возвраты nil.

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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

    См. также

    – sumQuantity
    startDate
    endDate
    источники

Константы
  • HKStatisticsOptions

    Опции для указания, который статистика вычислить.

    Объявление

    Swift

    struct HKStatisticsOptions : RawOptionSetType { init(_ rawValue: UInt) init(rawValue rawValue: UInt) static var None: HKStatisticsOptions { get } static var SeparateBySource: HKStatisticsOptions { get } static var DiscreteAverage: HKStatisticsOptions { get } static var DiscreteMin: HKStatisticsOptions { get } static var DiscreteMax: HKStatisticsOptions { get } static var CumulativeSum: HKStatisticsOptions { get } }

    Objective C

    typedef enum : NSUInteger { HKStatisticsOptionNone = 0, HKStatisticsOptionSeparateBySource = 1 << 0, HKStatisticsOptionDiscreteAverage = 1 << 1, HKStatisticsOptionDiscreteMin = 1 << 2, HKStatisticsOptionDiscreteMax = 1 << 3, HKStatisticsOptionCumulativeSum = 1 << 4, } HKStatisticsOptions;

    Константы

    • None

      HKStatisticsOptionNone

      Опция, указывающая, что система не вычислит значений статистики.

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

    • SeparateBySource

      HKStatisticsOptionSeparateBySource

      Опция, указывающая, что указанная статистика будет вычислена отдельно для каждого источника.

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

    • DiscreteAverage

      HKStatisticsOptionDiscreteAverage

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

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

    • DiscreteMin

      HKStatisticsOptionDiscreteMin

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

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

    • DiscreteMax

      HKStatisticsOptionDiscreteMax

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

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

    • CumulativeSum

      HKStatisticsOptionCumulativeSum

      Опция, указывающая, что система вычислит сумму всех количеств для выборок.

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

    Обсуждение

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

    Swift

    • let cumulativeActiveEnergyBurned =
    • HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierActiveEnergyBurned)
    • let discreteHeartRate =
    • HKObjectType.quantityTypeForIdentifier(HKQuantityTypeIdentifierHeartRate)
    • // Cannot combine cumulative options with discrete options.
    • // However, you can combine a cumulative option and seperated by source
    • let cumulativeQuery = HKStatisticsQuery(quantityType:cumulativeActiveEnergyBurned,
    • quantitySamplePredicate:nil,
    • options: .CumulativeSum | .SeparateBySource) {
    • query, statistics, error in
    • // ... process the results here
    • }
    • // You can also combine any number of discrete options
    • // and the seperated by source option.
    • let discreteQuery = HKStatisticsQuery(quantityType: discreteHeartRate,
    • quantitySamplePredicate: nil,
    • options: .DiscreteAverage | .DiscreteMin |
    • .DiscreteMax | .SeparateBySource) {
    • query, statistics, error in
    • // ... process the results here
    • }

    Objective C

    • HKQuantityType *cumulativeActiveEnergyBurned =
    • [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierActiveEnergyBurned];
    • HKQuantityType *discreteHeartRate =
    • [HKObjectType quantityTypeForIdentifier:HKQuantityTypeIdentifierHeartRate];
    • // Cannot combine cumulative options with discrete options.
    • // However, you can combine a cumulative option and seperated by source
    • HKStatisticsQuery *cumulativeQuery =
    • [[HKStatisticsQuery alloc]
    • initWithQuantityType:cumulativeActiveEnergyBurned
    • quantitySamplePredicate:nil
    • options:HKStatisticsOptionCumulativeSum | HKStatisticsOptionSeparateBySource
    • completionHandler:^(HKStatisticsQuery *query, HKStatistics *result, NSError *error) {
    • // ... process the results here
    • }];
    • // You can also combine any number of discrete options
    • // and the seperated by source option.
    • HKStatisticsQuery *discreteQuery =
    • [[HKStatisticsQuery alloc]
    • initWithQuantityType:discreteHeartRate
    • quantitySamplePredicate:nil
    • options:HKStatisticsOptionDiscreteAverage | HKStatisticsOptionDiscreteMin |
    • HKStatisticsOptionDiscreteMax | HKStatisticsOptionSeparateBySource
    • completionHandler:^(HKStatisticsQuery *query, HKStatistics *result, NSError *error) {
    • // ... process the results here
    • }];

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

    Objective C

    @import HealthKit;

    Swift

    import HealthKit

    Доступность

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