1. 摄像设备功能点

涂鸦智能设备通过设备功能点来控制设备，并且通过标准化的功能点实现设备与 App 之间的交互。Camera SDK 基于 自定义设备控制 封装了一套智能摄像机的扩展功能。

类和协议

1.1. 设备控制

1.1.1. 获取对象

接口说明

初始化

- (instancetype)initWithDeviceId:(NSString *)devId;

参数说明

接口说明

添加和移除设备状态监听代理

/// 添加设备状态变化监听
- (void)addObserver:(id<TuyaSmartCameraDPObserver>)observer;

/// 移除设备状态变化监听
- (void)removeObserver:(id<TuyaSmartCameraDPObserver>)observer;

参数说明

1.1.2. 状态查询

接口说明

判断设备是否支持某个功能点

- (BOOL)isSupportDP:(TuyaSmartCameraDPKey)dpName;

参数说明

返回值

接口说明

查询设备功能点的值，直接获取缓存中的值，如果不支持此功能点，返回 nil

- (id)valueForDP:(TuyaSmartCameraDPKey)dpName;

参数说明

返回值

接口说明

异步查询设备功能点的值，除了存储卡相关功能外，不建议使用

- (void)valueForDP:(TuyaSmartCameraDPKey)dpName success:(TYSuccessID)success failure:(TYFailureError)failure;

参数说明

1.1.3. 数据下发

接口说明

设置设备功能点的值

- (void)setValue:(id)value forDP:(TuyaSmartCameraDPKey)dpName success:(TYSuccessID)success failure:(TYFailureError)failure;

参数说明

除了部分存储卡状态的功能点，摄像机在功能点状态变化时，会主动上报到云端，Camera SDK 会实时更新设备功能点状态缓存，所以大部分情况下，直接获取缓存中功能点的值就可以了。

异步查询功能点的值，是下发NULL到设备端，正常情况下，设备端收到NULL的功能点数据后，会主动上报一次对应功能点的值。但是这个行为是由摄像机厂商实现的，有些厂商没有处理这个逻辑，所以下发NULL后，会导致摄像机固件程序崩溃。所以在使用此接口时，请向厂商确定他们有对这些功能点正确处理NULL的逻辑。

1.1.4. 数据回调

TuyaSmartCameraDPObserver协议提供监听设备主动上报的功能点状态变化的能力。下发设置功能点的值以后，设备也会再主动上报一次更新后的值。

接口说明

设备功能点状态变化代理回调

- (void)cameraDPDidUpdate:(TuyaSmartCameraDPManager *)manager dps:(NSDictionary *)dpsData;

参数说明

示例代码

ObjC

- (void)viewDidLoad {
    [super viewDidLoad];
    self.dpManager = [[TuyaSmartCameraDPManager alloc] initWithDeviceId:self.devId];
      [self.dpManager addObserver:self];
      self.osdSwitch = [[self.dpManager valueForDP:TuyaSmartCameraBasicOSDDPName] boolValue];
}

- (void)openOSD {
      s
    if ([self.dpManager isSupportDP:TuyaSmartCameraBasicOSDDPName]) {
        [self.dpManager setValue:@(YES) forDP:TuyaSmartCameraBasicOSDDPName success:^(id result) {
              self.osdSwitch = [result boolValue];
        } failure:^(NSError *error) {
                        // 网络错误
        }];
    }
}

#pragma mark - TuyaSmartCameraDPObserver
- (void)cameraDPDidUpdate:(TuyaSmartCameraDPManager *)manager dps:(NSDictionary *)dpsData {
    // 如果变化的功能点中包含时间水印开关的功能点
    if ([dpsData objectForKey:TuyaSmartCameraBasicOSDDPName]) {
        self.osdSwitch = [[dpsData objectForKey:TuyaSmartCameraBasicOSDDPName] boolValue];
    }
}

Swift

override func viewDidLoad() {
    super.viewDidLoad()
    self.dpManager = TuyaSmartCameraDPManager(deviceId: self.devId)
    self.dpManager.addObserver(self)
    if self.dpManager.isSupportDP(.basicOSDDPName) {
        self.osdSwitch = self.dpManager.value(forDP: .basicOSDDPName) as! Bool
    }
}

func openOSD() {
    // 判断设备是否支持此功能点
    guard self.dpManager.isSupportDP(.basicOSDDPName) else {
        return
    }
    self.dpManager.setValue(true, forDP: .basicOSDDPName, success: { result in
        self.osdSwitch = result as! Bool
    }) { _ in
        // 网络错误
    }
}

func cameraDPDidUpdate(_ manager: TuyaSmartCameraDPManager!, dps dpsData: [AnyHashable : Any]!) {
    // 如果变化的功能点中包含时间水印开关的功能点
    if let osdValue = dpsData[TuyaSmartCameraDPKey.basicOSDDPName] {
        self.osdSwitch = osdValue as! Bool
    }
}

1.2. 功能点常量

目前已开放的摄像机标准功能点，都以字符串常量的形式定义在 TuyaSmartCameraDPManager.h中，类型重定义为TuyaSmartCameraDPKey。常量名以 "TuyaSmartCamera"+"功能"+"DPName" 的形式组成。下面介绍 Camera SDK 中定义的所有功能点。

1.2.1. 基础功能

1.2.2. 移动侦测报警

1.2.3. 声音侦测报警

1.2.4. 存储卡管理

SDCardStorage 的值是一个由总容量，已使用容量，空闲容量插入 ‘|’ 符号拼接起来的字符串，单位是 kb。如 "16777216|1048576|15728640" 表示总容量是 16Gb，已经使用 1Gb，剩余空闲容量为 15Gb。

1.2.5. 云台控制

1.2.6. 低功耗

1.2.7. 枚举型功能点

字符串枚举类型功能点的取值范围，在 Camera SDK 中有定义相应的字符串枚举常量，存储卡状态是整型枚举，可在TuyaSmartCameraDPManager.h中查看具体的定义。