更新时间:2024-03-21 05:50:19下载pdf
区域群控是指对该区域下的设备进行总控的一种功能,目前支持的空间总控功能为开关、亮度、模式、色温等。ThingLightingArea
类的以下属性可以查询当前区域的状态。
ThingLightingArea
数据模型
字段 | 类型 | 描述 |
---|---|---|
dps | NSDictionary | 功能点数据 |
switchStatus | BOOL | 开关状态 |
sceneStatus | NSString | 场景模式
|
workModel | NSString | 工作模式
|
brightPercent | NSInteger | 当前亮度,范围 0 到 100 |
temperaturePercent | NSInteger | 当前色温,范围 0 到 100 |
colorData | NSString | 彩光数据,该操作仅当区域处在彩光模式下有效。返回值为 12 位的组合数据,组合的规则为 hhhhssssvvvv ,其中
ThingLightingColorUtil 的 decodeNewHsvWithHsvString 方法将 colorData 解码成 HSV 的值。 |
接口说明
- (void)publishDps:(NSDictionary *)dps
success:(nullable ThingSuccessHandler)success
failure:(nullable ThingFailureError)failure;
参数说明
参数 | 说明 |
---|---|
dps | 区域 DP 集合 |
success | 成功回调 |
failure | 失败回调 |
示例代码
Objective-C:
[self.area 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.area 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,包含以下值:
|
success | 成功回调 |
failure | 失败回调 |
示例代码
Objective-C:
[self.area 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 | 工作模式
|
success | 成功回调 |
failure | 失败回调 |
示例代码
Objective-C:
[self.area 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.area 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.area 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.area 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.area publishColors:@"" success:^(id result) {
NSLog(@"success");
} failure:^(NSError *error){
NSLog(@"failure");
}];
该内容对您有帮助吗?
是意见反馈该内容对您有帮助吗?
是意见反馈