1.1. Low power doorbell

1.1.1. Determine if it is a low-power device

Determine whether the device is a low-power device according to the interface in TuyaSmartDeviceModel+IPCSDK.

Declaration

Is it a low-power device.

- (BOOL)isLowPowerDevice;

If the device is both a camera device and a low-power device, the device can be considered a low-power doorbell.

1.1.2. Sleep and wake

Low power doorbell is powered by battery. In order to save power, camera will sleep when no p2p connection for a certain period of time. After sleeping, it cannot be directly connected to p2p. You need to wake up the device, and then connect to the p2p channel after waking up.

Use TuyaSmartDevice to wake up doorbell.

Declaration

Awake low power device.

- (void)awakeDeviceWithSuccess:(nullable TYSuccessHandler)success failure:(nullable TYFailureError)failure;

When success callback, it is means wake up cammand has publish succeed, but doorbell is not waking up. When doorbell waking up, doorbell wiil report YES of data point TuyaSmartCameraWirelessAwakeDPName.

Example

ObjC

- (void)viewDidLoad {
        [super viewDidLoad];
      self.dpManager = [[TuyaSmartCameraDPManager alloc] initWithDeviceId:self.devId];
        self.device = [TuyaSmartDevice deviceWithDeviceId:self.devId];
        [self.dpManager addObserver:self];

      [self start];
}

- (void)start {
      if (self.isConnected) {
                [self.videoContainer addSubview:self.camera.videoView];
                self.camera.videoView.frame = self.videoContainer.bounds;
        [self.camera startPreview];
        }else if (!self.isConnecting) {
          if (self.device.deviceModel.isLowPowerDevice) {
                [self.device awakeDeviceWithSuccess:nil failure:nil];
            }
                [self.camera connect];
          self.isConnecting = YES;
        }
}

Swift

func viewDidLoad() {
      super.viewDidLoad()
      self.dpManager = TuyaSmartCameraDPManager(deviceId: self.devId)
        self.device = TuyaSmartDevice(deviceId: self.devId)
        self.dpManager?.addObserver(self)

      self.start()
}

func start() {
      guard self.isConnected || self.isConnecting else {
            if self.device?.deviceModel.isLowPowerDevice() {
              self.device?.awake(success: nil, failure: nil)
        }
                self.camera.connect()
                self.isConnecting = true
          return
    }
    self.videoContainer.addSubView(self.camera.videoView)
    self.camera.videoView.frame = self.videoContainer.bounds
    self.camera.startPreview()
}

1.1.3. Doorbell call

When the device is successfully bound to the home and online, when someone rings the doorbell, the SDK will receive the event of the doorbell call. Events are broadcast as notifications.

• Notification name: kNotificationMQTTMessageNotification
• Parameters：
  • devId: Device id of doorbell.
  • etype：Event type, doorbell means doorbell call.

Example

ObjC

#define kTuyaDoorbellNotification @"kNotificationMQTTMessageNotification"

- (void)observeDoorbellCall:(void(^)(NSString *devId, NSString *type))callback {
    if (!callback) {
        return;
    }
        // Add observer for doorbell call
    [[NSNotificationCenter defaultCenter] addObserverForName:kTuyaDoorbellNotification object:nil queue:nil usingBlock:^(NSNotification *note) {
        NSDictionary *eventInfo = note.object;
        NSString *devId = eventInfo[@"devId"];
        NSString *eType = [eventInfo objectForKey:@"etype"];
        if ([eType isEqualToString:@"doorbell"]) {
            callback(devId, eType);
        }
    }];
}

Swift

func obserDoorbellCall(_ callBack: @escaping (String, String) -> Void) {
        // Add observer for doorbell call
    NotificationCenter.default.addObserver(forName: NSNotification.Name(rawValue: "kNotificationMQTTMessageNotification"), object: nil, queue: nil) { (noti) in
        if let eventInfo = noti.object as? [String: Any?] {
            let devId = eventInfo["devId"] as! String
            let eType = eventInfo["etype"] as! String
            if eType == "doorbell" {
                callBack(devId, eType)
            }
        }
    }
}

1.1.4. Battery management

There are two ways to power low-power doorbells, plug-in and battery-powered. The SDK can query the current power supply mode and current power of the device. You can also set a low battery alarm threshold. When the battery is too low, an alarm notification will be triggered.

Example

ObjC

- (void)viewDidLoad {
        if ([self.dpManager isSupportDP:TuyaSmartCameraWirelessPowerModeDPName]) {
        TuyaSmartCameraPowerMode powerMode = [[self.dpManager valueForDP:TuyaSmartCameraWirelessPowerModeDPName] tysdk_toString];
        if ([powerMode isEqualToString:TuyaSmartCameraPowerModePlug]) {
                        // plug-in power
        }else if ([powerMode isEqualToString:TuyaSmartCameraPowerModeBattery]) {
            // battery-power
        }
    }

    if ([self.dpManager isSupportDP:TuyaSmartCameraWirelessElectricityDPName]) {
        NSInteger electricity = [[self.dpManager valueForDP:TuyaSmartCameraWirelessElectricityDPName] tysdk_toInt];
        NSLog(@"current power: %@%%", @(electricity));
    }

    if ([self.dpManager isSupportDP:TuyaSmartCameraWirelessLowpowerDPName]) {
        // When the battery level is lower than 20%, low battery warning will be triggered
        [self.dpManager setValue:@(20) forDP:TuyaSmartCameraWirelessLowpowerDPName success:^(id result) {

        } failure:^(NSError *error) {
            // Network error
        }];
    }

    if ([self.dpManager isSupportDP:TuyaSmartCameraWirelessBatteryLockDPName]) {
        // Unlock the battery to remove the battery
        [self.dpManager setValue:@(NO) forDP:TuyaSmartCameraWirelessBatteryLockDPName success:^(id result) {

        } failure:^(NSError *error) {
            // Network error
        }];
    }
}

Swift

override func viewDidLoad() {
    super.viewDidLoad()
    if self.dpManager.isSupportDP(.wirelessPowerModeDPName) {
        let powerMode = self.dpManager.value(forDP: .wirelessPowerModeDPName) as! String
        switch TuyaSmartCameraPowerMode(rawValue: powerMode) {
        case .plug: break
            // plug-in power
        case .battery: break
            // battery-power
        default: break
        }
    }

    if self.dpManager.isSupportDP(.wirelessElectricityDPName) {
        let electricity = self.dpManager.value(forDP: .wirelessElectricityDPName) as! Int
        print("current power: ", electricity)
    }

    if self.dpManager.isSupportDP(.wirelessLowpowerDPName) {
        // When the battery level is lower than 20%, low battery warning will be triggered
        self.dpManager.setValue(20, forDP: .wirelessLowpowerDPName, success: { _ in

        }) { _ in
            // Network error
        }
    }

    if self.dpManager.isSupportDP(.wirelessBatteryLockDPName) {
        // Unlock the battery to remove the battery
        self.dpManager.setValue(false, forDP: .wirelessBatteryLockDPName, success: { _ in

        }) { _ in
            // Network error
        }
    }
}