定时设置
## 定时设置
定时设置包含：
* Wi-Fi定时开/关设置
* LED灯定时开/关设置(指示灯)
* 效果灯定时开/关设置
导入头文件`#import <H3CMagicKit/H3CGatewayObject+APPGetGwInfo.h`
导入头文件`#import <H3CMagicKit/H3CGatewayObject+AppCtrlGw.h`
### 一、 Wi-Fi定时开关
Wi-Fi定时分为：1、仅支持单时段 2、支持多时段
#### 1.1 Wi-Fi多时段定时开关
* Wi-Fi多时段定时开关
```
[H3CGatewayObject getTimingIntervalsWithControlType:1020]
success:^(id obj) {
}
failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| Wi-Fi多时段控制类型为1020 |
返回数据:
```
{
ctrlMode = 1;
timeRanges = (
{
endHour = 7;
endMin = 0;
startHour = 23;
startMin = 0;
}
);
}
```
| 字段说明|描述|
|-|-|-|
| ctrlMode | 定时的时段是否开启:1、关闭 2、开启 |
| timeRanges | 时段数组，若ctrlMode为1，则数组内时段全部为关闭状态；否则数组内时段全部开启 |
| startHour | 开启时间的时 |
| startMin | 开启时间的分 |
| endHour | 结束时间的时|
| endMin | 结束时间的时|
>w 1、如果支持多时段控制，则不支Wi-Fi单时段定时开关控制；
2、Wi-Fi多时段定时开关功能需要能力集第13位支持
#### 1.2 Wi-Fi多时段定时开关设置
* Wi-Fi多时段定时开关
```
NSArray *timeRanges = @[{@"startHour": @(0),
@"startMin": @(0),
@"endHour": @(22),
@"endMin": @(0)
}];
NSDictionary *attributes = @{@"ctrlMode": @(2),
@"ctrlMode": timeRanges,
};
[H3CGatewayObject setTimingIntervalWithControlType:1020 attributes:attributes success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| Wi-Fi多时段控制类型为1020 |
attributes内部参数与返回结果字段对应。
>w 1、如果支持多时段控制，则不支Wi-Fi单时段定时开关控制；
2、Wi-Fi多时段定时开关功能需要能力集第13位支持
1.3 Wi-Fi单时段定时开关
```
[H3CGatewayObject getTimingIntervalsWithControlType:1007]
success:^(id obj) {
}
failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| Wi-Fi单时段控制类型为1007 |
返回数据:
```
{
ctrlMode = 2;
endHour = 22;
endMin = 0;
startHour = 0;
startMin = 0;
}
```
| 字段说明|描述|
|-|-|-|
| ctrlMode | 定时的时段是否开启:1、关闭 2、开启 |
| startHour | 开启时间的时 |
| startMin | 开启时间的分 |
| endHour | 结束时间的时|
| endMin | 结束时间的时|
>w 1、如果支持多时段控制，则不支Wi-Fi单时段定时开关控制；
2、Wi-Fi单时段定时开关功能需要能力集第26位支持
#### 1.4 设置Wi-Fi单时段定时开关
```
NSDictionary *attributes = @{@"ctrlMode": @(2),
@"startHour": @(0),
@"startMin": @(0),
@"endHour": @(22),
@"endMin": @(0)
};
[H3CGatewayObject setTimingIntervalWithControlType: 1007 attributes:attributes success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| Wi-Fi单时段控制类型为1007 |
attributes内部参数与返回结果字段对应。
>w 1、如果支持多时段控制，则不支Wi-Fi单时段定时开关控制；
2、Wi-Fi单时段定时开关功能需要能力集第26位支持
### 二、 设备睡眠定时开关（仅支持单时段开启）
开启后设备可以进入睡眠状态，一般只有支持存储的设备支持该功能。
>w 设备定时睡眠功能需要能力集15位支持
#### 2.1 设备睡眠定时开启时段
```
[H3CGatewayObject getTimingIntervalsWithControlType:1121]
success:^(id obj) {
}
failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| LED等为1121 |
返回数据:
```
{
ctrlMode = 2;
endHour = 22;
endMin = 0;
startHour = 0;
startMin = 0;
}
```
| 字段说明|描述|
|-|-|-|
| ctrlMode | 定时的时段是否开启:1、关闭 2、开启 |
| startHour | 开启时间的时 |
| startMin | 开启时间的分 |
| endHour | 结束时间的时|
| endMin | 结束时间的时|
#### 1.2 设置设备睡眠定时开启时段
```
NSDictionary *attributes = @{@"ctrlMode": @(2),
@"startHour": @(0),
@"startMin": @(0),
@"endHour": @(22),
@"endMin": @(0)
};
[H3CGatewayObject setTimingIntervalWithControlType:1121 attributes:attributes success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| LED等为1121 |
attributes内部参数返回结果字段对应。
### 三、 LED灯定时开关（仅支持单时段开启）
LED灯是用来标识设备是否有网、是否异常状态的灯。
>w LED定时功能需要能力集14位支持
#### 3.1 获取LED定时开启时段
```
[H3CGatewayObject getTimingIntervalsWithControlType:1008]
success:^(id obj) {
}
failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| LED等为1008 |
返回数据:
```
{
ctrlMode = 2;
endHour = 22;
endMin = 0;
startHour = 0;
startMin = 0;
}
```
| 字段说明|描述|
|-|-|-|
| ctrlMode | 定时的时段是否开启:1、关闭 2、开启 |
| startHour | 开启时间的时 |
| startMin | 开启时间的分 |
| endHour | 结束时间的时|
| endMin | 结束时间的时|
#### 3.2 设置LED定时开启时段
```
NSDictionary *attributes = @{@"ctrlMode": @(2),
@"startHour": @(0),
@"startMin": @(0),
@"endHour": @(22),
@"endMin": @(0)
};
[H3CGatewayObject setTimingIntervalWithControlType:1008 attributes:attributes success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| LED等为1008 |
attributes内部参数返回结果字段对应。
### 四、 效果灯定时开关（仅支持多时段）
效果灯区别于指示灯，效果灯是比较亮的特效大灯，LED指示灯一般是小点灯用于标记路由器的状态。
>w 效果灯定时功能需要能力集35位支持
#### 4.1 获取效果灯定时开启时段
```
[H3CGatewayObject getTimingIntervalsWithControlType: 1025]
success:^(id obj) {
}
failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| LED等为1025 |
返回数据:
```
{
ctrlMode = 2;
endHour = 22;
endMin = 0;
startHour = 0;
startMin = 0;
}
```
| 字段说明|描述|
|-|-|-|
| ctrlMode | 定时的时段是否开启:1、关闭 2、开启 |
| startHour | 开启时间的时 |
| startMin | 开启时间的分 |
| endHour | 结束时间的时|
| endMin | 结束时间的时|
#### 4.2 设置效果灯定时开启时段
```
NSArray *timeRanges = @[{@"startHour": @(0),
@"startMin": @(0),
@"endHour": @(22),
@"endMin": @(0)
}];
NSDictionary *attributes = @{@"ctrlMode": @(2),
@"ctrlMode": timeRanges,
};
[H3CGatewayObject setTimingIntervalWithControlType: 1025 attributes:attributes success:^(id obj) {
} failure:^(H3CError *error) {
}];
```
| 参数说明|描述|
|-|-|-|
|controlType| LED等为1025 |
attributes内部参数返回结果字段对应。
#### 五、 能力集
| 能力集序号|能力集属性|描述|
|-|-|-|
|13| isSupportWiFiTiming | 是否支持WiFi多时段定时关闭|
|14| isSupportLEDTiming | 是否LED定时|
|15| isSupportSleepTiming | 是否睡眠定时关闭|
|26| isSupportWiFiTimingSingle | WiFi单时段定时关闭|
|35| isSupportEffectLEDTiming | 是否支持效果灯多时段定时关闭|