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

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

Разработчик

Ссылка платформы HomeKit ссылка класса HMTimerTrigger

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

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

HMTimerTrigger

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

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

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

Swift

import HomeKit

Objective C

@import HomeKit;

Доступность

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

HMTimerTrigger объект представляет триггер на основе периодических таймеров.

Когда с помощью триггер таймера включают enable:completionHandler:, системные проверки, чтобы проверить, что дата огня триггера таймера, часовой пояс и правила повторения приводят к следующей дате огня, которая находится в будущем.

Управление триггерами таймера
  • init (name:fireDate:timeZone:recurrence:recurrenceCalendar:) - initWithName:fireDate:timeZone:recurrence:recurrenceCalendar: Определяемый инициализатор

    Инициализирует триггер таймера с указанной информацией синхронизации.

    Объявление

    Swift

    init!(name name: String!, fireDate fireDate: NSDate!, timeZone timeZone: NSTimeZone!, recurrence recurrence: NSDateComponents!, recurrenceCalendar recurrenceCalendar: NSCalendar!)

    Objective C

    - (instancetype)initWithName:(NSString *)name fireDate:(NSDate *)fireDate timeZone:(NSTimeZone *)timeZone recurrence:(NSDateComponents *)recurrence recurrenceCalendar:(NSCalendar *)recurrenceCalendar

    Параметры

    name

    Имя триггера таймера.

    fireDate

    Первая дата огня.

    timeZone

    Часовой пояс для первой даты огня. Передача nil использовать часовой пояс по умолчанию. Посмотрите timeZone для описания того, как интерпретируется часовой пояс.

    recurrence

    Интервал повторения, в который можно запустить триггер. nil указывает разовый триггер.

    recurrenceCalendar

    Календарь, в котором можно оценить интервал повторения триггера таймера. Может быть nil, когда текущий календарь (currentCalendar) используется.

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

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

    Обсуждение

    Новый триггер таймера начинается отключенный и должен быть включен с помощью enable:completionHandler: перед использованием.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • fireDate Свойство

    Время, в которое затем выстрелит триггер. (только для чтения)

    Объявление

    Swift

    @NSCopying var fireDate: NSDate! { get }

    Objective C

    @property(readonly, copy, nonatomic) NSDate *fireDate

    Обсуждение

    Триггеры таймера только установлены в начале минуты. Секунды не используются, и ошибка будет возвращена, если дата огня будет включать значение секунд кроме 0. Когда таймер будет стрелять, он будет обычно стрелять в течение 1 минуты после запланированной даты огня или вычисленной даты огня повторения, в зависимости от питания системы и управления ресурсами.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • updateFireDate (_: completionHandler:) - updateFireDate:completionHandler:

    Обновляет следующую дату огня триггера.

    Объявление

    Swift

    func updateFireDate(_ fireDate: NSDate!, completionHandler completion: ((NSError!) -> Void)!)

    Objective C

    - (void)updateFireDate:(NSDate *)fireDate completionHandler:(void (^)(NSError *error))completion

    Параметры

    fireDate

    Новая дата огня.

    completion

    Блок выполнился после того, как запрос обрабатывается.

    error

    nil на успехе; иначе, ошибочный объект указание причины отказа.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • recurrence Свойство

    Интервал, в который можно повторить увольнение триггера. (только для чтения)

    Объявление

    Swift

    @NSCopying var recurrence: NSDateComponents! { get }

    Objective C

    @property(readonly, copy, nonatomic) NSDateComponents *recurrence

    Обсуждение

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

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

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

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • updateRecurrence (_: completionHandler:) - updateRecurrence:completionHandler:

    Обновляет интервал повторения.

    Объявление

    Swift

    func updateRecurrence(_ recurrence: NSDateComponents!, completionHandler completion: ((NSError!) -> Void)!)

    Objective C

    - (void)updateRecurrence:(NSDateComponents *)recurrence completionHandler:(void (^)(NSError *error))completion

    Параметры

    recurrence

    Новый интервал повторения.

    completion

    Блок выполнился после того, как запрос обрабатывается.

    error

    nil на успехе; иначе, ошибочный объект указание причины отказа.

    Обсуждение

    Посмотрите recurrence для обсуждения того, как используется значение повторения.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • recurrenceCalendar Свойство

    Календарь, в котором оценено значение повторения. (только для чтения)

    Объявление

    Swift

    @NSCopying var recurrenceCalendar: NSCalendar! { get }

    Objective C

    @property(readonly, copy, nonatomic) NSCalendar *recurrenceCalendar

    Обсуждение

    Посмотрите recurrence для обсуждения того, как используются значение повторения и календарь повторения.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • timeZone Свойство

    Часовой пояс, в котором можно оценить время огня. (только для чтения)

    Объявление

    Swift

    @NSCopying var timeZone: NSTimeZone! { get }

    Objective C

    @property(readonly, copy, nonatomic) NSTimeZone *timeZone

    Обсуждение

    Если это значение nil, если пользователь изменит часовые пояса, время огня триггера останется в то же относительное время. Если это значение будет установлено в определенное значение, то время огня триггера всегда будет тем же абсолютным временем, как оценено в том часовом поясе. Общая ценность для установки этого в является часовым поясом, где физически расположены аксессуары. Это приведет к триггеру, стреляющему в определенное время суток в том расположении, независимо от того, где расположено устройство на iOS.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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

  • updateTimeZone (_: completionHandler:) - updateTimeZone:completionHandler:

    Обновляет часовой пояс триггера.

    Объявление

    Swift

    func updateTimeZone(_ timeZone: NSTimeZone!, completionHandler completion: ((NSError!) -> Void)!)

    Objective C

    - (void)updateTimeZone:(NSTimeZone *)timeZone completionHandler:(void (^)(NSError *error))completion

    Параметры

    timeZone

    Новый часовой пояс; может быть nil.

    completion

    Блок выполнился после того, как запрос обрабатывается.

    error

    nil на успехе; иначе, ошибочный объект указание причины отказа.

    Обсуждение

    Посмотрите timeZone для описания того, как интерпретируется часовой пояс.

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

    Objective C

    @import HomeKit;

    Swift

    import HomeKit

    Доступность

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