设备相关

设备配网

手机需要连到热点，并且填写wifi的ssid和password来进行设备的快速配网。

增加配网超时时间的配置，在任意处可以修改WifiConfig的对应字段。快联发现超时时间默认为60秒，设置建议不少于20秒。

目前支持的芯片有：乐鑫ESP8266、TI CC3200、汉枫LPB120、庆科WIFI模组。

// ESP8266 和RDA快联超时时间不可设置，内部大概60秒。

/**

​ * AirKiss快联超时时间

​ */

public static int AirKissSmartLinkTime = 60000;

/**

​ * 汉枫快联超时时间

​ */

public static int HfmartLinkTime = 60000;

/**

​ * 庆科mico快联超时时间

​ */

public static int MicoSmartLinkTime =60000;

/**

​ * MTK快联超时时间

​ */

public static int MTKSmartLinkTime = 60000;

/**

​ * 高通快联超时时间

​ */

public static int QCSmartLinkTime = 60000;

/**

​ * TICC3200快联超时时间

​ */

// public static int TISmartLinkTime = 60000;

请求参数：

例子：以下startXXX方法均有对应的stopXXX方法方便用户停止发现设备。

ESP8266的芯片：
IotCloudSDK.getDeviceManager().startEspSmart(ssid,password,productId, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

TI CC3200的芯片：
IotCloudSDK.getDeviceManager(). startTiSmart(ssid, password, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

汉枫wifi芯片
IotCloudSDK.getDeviceManager().startHFSmart(ssid, password, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

庆科MICO芯片
IotCloudSDK.getDeviceManager().startMicoSmart(ssid, password, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

高通芯片
IotCloudSDK.getDeviceManager().startQCSmart(ssid, password, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

Rda芯片
IotCloudSDK.getDeviceManager().startRdaSmart (ssid, password, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

AirKiss芯片
IotCloudSDK.getDeviceManager().startAirKissSmart (ssid, password, 
new ISDKCallback () {
@Override
public void onSuccess() {
    // 配网成功
}
@Override
public void onError(ErrorMessage errorMessage) { 
    // 配网失败
}
});

返回参数：

AP设备配网

​ 用户把设备当做AP的时候可以使用此方法配网

请求参数：

// 对AP设备发送目标路由器的ssid和密码
APNetWorkController netWorkController = 
new APNetWorkController(mView.getActivityContext().getApplicationContext());
        netWorkController.start(ssid, password, timeout, new APNetWorkController.Listener() {
            @Override
            public void onSuccess() {
                // 可以执行发现设备的逻辑了
            }

            @Override
            public void onError(ErrorMessage errorMessage) {
                // 失败
            }
        });

发现设备

用户在设备配网成功后进行执行局域网发现，设备会返回自身的数据iotId、iotToken和mac给手机端，手机端保存之后可以对该设备进行处理。

请求参数：

例子：

IotCloudSDK.getDeviceManager().startSearchDevice(productIdlist, timeout,
new DeviceFoundListener() {
    @Override
    public void onError(ErrorMessage errorMessage) {
}
    @Override
    public void findDevice(CloudDevice device) {
        // 发现到设备了，局域网中有多个设备的时候会持续回调
    }
    @Override
public void noFindDevice() {
// 结束，或者没有发现设备
    }
});

绑定设备

用户需要与发现的设备进行绑定，能够控制设备以及收发设备的信息。一个设备只能被一个用户绑定，不允许多个用户绑定一个设备。

请求参数：

例子：

IotCloudSDK.getDeviceManager().bindDevice(device
new Icallback<String>() {
@Override
public void onSucess(String result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

result参数

解绑设备

用户需要与已经绑定的设备进行解绑。

请求参数：

例子：

IotCloudSDK.getDeviceManager().unbindDevice(device, new ISDKCallback() {
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

获取设备列表

手机端获取已经绑定设备和被分享的设备信息。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceList(

new Icallback>(){

@Override

public void onSucess(List result) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

传入true会拉取设备功能点最新数据

见下面dataMap字段

getDeviceList(true, new Icallback>());

返回参数：

result列表参数

获取单个设备的详细信息

手机端获取指定设备的详细信息。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceInfo(device, new ISDKCallback(){

@Override

public void onSucess(DeviceInfo result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result 参数

获取产品上报功能点

手机查询产品官网上创建的可上报功能点。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getReportedDP(productId,

new ISDKCallbackList() {

@Override

public void onSucess(List result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

获取产品下发功能点

手机查询产品官网上创建的可下发功能点。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getIssuedDP(productId, new Icallback>() {

@Override

public void onSucess(List result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

获取设备某个功能点上传单条数据

手机端查询某绑定设备的最新一条数据。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceData(device, key, new Icallback(){

@Override

public void onSucess(DeviceData result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

获取设备某个功能点上传多条数据

手机端查询某绑定设备当天的指定数目的数据。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceListData(device, key, count,

new Icallback>() {

@Override

public void onSucess(List result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

修改设备信息

手机修改已经绑定的某设备的信息，修改设备的显示名称。

请求参数：

例子：

IotCloudSDK.getDeviceManager().modifyDeviceName(device, displayName,

new ISDKCallback() {

@Override

public void onSucess() {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

检查设备固件版本

检查设备固件版本是否需要升级。

请求参数：

例子：

IotCloudSDK.getOTAManager().checkDeviceOTA(device, new Icallback() {

@Override

public void onSucess(OTAInfo result) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

获取设备某个功能点所有数据列表

获取设备历史数据(数据会一分钟进行一次合并)

请求参数：

例子：

IotCloudSDK.getDeviceManager().getHistoryDeviceDataList(device,key,

new Icallback>() {

@Override

public void onSucess(List result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

获取设备所有功能点最新数据

获取设备所有功能点最新数据，如果在网页配置的功能点是可上报的则只能获取到当天最新的，如果当天设备没有上传最新的数值，则为空，如果需要保存某些功能点最新的数据，需要将功能点定义成可上报可下发的。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getAllLatestData(device,

new Icallback>() {

@Override

public void onSucess(Map result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

获取设备所在天气和地理位置

获取设备所在天气和地理位置。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceWeatherAndLocation(device,

new Icallback() {

@Override

public void onSucess(CloudLocationAndWeather result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

获取设备某个功能点用户操作数据

获取操作该设备指定功能点的数据，包含操作的用户昵称、操作的数据、时间戳。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getUserOperatorList(device, dpKey,

​ count, new Icallback>() {

​ @Override

​ public void onSuccess(List result) {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

result列表里的参数：

获取设备某个功能点设备操作数据

获取设备操作的数据，一般是设备物理按键操作的功能点、操作的数据、时间戳，这个功能点需要。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceOperatorList(device, dpKey,

​ count, new Icallback>() {

​ @Override

​ public void onSuccess(List result) {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

result列表里的参数：

添加定时任务

为设备配置定时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().addTimer(device, time, circle, dpKey, dpValue, dpKey,

new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

修改定时任务

为设备修改定时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().updateTimer(device, time, circle, dpKey, dpValue, dpKey,

​ count, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

获取定时任务列表

获取定时任务列表。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getTimerList(device, new Icallback> () {

​ @Override

​ public void onSuccess(List list) {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

result列表里的参数：

Tiemr.getWeek()可以获取重复的星期列表List

打开定时任务

打开关闭的定时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().openTimer(timerId, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

关闭定时任务

关闭打开的定时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().closeTimer(timerId, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

删除定时任务

删除定时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().deleteTimer(timerId, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

添加延时任务

为设备配置延时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().addDelayTime(device, time, timeInterval, dpKey, dpValue,

dpKey, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

修改延时任务

修改设备的延时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().updateDelayTime(device, time, timeInterval, dpKey, dpValue, dpKey, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

获取延时任务列表

获取延时任务列表。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDelayTimeList(device,

new Icallback>() {

​ @Override

​ public void onSuccess(List list) {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

result列表里的参数：

关闭延时任务

关闭延时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().closeDelayTime(timerId, new ISDKCallback () {

​ @Override

​ public void onSuccess() {

​

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​

​ }

​ });

返回参数：

删除延时任务

删除延时任务。

请求参数：

例子：

IotCloudSDK.getDeviceManager().deleteDelayTime(timerId, new ISDKCallback () {
@Override
public void onSuccess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

删除子设备

删除子设备。

请求参数：

例子：

IotCloudSDK.getDeviceManager().delSubDevice(device, new ISDKCallback () {
@Override
public void onSuccess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

通过id获取设备和子设备

请求参数：

例子：

获取设备信息，信息同设备列表中的CloudDevice
IotCloudSDK.getDeviceManager().getDevice(iotId, new Icallback<CloudDevice> () {
@Override
public void onSuccess(CloudDevice result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

获取子设备设备信息，信息同设备列表中的CloudDevice
IotCloudSDK.getDeviceManager().getDevice(iotId, subIotId, new Icallback<CloudDevice> () {
@Override
public void onSuccess(CloudDevice result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

获取多个数据点的汇总数据

从最近开始往前倒，获取多个数据点的汇总数据，以时间为维度进行合并，可能会确实某些时间或者某些时间下对应key的数据

请求参数：

例子：

IotCloudSDK.getDeviceManager().getCombinedDeviceData(device, keys, count, 
new Icallback<List<CombinedDeviceData>> () {
@Override
public void onSuccess(List<CombinedDeviceData> result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

result参数说明

获取多个数据点的以天为单位合并的数据集合

获取时间范围内的多个key的时间和值的集合，以天为维度合并数据，取平均值。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceDataByDate(device, keys, startYear, 
startMonth, startDay, endYear, endMonth, endDay,
new Icallback<Map<String, List<TimeAndValue>>> () {
@Override
public void onSuccess(Map<String, List<TimeAndValue>> result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

result参数说明

Map> 的 key 是设备功能点的变量名

TimeAndValue参数说明参数：

获取多个数据点的以月为单位合并的数据集合

获取时间范围内的多个key的时间和值的集合，以月为维度合并数据，取平均值。

请求参数：

例子：

IotCloudSDK.getDeviceManager().getDeviceDataByMonth(device, keys, startYear, startMonth, endYear, endMonth, 
new Icallback<Map<String, List<TimeAndValue>>> () {
@Override
public void onSuccess(Map<String, List<TimeAndValue>> result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});

返回参数：

result参数说明

Map> 的 key 是设备功能点的变量名

TimeAndValue参数说明参数：

通过产品id获取产品信息

通过产品id获取产品信息，返回结果同获取产品信息列表

请求参数：

例子：

IotCloudSDK.getDeviceManager().getProductInfo(productId, 
new Icallback<Product> () {
@Override
public void onSuccess(Product result) {                  
}
@Override
public void onError(ErrorMessage errorMessage) {                   
}
});

返回参数：

根据日期获取设备某个功能点所有数据列表

获取设备历史数据(数据会一分钟进行一次合并)

请求参数：

例子：

TimeData startDate = new TimeData(2019, 1, 1);

TimeData endDate = new TimeData(2019, 1, 30);

IotCloudSDK.getDeviceManager().getAllDeviceDataByDate(device,key,startDate,endDate,

new Icallback>() {

@Override

public void onSucess(List result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

通过MAC地址查询设备绑定信息

通过MAC地址查询设备绑定信息

请求参数：

例子：

BindDeviceReqInfo bindDeviceReqInfo =

new BindDeviceReqInfo(“00:00:00:00:00:00”); // 传入设备对应的mac地址

IotCloudSDK.getDeviceManager().getDeviceBindInfoByMac(macList,

new ICallback>() {

@Override

public void onSucess(List result ) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result列表里的参数：

通知音响盒子设备列表同步

设备解绑的时候，第三方音箱盒子的设备列表是无法同步的，需要调用该接口进行同步设备列表

请求参数：

例子：

IotCloudSDK.getDeviceManager().getNotifyAudioDevice(deviceMac, UUID, new ICallback<String>() {
@Override
public void onSuccess(String result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
 }
});

返回参数：

长连接相关

MQTT消息发送和接收

​ 消息接收的配置

消息接受采用广播的形式，用户使用静态或者动态的形式注册广播接收者。

例子：

动态注册原理相同，action和permission与静态广播中的一致即可。

例子：

public class MqttBroadcast extends BroadcastReceiver {

​ @Override

public void onReceive(Context context, Intent intent) {

​ DeviceController.onReceive(intent);

}

}

消息发送的配置

消息发送一般只用DeviceController类

DeviceController deviceController =

new DeviceController(CloudDevice device); // 可以通过CloudDevice初始化

构造一个DeviceController后可以多次使用，下发多次命令或数据。

注意在页面退出(Activity onDestroy)或者不使用DeviceController的时候需要调用

deviceController.onDestroy();

来回收内存，避免内存泄漏。

全局消息接收

全局消息目前包括收到设备分享消息、收到设备新固件版本消息、收到错误消息。

DeviceController.bindGlobalMessage(new DeviceController.GlobalListener() {

​ @Override

​ public void onMessage(CloudMessage cloudMessage) {

​ if (cloudMessage.getErrorMessage().getCode()

== CommonError.MQTT_MESSAGE_SUCCESS) {

​ // success

switch (cloudMessage.getType()) {

// 有设备需要手动OTA升级

​ case CloudMessageType.TYPE_OTA_REV:

break;

// 有分享消息，请到分享消息列表查看

​ case CloudMessageType.TYPE_SHARE_REV:

​ int shareType = ShareMessageType.getShareType(cloudMessage);

​ if (shareType == ShareMessageType.TYPE_DEVICE) {

​ // 设备分享消息

​ } else if (shareType == ShareMessageType.TYPE_FAMILY) {

​ // 家庭分享消息

​ }

​ break;

​ }

​ } else {

​ // error错误信息

​

​ }

​ }

​ });

CloudMessage返回参数：

其他消息接收

DeviceController deviceController =

new DeviceController(CloudDevice device);

透传字符串(Push)消息

deviceController.setPushListener(new DeviceController.PushListener() {

@Override

public void onPush(CloudMessage cloudMessage) {

if (!TextUtils.isEmpty(cloudMessage.data)) {

​ cloudMessage.data // 设备透传上来的字符串数据

}

});

透传二进制数据

deviceController.setBinaryPushListener(new DeviceController.BinaryPushListener() {

@Override

public void onBinaryPush(CloudMessage cloudMessage) {

if (!TextUtils.isEmpty(cloudMessage.binaryData)) {

​ cloudMessage.binaryData // 设备透传上来的字符串数据

}

});

设备功能点更新消息

deviceController.setDPUPdateListener(new DeviceController.DPUpdateListener() {

​ @Override

​ public void onDPUpdate(List list) {

​ // 设备功能点更新(状态改变)

​ }

​ });

设备错误信息

deviceController.setErrorListener(new DeviceController.ErrorListener() {

​ @Override

​ public void onError(CloudMessage cloudMessage) {

​ // 设备的错误信息，例如设备不在线

​ cloudMessage.getErrorMessage();

​ }

​ });

下发常规命令

手机端下发命令控制设备，比如让设备关闭、开启等。

DeviceController deviceController =

new DeviceController(CloudDevice device);

构造设备功能点数据

MessageData.Builder builder = new MessageData.Builder();

builder.put(key, value);

// 注意DeviceController回收

deviceController.sendCommand(builder, new ISDKCallback() {

@Override

public void onSuccess() {

​ Log.d(“TAG”, “command发送成功”);

}

@Override

public void onError(ErrorMessage errorMessage) {

​ Log.d(“TAG”, “command发送失败” + errorMessage.toString());

}

});

手机透传(push)消息到设备

手机向设备发送消息。

DeviceController deviceController =

new DeviceController(CloudDevice device);

// 发送字符串

DeviceController.push(“this is phone push message”); // 注意DeviceController回收

// 发送二进制数据

DeviceController.pushBinary(byte[] array); // 注意DeviceController回收

发送分享消息

分享者分享设备和被分享者接收消息都需要调用该接口通知对方消息。

DeviceController deviceController =

​ // 产品id必填项，当发送家庭分享消息时可以取任意产品id

​ new DeviceController(mDeviceSharingBean.productId,

// 可以通过产品id和设备iotId初始化，当发送家庭分享消息时iotId可填入”” 空字符串

​ mDeviceSharingBean.iotId);

​ deviceController.sendShare(tid, type); // 对方用户的id

// 不用的时候或者Activity退出的时候需要回收

​ deviceController.onDestroy();

sendShare的type字段使用ShareMessageType.TYPE_XXX来设置分享消息类型

目前支持TYPE_DEVICE // 设备分享消息

​ TYPE_FAMILY // 家庭分享消息

MQTT连接状态

获取MQTT连接状态。

请求参数：

例子：

IotCloudSDK.setConnectionStatusListener(new IconnectionStatusListener() {

@Override

public void onConnectionStatus(int result) {

}

});

返回参数：

设备手动OTA升级

查询可以OTA升级的设备

请求参数：

例子：

IotCloudSDK.getOTAManager().getAllOTAUpdateInfo(ICallback>(){

​ @Override

​ public void onSuccess(OTAUpdateInfo result) {

// 这里返回的数据都可以调用获取单个设备升级状态和升级进度

​ }

​ @Override

​ public void onError(ErrorMessage errorMessage) {

​ }

});

返回参数：

result:

向设备主动发送检查升级指令

发送检查升级指令。

请求参数：

例子：

IotCloudSDK.getOTAManager().doDeviceCheckOTA(iotId, new ISDKCallback() {

@Override

public void onSuccess() {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

获取单个设备升级状态和升级进度

获取设备的升级状态和升级进度。

请求参数：

例子：

IotCloudSDK.getOTAManager().cancelLogout(iotId, mcuVersion,

new ICallback() {

@Override

public void onSuccess(OTAUpdateProgress result) {

}

@Override

public void onError(ErrorMessage errorMessage) {

}

});

返回参数：

result: