1. Extension Features

Tuya smart device controls the device through the device function point, and realizes the interaction between the device and the app through the standardized function point. Tuya Smart Camera Android SDK is based on custom device control and encapsulates a set of extended functions for smart cameras.

1.1. Device control

1.1.1. Create instance

Declaration

initaling device by device ID.

ITuyaCameraDevice getCameraDeviceInstance(String devId)

Example

ITuyaCameraDevice tuyaCameraDevice = TuyaCameraDeviceControlSDK.getCameraDeviceInstance(devId);

1.1.2. Query value

Declaration

Judge whether the device supports the data-point. Call data issues/data research will fail if the device dose not support certain data-point.

boolean isSupportCameraDps(String dpCodeID);

Example

boolean isSupportDpBasicFlip = mTuyaCameraDevice.isSupportCameraDps(DpBasicFlip.ID);

Value data-point

Declaration

IGet the data of the corresponding function point through the cache. According to the data type of Value, you can use the following methods to query.

 int queryIntegerCurrentCameraDps(String dpCodeID);

Example

int dpvalue = mTuyaCameraDevice.queryIntegerCurrentCameraDps(DpSDStatus.ID);

Object data-point

Declaration

Obtain the data of corresponding function points through the cache, and support all function point queries of enum, value, boolean, and String.

Object queryObjectCameraDps(String dpCodeID);

Example

Object dpValue = mTuyaCameraDevice.queryObjectCameraDps(DpBasicFlip.ID);

If you use: queryObjectCameraDps for querying, developers need to distinguish the data types separately.

String/Enum data-point

Declaration

Get the data of the corresponding function point through the cache. According to the data type of String / Enum, you can use the following methods to query.

String queryStringCurrentCameraDps(String dpCodeID);

Example

String mode = mTuyaCameraDevice.queryStringCurrentCameraDps(DpMotionSensitivity.ID);

Boolean data-point research

Declaration

Get the data of the corresponding function point through the cache. According to the data type of boolean, you can use the following methods to query.

boolean queryBooleanCameraDps(String dpCodeID);

Example

boolean dpValue = mTuyaCameraDevice.queryBooleanCameraDps(DpBasicFlip.ID);

1.1.3. Publish data

Declaration

Send message through LAN or cloud

Example

//Callback is able to set as Boolean/String/Integer when the data-point type is Boolean/Enum/Value.
mTuyaCameraDevice.publishCameraDps(DpBasicFlip.ID, true, null, new ITuyaCameraDeviceControlCallback<Boolean>() {
  @Override
  public void onSuccess(String s, DpNotifyModel.ACTION action,                                                     DpNotifyModel.SUB_ACTION sub_action, Boolean o) {
    Log.d("device control", "value " + action + "   " + sub_action + " o " +                         o );
  }

  @Override
  public void onFailure(String s, DpNotifyModel.ACTION action,                                             DpNotifyModel.SUB_ACTION sub_action, String s1, String s2) {

  }
});
mTuyaCameraDevice.publishCameraDps(DpBasicFlip.ID, true);

1.1.4. Callback

ITuyaCameraDeviceControlCallback provides listener device info data receiving, and receive device callback after data publishing from App side. Callback is able to set as Boolean/String/Integer when the data-point type is Boolean/Enum/Value.

public interface ITuyaCameraDeviceControlCallback<E> {
    //Callback succeed
    void onSuccess(String devId, ACTION action, SUB_ACTION subAction, E o);
    //Callback fail
    void onFailure(String devId, ACTION action, SUB_ACTION subAction, String errorCode, String errorString);
}

Supported data types：

1.2. Data point id

1.2.1. Basic features

1.2.2. Motion detection alarm

1.2.3. Sound detection alarm

1.2.4. Memory card management

1.2.5. PTZ control

1.2.6. Doorbell

1.2.7. Enum data points

The value range of the function point of the string enumeration type. There are corresponding string enumeration constants defined in the SDK.