群组控制

组合群组控制是指对该组合群组下的设备进行总控的一种功能。目前，支持的控制功能为开关、亮度、模式和色温等。ThingSmartPackedGroup 类的以下属性可以获取当前组合群组的状态。

ThingSmartPackedGroup 数据模型

字段	类型	描述
dps	NSDictionary	功能点（DP）数据
switchStatus	BOOL	开关状态
sceneStatus	NSString	场景模式 THING_LIGHTING_SCENE_WORK：工作 THING_LIGHTING_SCENE_MEETING：会议 THING_LIGHTING_SCENE_SIESTA：午休 THING_LIGHTING_SCENE_OFF_DUTY：下班
workModel	NSString	工作模式 THING_LIGHTING_MODE_WHITE：白光 THING_LIGHTING_MODE_COLOUR：彩光 THING_LIGHTING_MODE_SCENE：场景
brightPercent	NSInteger	当前亮度，范围 0 到 100
temperaturePercent	NSInteger	当前色温，范围 0 到 100
colorData	NSString	彩光数据。该操作仅当组合群组处在彩光模式下有效，返回值为 12 位的组合数据，组合的规则为 hhhhssssvvvv，其中 hhhh 表示 16 进制后的色调值 ssss 表示 16 进制后的饱和度值 vvvv 表示 16 进制后的亮度值 可使用 ThingLightingColorUtil 的 decodeNewHsvWithHsvString 方法将 colorData 解码成 HSV 的值

组合群组 DP 命令下发

接口说明

- (void)publishDps:(NSDictionary *)dps
           success:(nullable ThingSuccessHandler)success
           failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
dps	组合群组 DP 集合
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishDps:@{@"1" : @"1"} success:^(void) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置组合群组快捷开关

接口说明

- (void)publishSwitchStauts:(BOOL)switchValue
                    success:(nullable ThingSuccessID)success
                    failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
switchStatus	开关状态
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishSwitchStatus:YES success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置场景模式

接口说明

该操作仅当组合群组处在场景模式下有效。

- (void)publishSceneStatus:(NSString *)sceneId
                   success:(nullable ThingSuccessID)success
                   failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
sceneId	场景 ID THING_LIGHTING_SCENE_WORK：工作 THING_LIGHTING_SCENE_MEETING：会议 THING_LIGHTING_SCENE_SIESTA：午休 THING_LIGHTING_SCENE_OFF_DUTY：下班
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishSceneStatus:THING_LIGHTING_SCENE_WORK success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置工作模式

接口说明

- (void)publishWorkMode:(NSString *)workMode
                success:(nullable ThingSuccessID)success
                failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
workMode	工作模式 THING_LIGHTING_MODE_WHITE：白光 THING_LIGHTING_MODE_COLOUR：彩光 THING_LIGHTING_MODE_SCENE：场景
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishWorkMode:THING_LIGHTING_MODE_WHITE success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置亮度

接口说明

该操作仅当组合群组处在白光模式下有效。

- (void)publishBrightPercent:(NSInteger)brightPercent
                     success:(nullable ThingSuccessID)success
                     failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
brightPercent	亮度，范围 0 到 100
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishBrightPercent:100 success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置色温

接口说明

该操作仅当组合群组处在白光模式下有效。

- (void)publishTemperaturePercent:(NSInteger)temperaturePercent
                          success:(nullable ThingSuccessID)success
                          failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
TemperaturePercent	色温，范围 0 到 100
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishTemperaturePercent:100 success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置亮度和色温

接口说明

该操作仅当组合群组处在白光模式下有效。

- (void)publishBrightPercent:(NSInteger)brightPercent
          temperaturePercent:(NSInteger)temperaturePercent
                     success:(nullable ThingSuccessID)success
                     failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
brightPercent	亮度，范围 0 到 100
temperaturePercent	色温，范围 0 到 100
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishBrightPercent:100 temperaturePercent:100 success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];

设置彩光

接口说明

该操作仅当组合群组处在彩光模式下有效，colors 为 HSV 编码后的字符串，可使用 ThingLightingAreaHelper 的 encodeNewHsvWithHue:saturation:brightness: 方法将 HSV 值编码成 colorData。

- (void)publishColors:(NSString *)colors
              success:(nullable ThingSuccessID)success
              failure:(nullable ThingFailureError)failure;

参数说明

参数	说明
colors	彩光
success	成功回调
failure	失败回调

示例代码

Objective-C：

[self.packedGroup publishColors:@"" success:^(id result) {
    NSLog(@"success");
} failure:^(NSError *error){
    NSLog(@"failure");
}];