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

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

Разработчик

Ссылка платформы CoreMotion ссылка класса CMStepCounter

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

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

CMStepCounter

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

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

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

Swift

import CoreMotion

Objective C

@import CoreMotion;

Доступность

Доступный в iOS 7.0 и позже.
Осуждаемый в iOS 8.0.

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

Определение доступности подсчета шага
  • isStepCountingAvailable () + isStepCountingAvailable (iOS 8.0)

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

    Объявление

    Swift

    class func isStepCountingAvailable() -> Bool

    Objective C

    + (BOOL)isStepCountingAvailable

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

    YEStrue если неродной подсчет поддержки доступен или NOfalse если это не.

    Обсуждение

    Неродной подсчет поддержки не доступен на всех устройствах на iOS. Используйте этот метод, чтобы определить, доступна ли поддержка на текущем устройстве.

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

    Objective C

    @import CoreMotion;

    Swift

    import CoreMotion

    Доступность

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

    Осуждаемый в iOS 8.0.

Запуск и остановка обновлений подсчета шага
  • startStepCountingUpdatesToQueue (_: updateOn:withHandler:) - startStepCountingUpdatesToQueue:updateOn:withHandler: (iOS 8.0)

    Запускает поставку текущих данных неродного подсчета к Вашему приложению.

    Объявление

    Swift

    func startStepCountingUpdatesToQueue(_ queue: NSOperationQueue!, updateOn stepCounts: Int, withHandler handler: CMStepUpdateHandler!)

    Objective C

    - (void)startStepCountingUpdatesToQueue:(NSOperationQueue *)queue updateOn:(NSInteger)stepCounts withHandler:(CMStepUpdateHandler)handler

    Параметры

    queue

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

    stepCounts

    Число шагов для записи прежде, чем выполниться handler блок. Число шагов должно быть больше, чем 0.

    handler

    Блок для выполнения, когда число шагов было достигнуто или превышено. Для получения информации о параметрах этого блока посмотрите CMStepUpdateHandler. Это свойство не должно быть nil.

    Обсуждение

    Этот метод инициирует отслеживание шагов пользователя и вызывает предоставленный блок периодически для предоставления результатов. Когда Вы вызываете этот метод, сбросы счетчика шага текущее значение количества шага к 0, и начинает рассчитывать. Каждый раз счетчик шага записывает число, вступает stepCounts параметр, это выполняет указанное handler блок. Например, если stepCounts 100, это отправило бы обновления на 100 шагах, 200 шагах, 300 шагах, и т.д. Число шагов, о которых сообщают Вашему обработчику, всегда является общим количеством шагов, так как Вы вызвали этот метод.

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

    Для остановки поставки неродного подсчета обновлений вызовите stopStepCountingUpdates метод. Когда сам объект счетчика шага освобожден, обновления также останавливаются.

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

    Objective C

    @import CoreMotion;

    Swift

    import CoreMotion

    Доступность

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

    Осуждаемый в iOS 8.0.

    См. также

    – stopStepCountingUpdates

  • stopStepCountingUpdates () - stopStepCountingUpdates (iOS 8.0)

    Останавливает поставку неродного подсчета обновлений к Вашему приложению.

    Объявление

    Swift

    func stopStepCountingUpdates()

    Objective C

    - (void)stopStepCountingUpdates

    Обсуждение

    Вызовите этот метод для остановки поставки обновлений, которые Вы запустили путем вызова startStepCountingUpdatesToQueue:updateOn:withHandler: метод. Этот метод не останавливается, запросы начали использовать queryStepCountStartingFrom:to:toQueue:withHandler: метод.

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

    Objective C

    @import CoreMotion;

    Swift

    import CoreMotion

    Доступность

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

    Осуждаемый в iOS 8.0.

    См. также

    – startStepCountingUpdatesToQueue:updateOn:withHandler:

Получение исторических данных подсчета шага
  • queryStepCountStartingFrom (_: to:toQueue:withHandler:) - queryStepCountStartingFrom:to:toQueue:withHandler: (iOS 8.0)

    Собирает и возвращает исторические данные количества шага для указанного периода времени.

    Объявление

    Swift

    func queryStepCountStartingFrom(_ start: NSDate!, to end: NSDate!, toQueue queue: NSOperationQueue!, withHandler handler: CMStepQueryHandler!)

    Objective C

    - (void)queryStepCountStartingFrom:(NSDate *)start to:(NSDate *)end toQueue:(NSOperationQueue *)queue withHandler:(CMStepQueryHandler)handler

    Параметры

    start

    Время начала для использования при сборе шага считает данные. Этот параметр не должен быть nil.

    end

    Время окончания для использования при сборе шага считает данные. Этот параметр не должен быть nil.

    queue

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

    handler

    Блок для выполнения с результатами. Для получения информации о параметрах этого блока посмотрите CMStepQueryHandler. Этот параметр не должен быть nil.

    Обсуждение

    Этот метод работает асинхронно, возвратившись сразу и поставляя результаты к указанному handler блок. Система хранит только ценность прошлых семи дней данных шага самое большее. Если нет никаких выборок для указанного диапазона времени, значение 0 передается handler блок.

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

    Objective C

    @import CoreMotion;

    Swift

    import CoreMotion

    Доступность

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

    Осуждаемый в iOS 8.0.

Типы данных

  • CMStepQueryHandler

    Блок, сообщающий о числе шагов для работы запроса.

    Объявление

    Swift

    typealias CMStepQueryHandler = (Int, NSError!) -> Void

    Objective C

    typedef void (^CMStepQueryHandler)(NSInteger numberOfSteps, NSError *error);

    Обсуждение

    Этот блок берет два параметра:

    numberOfSteps

    Число шагов, произошедших между запуском и время окончания, указанное запросом.

    error

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

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

    Objective C

    @import CoreMotion;

    Swift

    import CoreMotion

    Доступность

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

  • CMStepUpdateHandler

    Блок, сообщающий о числе шагов, зарегистрированных начиная с обновлений, начался.

    Объявление

    Swift

    typealias CMStepUpdateHandler = (Int, NSDate!, NSError!) -> Void

    Objective C

    typedef void (^CMStepUpdateHandler)(NSInteger numberOfSteps, NSDate *timestamp, NSError *error);

    Обсуждение

    Этот блок берет следующие параметры:

    numberOfSteps

    Общее количество шагов начиная с startStepCountingUpdatesToQueue:updateOn:withHandler: метод вызвали.

    timestamp

    Время, в которое сообщили о текущем количестве шага.

    error

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

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

    Objective C

    @import CoreMotion;

    Swift

    import CoreMotion

    Доступность

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