Manipulator

1.Manipulator.getState

Get Current State

BDDP

Param	Value	Desc
method	Manipulator.getState	Get Current State
targetDevice	<String,Necessary>	DeviceId of the Manipulator you use;
token	<String,Necessary>	Net token of the Manipulator you use;

BUDP

Param	Value	Desc
data.state	<String,Necessary>	Current state of device,["closed","open"];
data.delay.on	<Integer,Optional>	The remain time of Delay ON;Unit of minute;0 is OFF
data.delay.off	<Integer,Optional>	The remain time of Delay OFF;Unit of minute;0 is OFF
data.openRemind	<Integer,Optional>	time to remind when device keep open. 0 is disabled
data.version	<String,Necessary>	Firmware Version of device
data.tz	<Integer,Necessary>	Timezone of device. -12 ~ 12

2.Manipulator.setState

Set Manipulator's State

BDDP

Param	Value	Desc
method	Manipulator.setState	Set Manipulator's State
targetDevice	<String,Necessary>	DeviceId of the Manipulator you use;
token	<String,Necessary>	Net token of the Manipulator you use;
params.state	<String,Necessary>	Set state of device.["close","open"];

BUDP

Param	Value	Desc
data.state	<String,Necessary>	State of device,["closed","open"];

3.Manipulator.setDelay

Delay to turn on Manipulator.

BDDP

Param	Value	Desc
method	Manipulator.setDelay	Delay to turn on Manipulator.
targetDevice	<String,Necessary>	DeviceId of the Manipulator you use;
token	<String,Necessary>	Net token of the Manipulator you use;
params.delayOn	<Integer,Optional>	The time you want to Delay ON;Unit of minute;0 is cancel delay;
params.delayOff	<Integer,Optional>	The time you want to Delay OFF;Unit of minute;0 is cancel delay;

BUDP

Param	Value	Desc
data.delay.on	<Integer,Optional>	The remain time of Delay ON;Unit of minute;0 is OFF
data.delay.off	<Integer,Optional>	The remain time of Delay OFF;Unit of minute;0 is OFF

4.Manipulator.getSchedules

Get Schedule List

BDDP

Param	Value	Desc
method	Manipulator.getSchedules	Get Schedule List.
targetDevice	<String,Necessary>	DeviceId of the Manipulator you use;
token	<String,Necessary>	Net token of the Manipulator you use;

BUDP

Param	Value	Desc
data[index].isValid	<Boolean,Necessary>	Enabled/Disabled ;
data[index].index	<Integer,Necessary>	Index of this record ;
data[index].on	<String,Optional>	Time to turn on; HH:mm
data[index].off	<String,Optional>	Time to turn off; HH:mm
data[index].week	<Integer,Necessary>	mask of effected days(Sunday to Saturday)

5.Manipulator.setSchedules

Set Schedule

BDDP

Param	Value	Desc
method	Manipulator.setSchedules	Set Schedule.
targetDevice	<String,Necessary>	DeviceId of the Manipulator you use;
token	<String,Necessary>	Net token of the Manipulator you use;
params.sches	<Array<Schedule>	Map<int,Schedule>,Necessary>
params.sches[index].isValid	<Boolean,Necessary>	Enabled/Disabled ;
params.sches[index].index	<Integer,Necessary>	Index of this record ;
params.sches[index].on	<String,Necessary>	Time to turn on; HH:mm
params.sches[index].off	<String,Necessary>	Time to turn off; HH:mm
params.sches[index].week	<Integer,Necessary>	mask of effected days(Sunday to Saturday)

index from "0" to "5"

BUDP

Same as Manipulator.getSchedules

6.Manipulator.getVersion

Get firmware info

BDDP

Param	Value	Desc
method	Manipulator.getVersion	Get firmware info;
targetDevice	<String,Necessary>	DeviceId of this device;
token	<String,Necessary>	Net Token of this device;

BUDP

Param	Value	Desc
data.version	<String,Necessary>	Current Version;
data.newVersion.versionId	<String,Optional>	Id of the newest version;
data.newVersion.versionCode	<String,Optional>	Code of the newest version;
data.newVersion.fileSize	<String,Optional>	File Size of the newest version;

7.Manipulator.startUpgrade

Start Upgrade

BDDP

Param	Value	Desc
method	Manipulator.startUpgrade	Start Upgrade
targetDevice	<String,Necessary>	DeviceId of this device;
token	<String,Necessary>	Net Token of this device;
params.versionId	<String,Necessary>	Version Id you want to upgrade;

BUDP

Param	Value	Desc
data.isStarted	<Boolean,Necessary>	Is upgrading started;

8.Manipulator.getActivityLogs

Used to retrieve device activity records through search parameters or retrieval key.

caution

"DEVICE.HISTORICAL_DATA.READ" permission is required to access this interface

BDDP

Param	Value	Desc
method	Manipulator.getActivityLogs	Get device's activity records
targetDevice	<String,Necessary>	DeviceId of the device you use;
token	<String,Necessary>	Net token of the device you use; You can get it here
params.search	<Object,Optional>	Retrieve records through search parameters.
params.search.startDate	<String,Necessary>	Specify the start date of the search scope, with "YYYY-MM-DD" formatted
params.search.endDate	<String,Necessary>	Specify the end date of the search scope, with "YYYY-MM-DD" formatted
params.retrievalKey	<string,Optional>	Retrieve records through retrieval key.

BUDP

Param	Value	Desc
data.logs	<Array,Necessary>	Records of device activity logs
data.logs[*].id	<Array,Necessary>	Id of record
data.logs[*].time	<Date,Necessary>	Time of record
data.logs[*].data	<Object,Necessary>	Data of record
data.retrievalKeys	<Object,Optional>	When search results are not fully returned in this data packet, retrieval keys will be provided for retrieving other results.
data.retrievalKeys.next	<Object,Necessary>	It indicates that there is more data available and can be retrieved through this key.

9.Callbacks

You can receive it with Http Callback API or MQTT report topic

BUDP

<Same as 1.Manipulator.getState>