创建动作集和触发器

创建动作集和触发器

一个动作集合 HMActionSet 和触发器 HMTimerTrigger 允许你同时控制多个智能电器。比如，一个动作集合可能会在用户上床休息之前执行一组动作 HMAction。一个写动作向一个特性写入了值。动作集合中的动作是以不确定的顺序执行的。一个触发器会在一个特定的时间出发一个动作集并可以重复执行。每一个动作集合在一个家庭中都有唯一的名称并可被 Siri 识别。

创建写入动作

写入动作会向一个服务的特性写入值并被加入到动作集合中去。HMAction 类是 HMCharacteristicWriteAction 具体类的抽象基类。一个动作有一个相关联的特性对象，你可以通过 Accessing Services and Characteristics 中描述的来获取相关的服务和特性，然后创建这个 HMCharacteristicWriteAction。

为了创建一个动作，我们使用 HMCharacteristicWriteAction类中的initWithCharacteristic:targetValue:方法。

HMCharacteristicWriteAction *action = [[HMCharacteristicWriteAction alloc] initWithCharacteristic:characteristic targetValue:value];

在你的代码中，你使用对应的特性的期望来替换 value 参数，并使用对应的 HMCharacteristic 对象来替换 characteristic 参数。

创建并执行动作集

一个动作集就是一个共同执行的动作的集合。比如一个夜间动作集合可能包含关闭电灯，调低恒温水平和锁上房门。

为了创建一个动作集我们使用 addActionSetWithName:completionHandler:异步方法。

[self.home addActionSetWithName:@"NightTime" completionHandler:^(HMActionSet *actionSet, NSError *error) {
    if (error == nil) {
        // 成功添加了一个动作集
    } else {
        // 添加一个动作集失败
    }
}];

为了添加一个动作到动作集，我们使用 addAction:completionHandler:异步方法。

[actionSet addAction:action completionHandler:^(NSError *error) {
    if (error == nil) {
        // 成功添加了一个动作到动作集
    } else {
    // 添加一个动作到动作集失败
    }
}];

想要移除一个动作，可使用 removeAction:completionHandler:方法。

想要执行一个动作集，可使用 HMHome 类的 executeActionSet:completionHandler:方法。比如，用户希望控制所有的节日彩灯。我们就创建一个动作集来打开所有的节日彩灯，另外一个动作集来关闭所有的节日彩灯。为了打开所有的节日彩灯，发送executeActionSet:completionHandler:消息给 home 对象，并传递”打开节日彩灯”动作集。

创建并开启触发器

触发器会执行一个或多个动作集。iOS会在后台管理和运行你的触发器。HMTrigger 类是 HMTimerTrigger 具体类的抽象类。当你创建一个定时触发器时，你需要指定触发时间和触发的周期。创建并开启一个定时触发器需要多个步骤来完成。

遵循下面几步来创建并启动一个定时触发器

创建一个定时触发器

1.创建定时触发器。

self.trigger = [[HMTimerTrigger alloc] initWithName:name
fireDate:fireDate
timeZone:niL
recurrence:nil
recurrenceCalendar:nil];

触发时间必须设置在将来的某个时刻，第二个参数必须为 0。如果你设置了一个周期，周期的最小值是 5 分钟，最大值是 5周。关于如何使用NSDateComponents和NSCalendar来设置周期，请阅读Date and Time Programming Guide

2.添加一个动作集到触发器。

使用 HMTrigger 基类方法 addActionSet:completionHandler:，来添加一个动作集到触发器。

3.添加一个触发器到家庭。

使用 HMHome 类中的addTrigger:completionHandler:方法来添加一个触发器到家庭。

4.启动触发器。

新创建的触发器默认是未启动的。需要使用 enable:complationHandler:方法启动触发器。

一个定时触发器被启动后，会周期性的运行它的动作集。