设备控制

随着 IoT 设备的普及，如何安全、灵活地管理对设备的控制权限变得更加复杂。在以往简单的应用场景中，控制端 App 仅仅需要对一个设备进行控制。但随着家庭拥有的物联网设备愈加丰富，控制端 App 需要同时控制多个设备。

另外，某些终端设备还需要提供给多人控制。例如家具式的智能排插能够支持被所有的家人打开或者关闭，因此就出现一个控制端 App 能够控制多个设备端，或者多个用户能够相互控制多个设备的权限管理问题。由此出现了群组管理，智能场景等概念。

此章节介绍了关于设备控制的内容。

设备功能

• ThingSmartDeviceModel 类的 dps 属性（NSDictionary 类型）定义了当前设备的状态，称作数据点（DP，Data Point）或功能点。

• dps 字典里的每个 key 对应一个设备功能的 dpId，value 对应一个设备功能的 dpValue ，dpValue 为该设备功能的值。

  一款产品的设备功能定义可以在 涂鸦开发者平台 上查看。如下图：

  

  更多详情，请参考 产品功能。

指令格式

发送控制指令按照以下格式：

{
    "(dpId)":"(dpValue)"
}

假设您在涂鸦开发者平台上，查看到一款灯具产品的设备功能有 1、4、5、6、15。其示例代码可能为：

Objective-C：

- (void)publishDps {
    // self.device = [ThingSmartDevice deviceWithDeviceId:@"your_device_id"];

    NSDictionary *dps;
    // 设置 dpId 为 1 的布尔型设备功能示例，作用：开关打开
    dps = @{@"1": @(YES)};

    // 设置 dpId 为 4 的字符串型设备功能示例，作用：设置 RGB 颜色为 ff5500
    dps = @{@"4": @"ff5500"};

    // 设置 dpId 为 5 的枚举型设备功能示例，作用：设置档位为 2 档
    dps = @{@"5": @"2"};

    // 设置 dpId 为 6 的数值型设备功能示例，作用：设置温度为 20°
    dps = @{@"6": @(20)};

    // 设置 dpId 为 15 的透传型（byte 数组）设备功能示例，作用：透传红外数据为 1122
    dps = @{@"15": @"1122"};

    // 多个功能合并发送
    dps = @{@"1": @(YES), @"4": @(ff5500)};

    [self.device publishDps:dps success:^{
        NSLog(@"publishDps success");

        // 下发成功，状态上报通过 deviceDpsUpdate 方法回调

    } failure:^(NSError *error) {
        NSLog(@"publishDps failure: %@", error);
    }];

}

Swift：

func publishDps() {
    var dps = [String : Any]()

    // DP 可参考具体产品定义
    device?.publishDps(dps, success: {
         print("publishDps success")

        //下发成功，状态上报通过 deviceDpsUpdate 方法 回调
    }, failure: { (error) in
        if let e = error {
            print("publishDps failure: \(e)")
        }
    })
}

设备控制

设备控制接口功能为向设备发送 DP，来改变设备状态或功能。

设备控制支持自动选择通道、局域网控制、云端控制这三种控制通道，通常来说建议使用自动选择通道的方式。

• 局域网控制：

  仅通过局域网控制，需要设备局域网在线。

  [self.device publishDps:dps mode:ThingDevicePublishModeLocal success:^{
      NSLog(@"publishDps success");
  } failure:^(NSError *error) {
      NSLog(@"publishDps failure: %@", error);
  }];
  

• 云端控制：

  仅通过云端控制，需要设备云端在线。

  [self.device publishDps:dps mode:ThingDevicePublishModeInternet success:^{
      NSLog(@"publishDps success");
  } failure:^(NSError *error) {
      NSLog(@"publishDps failure: %@", error);
  }];
  

• 自动选择通道控制：

  根据设备模型 ThingSmartDeviceModel 的 communication.communicationModes 顺序来依次检查通道是否可用，自动选择合适的通道进行控制。

  [self.device publishDps:dps success:^{
      NSLog(@"publishDps success");
  } failure:^(NSError *error) {
      NSLog(@"publishDps failure: %@", error);
  }];
  
  // or use
  
  [self.device publishDps:dps mode:ThingDevicePublishModeAuto success:^{
      NSLog(@"publishDps success");
  } failure:^(NSError *error) {
      NSLog(@"publishDps failure: %@", error);
  }];