辅助功能
触发器功能SDK使用
获取手机与设备之间的触发规则
获取手机和某绑定设备之间的已经配置的触发规则,如果没有就显示为空。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
device | CloudDevice | 绑定的设备 | 是 | |
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getTRList(device, new ICallback<List<Trigger>>(){
@Override
public void onSucess(List<Trigger> result ) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | List |
返回成功信息 | 返回success或者需求数据 | 是 |
list列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
id | int | 联动规则的id | 是 | |
cKey | String | 联动规则的触 发条件Key |
是 | |
cSymbol | String | 联动规则的触 发条件符号 |
>、<、=、!= | 是 |
cValue | String | 联动规则的触 发条件数值 |
数值类型的功能点就是数值, 布尔和枚举类型的功能点就 是0、1、2之类的整数 |
|
actionType | int | 联动规则响应 动作的类型 |
1、邮件通知 2、手机短信 (actionMessage配置的无效) 4、消息通知(以Push消息的形式) |
|
actionMessage | String | 当条件触发响 应的信息 |
||
account | String | 账号 | 邮箱账号、手机号、当前用户id IotCloudSDK.getUserId() 可以拿到当前用户id |
|
title | String | 标题 | ||
interval | int | 触发时间间隔 | 单位:秒 | |
count | int | 触发次数 | 当在interval时间内设备上报数 据满足了条件的次数达到count次, 会触发action事件 |
删除手机与设备之间的触发规则
删除手机和某绑定设备之间的一条已经配置的触发规则。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
device | CloudDevice | 绑定的设备 | 是 | |
ruleId | Int | 触发规则的id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().delTriggerRule(device, ruleId, new ISDKCallback() {
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
获取手机与设备的功能点
获取手机和某绑定设备各自的功能点信息,根据约定进行功能点的封装。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
device | CloudDevice | 绑定的设备 | 是 | |
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getTRDP(device, new Icallback<TriggerDPList>() {
@Override
public void onSucess(TriggerDPList result ) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | TriggerDPList | 返回成功信息 | 返回success或者需求数据 | 是 |
result中的有两个参数分别是conditionList和actionList,两个List中的数据都是RuleDataPoint
其中的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
conditionList | List |
触发规则的 条件 |
name:功能点名称 symbol:根据功能点类型而定的符号, int、double、long是 > = < , 其余类型的都是 = valueList(List 数值型的功能点为空,枚举和 布尔型的数据是KeyValue对象, 参数是id和value分别表示枚举 的值和描述; id:功能点的id key:功能点的变量名称 |
是 |
actionList | List |
触发规则的 响应动作 |
key:1、2、4分别是邮件通知、 短信冬至、消息通知 name:动作名称 |
是 |
保存手机与设备的触发规则
保存手机和某绑定设备之间的一条配置的触发规则。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
device | CloudDevice | 绑定的设备 | 是 | |
ssymbol | String | 设定的触发条件的符号 | 设定的触发条件的符号 | 是 |
svalue | String | 触发条件的值 | 触发条件的值 | 是 |
sid | Int | 功能点的id | 功能点的id | 是 |
skey | String | 功能点的变量名称 | 功能点的变量名称 | 是 |
actionType | Int | 响应类型 | 1表示邮件,2表示手机短信, 4表示push消息, 如果需要多种action一起, 数字相加即可如5(1+4) 表示邮件和push消息; |
是 |
actionAccount | String | 报警账号 | 报警消息发送的帐号 actionType为1 需要邮箱账号 actionType为2 需要手机号 actionType为4 的时候账号为用户id |
是 |
title | String | 标题 | ||
acctionMessage | String | 消息内容 | 消息内容 | 是 |
interval | int | 触发时间间隔 | 单位:秒 | 是 |
count | int | 触发次数 | 当在interval时间内设备 上报数据满足了条件的次 数达到count次,会触发action事件 |
是 |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().saveTriggerRule(device, ssymbol, svalue, sid,
skey, actionType, actionAccount, acctionMessage, interval, count,
new ISDKCallback() {
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
联动功能SDK 使用
目前联动必须是用户已经绑定的两个设备,一方发起联动另一方设备。
获取两个设备之间的所有联动规则
获取两个联动设备之间的已经配置的联动规则,如果没有就显示为空。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
sDevice | CloudDevice | 发起联动的设备 | 是 | |
dDevice | CloudDevice | 被联动的设备 | 是 | |
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getLRList(sDevice, dDevice,
new Icallback<List<Linkage>>(){
@Override
public void onSucess(List<Linkage> result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | List |
返回成功信息 | 返回success或者需求数据 | 是 |
result列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
id | int | 联动规则的id | 是 | |
title | String | 标题 | ||
cKey | String | 联动规则的触发条件key | ||
cSymbol | String | 联动规则的触发条件符号 | ||
cValue | String | 联动规则的触发条件值 | ||
aKey | String | 联动规则的响应动作key | ||
aSymbol | String | 联动规则的响应动作符号 | ||
aValue | String | 联动规则的响应动作值 |
删除两个设备之间的联动规则
删除两个联动设备之间的一条已经配置的联动规则。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
sDevice | CloudDevice | 发起联动的设备 | 是 | |
dDevice | CloudDevice | 被联动的设备 | 是 | |
triggerId | Int | 联动规则的id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().delLinkageRule(sDevice, dDevice, triggerId,
new ISDKCallback() {
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
获取两设备的联动功能点
获取两个联动设备各自的功能点信息,根据约定进行功能点的封装。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
sDevice | CloudDevice | 发起联动的设备 | 是 | |
dDevice | CloudDevice | 被联动的设备 | 是 | |
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getLRDP(sDevice, dDevice,
new Icallback<LinkageDPList>() {
@Override
public void onSucess(LinkageDPList result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | LinkageDPList | 返回成功信息 | 返回success或者需求数据 | 是 |
result中的有两个参数分别是conditionList和actionList,两个List中的数据都是RuleDataPoint
其中的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
conditionList | List |
触发规则的 条件 |
name:功能点名称 symbol: 根据功能点类型而定的符号, int、double、long是 > = < , 其余类型的都是 = valueList(List 数值型的功能点为空,枚举和 布尔型的数据是KeyValue对象, 参数是id和value分别表示枚举 的值和描述; id:功能点的id key:功能点的变量名称 |
是 |
actionList | List |
触发规则的 响应动作 |
同上 | 是 |
保存两个设备之间的联动规则
保存两个联动设备之间的一条配置的联动规则。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
sDevice | CloudDevice | 联动的设备 | 发起联动的设备 | 是 |
dDevice | CloudDevice | 被联动的设备 | 被联动的设备 | 是 |
title | String | 标题 | ||
sSymbol | String | 联动条件的符号 | 功能点的符号 | 是 |
sValue | String | 联动功能点的数值 | 功能点的数值 | 是 |
sId | Int | 联动设备的功能点id | 功能点id | 是 |
skey | Int | 联动功能点变量 | 功能点关键字 | 是 |
dsymbol | String | 被联动条件的符号 | 功能点符号 | 是 |
dValue | String | 被联动功能点的数值 | 功能点数值 | 是 |
dId | String | 被联动设备的功能点id | 功能点id | 是 |
dkey | String | 被联动功能点变量 | 功能点关键字 | 是 |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().saveLinkageRule(sDevice, dDevice, title, sSymbol, sValue, sId, sKey, dSymbol, dValue, dId, dKey, new ISDKCallback() {
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
设备分享功能
设备分享可以在接受,删除,或者取消分享的时候调用6中的发送设备分享消息提示对方用户分装状态的变化。
获取可分享的设备列表
获取可分享的设备列表,如果没有就显示为空。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getShareList(new Icallback<List<ShareableDevice>>(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | List |
返回成功信息 | 返回success或者需求数据 | 是 |
result列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
iotId | String | 设备id | 是 | |
displayName | String | 设备名称 | ||
acceptNum | int | 已接受输送量 | ||
noOperateNum | int | 待接受数量 | ||
productId | int | 产品id |
获取单个设备的分享状况
获取单个设备的分享状况,如果没有就显示为空。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
iotId | String | 设备的Id | 是 | |
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getDeviceShareInfo(iotId,
new ISDKCallback<List<DeviceShareInfo>>(){
@Override
public void onSucess(String result ) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | List |
返回成功信息 | 返回success或者需求数据 | 是 |
result列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
tid | int | 被分享者的userId | 是 | |
statusInfo | ShareStatusInfo | 设备的分享状态 | 是 | |
sharedUserName | String | 被分享者的名字 | 是 | |
headimag | String | 被分享者的头像 | 是 | |
time | int | 分享时间戳 | 13位时间戳 | 是 |
ShareStatusInfo.getStatus()获取状态,具体分类如下,状态根据当前用户是共享方或被共享方而不同:
public @interface ShareStatus {
// 分为共享方状态
/**
\* 已经分享出去,但对方尚未接受
*/
int SHARE_NOT_RECEIVE = 1;
/**
\* 已经分享出去,对方已经接受
*/
int SHARE_RECEIVE = 2;
/**
\* 已经分享出去,对方已经拒绝接受分享
*/
int SHARE_REFUSE = 3;
/**
\* 已经分享出去,对方已经接受了,但是目前已经删除了分享设备(对方和分享的设备已没有关联)
*/
int SHARE_REMOVE = 4;
// 接收方状态(被共享方)
/**
\* 对方已经分享,等待我接受
*/
int RECEIVING = 21;
/**
\* 对方已经分享,并且我已经接受了
*/
int RECEIVED = 22;
/**
\* 对方分享了,我还没有接受,此时对方已经删除了对我的分享(设备对我已失效)
*/
int RECEIVE_REFUSE = 23;
/**
\* 对方分享了,我已经接受了,此时对方已经删除了对我的分享(已取消设备对我的分享)
*/
int RECEIVED_REMOVE = 24;
/**
\* 未知的状态
*/
int UNKNOWN = 25;
}
被分享方接受分享设备
被分享方接受分享方分享的设备。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
fUserId | Int | 分享方的用户的id | 是 | |
iotId | String | 设备的Id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().acceptShare(fUserId, iotId, new ISDKCallback(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
分享方取消分享
分享方取消对用户的设备分享。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
tUserId | Int | 被分享方的用户的id | 是 | |
info | ShareStatusInfo | 被分享方当前的状态 | 是 | |
iotId | String | 设备的Id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().cancelShare(tUserId, info, iotId, new ISDKCallback(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
删除分享设备
将被分享方的共享设备从设备列表中删除。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
fUserId | Int | 分享方的用户的id | 是 | |
iotId | String | 设备的Id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().delShareDevice(fUserId, iotId, new ISDKCallback(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
验证被分享者
验证输入的手机号是否注册过,是否已经分享过这个设备,没有被分享过返回该用户的信息。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
tel | String | 被分享者的手机号 | 是 | |
iotId | String | 设备的Id | 是 | |
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().verifyShareUser(tel, iotId,
new Icallback<VerifyShareInfo>(){
@Override
public void onSucess(VerifyShareInfo result ) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | VerifyShareInfo | 返回成功信息 | 返回success或者需求数据 | 是 |
如果返回错误码-350表示已经分享过了,-210表示用户没有注册。
Result列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
String | 用户邮箱 | 是 | ||
headimag | String | 用户头像的url | 是 | |
id | int | 对方用户id | 是 | |
nickName | String | 用户昵称 | 是 | |
tel | String | 用户手机 | 是 |
添加新的分享
验证输入的手机号是否注册过,是否已经分享过这个设备,没有被分享过就分享给该用户。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
tel | String | 被分享者的手机号 | 是 | |
iotId | String | 设备的Id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().addShare(tel,iotId,new ISDKCallback(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
通过邮箱添加新的分享
验证输入的邮箱是否注册过,是否已经分享过这个设备,没有被分享过就分享给该用户。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
String | 被分享者的邮箱地址 | 是 | ||
iotId | String | 设备的Id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().addShareByEmail(email,iotId,new ISDKCallback(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
获取分享消息列表
获取可分享的设备列表,如果没有就显示为空。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getShareMsgList(new ISDKCallback<List<ShareMessage>>(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | String | 返回成功信息 | 返回success或者需求数据 | 是 |
result列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
deviceName | String | 设备名称 | shareType=2的时候表示家庭名称 | 是 |
id | Int | 消息id | ||
productId | Int | 产品id | ||
fName | String | 分享方昵称 | ||
fTel | String | 分享方手机号 | ||
fid | Int | 分享方用户id | ||
iotid | String | 分享设备id | shareType=2的时候表示家庭id | |
tName | String | 被分享方昵称 | ||
tTel | String | 被分享方手机号 | ||
tid | Int | 被分享方用户id | ||
time | Long | 消息时间戳(毫秒13位) | ||
statusInfo | ShareStatusInfo | 分享状态 | ||
shareType | Int | 分享消息类型 | 1设备分享消息 2家庭分享消息 |
ShareStatusInfo.getStatus()获取状态,具体分类如下,状态根据当前用户是共享方或被共享方而不同:
public @interface ShareStatus {
// 分为共享方状态
/**
\* 已经分享出去,但对方尚未接受
*/
int SHARE_NOT_RECEIVE = 1;
/**
\* 已经分享出去,对方已经接受
*/
int SHARE_RECEIVE = 2;
/**
\* 已经分享出去,对方已经拒绝接受分享
*/
int SHARE_REFUSE = 3;
/**
\* 已经分享出去,对方已经接受了,但是目前已经删除了分享设备(对方和分享的设备已没有关联)
*/
int SHARE_REMOVE = 4;
// 接收方状态(被共享方)
/**
\* 对方已经分享,等待我接受
*/
int RECEIVING = 21;
/**
\* 对方已经分享,并且我已经接受了
*/
int RECEIVED = 22;
/**
\* 对方分享了,我还没有接受,此时对方已经删除了对我的分享(设备对我已失效)
*/
int RECEIVE_REFUSE = 23;
/**
\* 对方分享了,我已经接受了,此时对方已经删除了对我的分享(已取消设备对我的分享)
*/
int RECEIVED_REMOVE = 24;
/**
\* 未知的状态
*/
int UNKNOWN = 25;
}
删除分享消息
删除分享消息
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
id | Int | 消息id | 是 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
可传入单个消息id或者List<Integer>删除多条消息
IotCloudSDK.getDeviceManager().delShareMsg(id, new ISDKCallback(){
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
获取最近分享用户列表
获取最近被分享方用户列表。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getRecentShareList(
new ISDKCallback<List<DeviceShareUserInfo>>(){
@Override
public void onSucess(List<DeviceShareUserInfo> result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | List |
返回成功信息 | 返回success或者需求数据 | 是 |
result列表里的参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
String | 用户邮箱地址 | 是 | ||
headimag | String | 用户头像url | ||
id | int | 对方用户id | ||
nickName | String | 用户昵称 | ||
tel | String | 用户手机号 |
意见反馈
获取意见反馈类型
意见反馈现在有四种类型,可以供用户选择。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getFeedbackType(new Icallback>() {
@Override
public void onSucess(List
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | List |
返回成功信息 | 返回success或者需求数据 | 是 |
result的参数类型
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
fbTypeId | int | 意见反馈类型id | 是 | |
fbTypeName | String | 意见反馈类型名称 |
获取意见反馈列表
获取意见反馈列表,可以为用户提供参考,列表中的信息需要在web端配置。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
productId | Int | 产品id | ||
Icallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().getFeedbackList(productId,
new Icallback>() {
@Override
public void onSucess(List
}
@Override
public void onError(ErrorMessage errorMessae) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessae | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | String | 返回成功信息 | 返回success或者需求数据 | 是 |
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
fbTitle | String | 意见反馈类型id | 是 | |
fbContent | String | 意见反馈类型名称 | ||
fbPic | String | 意见反馈的图片 | 最多3个图片URL地址,以逗号隔开 |
添加用户反馈信息
添加用户意见反馈。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
productId | Int | 产品id | 是 | |
deviceMac | String | 设备mac地址 | mac地址格式 xx:xx:xx:xx:xx:xx | 是 |
type | int | 意见反馈类型id | 意见反馈类型id | 是 |
contact | String | 用户联系方式 | 手机号或者邮箱 | 是 |
content | String | 文字内容 | 支持120字以内 | 是 |
fileList | List |
反馈的图片(可为空) | 图片少于3个,100kb以内 | 否 |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDeviceManager().saveFeedback(productId,deviceMac,type,contact,content,
fileList,new ISDKCallback() {
@Override
public void onSucess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | String | 返回成功信息 | 返回success或者需求数据 | 是 |
其他功能
获取天气信息
通过经纬度获取天气信息。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
longitude | String | 经度 | 是 | |
latitude | String | 纬度 | 是 | |
Icallback | Function | 回调函数 |
例子:
IotCloudSDK.getDataManager().getWeather(longitude,latitude,
new Icallback
@Override
public void onSucess(CloudWeather result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | CloudWeather | 返回成功信息 | 返回success或者需求数据 | 是 |
result的参数
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
pm25 | String | pm25数值 | 是 | |
skycon | String | 天气状况 | 是 | |
temperature | String | 当前温度 | 是 |
获取位置信息
获取位置信息。
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
Icallback | Function |
例子:
IotCloudSDK.getDataManager().getAppLocation(new ISDKCallback
@Override
public void onSucess(CloudLocation result) {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
result | CloudLocation | 返回成功信息 | 返回success或者需求数据 | 是 |
result参数
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
city | String | 城市名称 | 是 | |
country | String | 国家名称 | 是 | |
operator | String | 运营商名称 | 是 | |
province | String | 省名称 | 是 |
绑定Push唯一ID
目前推送支持极光,小米,华为,可以介入其中一个或多个。介入多个需要多次调用此接口
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
registrationId | String | 极光push唯一id | 通过 JPushInterface.getRegistrationID(); | 是 |
tags | List |
暂时无用 | 直接传入一个空的list new ArrayList<>(); | 是 |
langType | LangType | 语言类型 | 当前用户的语言类型 | |
platformType | Int | 推送的平台 | 1 极光 2小米 3华为 | |
ISDKCallback | Function | 回调函数 | 是 |
LangType类:
public class LangType {
/**
* 使用SDK的app当前用户的语言类型
* 1、中文
* 2、英文
* 3、德文
* 4、法文
* 5、西班牙文
* 6、意大利文
* 7、俄文
* 8、印地文
* 9、繁体中文
* 10、丹麦文
* 11、荷兰文
* 12、芬兰文
* 13、瑞典文
* 14、挪威文
* 15、韩文
* 16、日文
* 17、希伯来文
* 18、菲律宾文
* 19、希腊文
* 20、葡萄牙文
* 21、阿拉伯文
* 22、孟加拉文
* 23、越南文
* 24、泰文
* 25、波兰文
* 26、波斯文
* 27 乌克兰文
*/
public static final int CN = 1;
public static final int GB = 2;
public static final int DE = 3;
public static final int FR = 4;
public static final int ES = 5;
public static final int IT = 6;
public static final int RU = 7;
public static final int IN = 8;//印度
public static final int HK = 9;
public static final int DK = 10;
public static final int NL = 11;
public static final int FI = 12;
public static final int SE = 13;
public static final int NO = 14;
public static final int KR = 15;
public static final int JP = 16;
public static final int IL = 17;
public static final int PH = 18;
public static final int GR = 19;
public static final int PT = 20;
public static final int SA = 21;
public static final int BD = 22;
public static final int VN = 23;
public static final int TH = 24;
public static final int PL = 25;
public static final int BS = 26;
public static final int UA = 27;
}
例子:
IotCloudSDK.getDataManager().bindRegId(registrationId, tags,langType, platformType,new ISDKCallback() {
@Override
public void onSuccess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
解绑Push唯一ID
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
registrationId | String | 极光push唯一id | 通过 JPushInterface.getRegistrationID(); | 是 |
platformType | Int | 推送的平台 | 1 极光 2小米 3华为 | |
ISDKCallback | Function | 回调函数 | 是 |
例子:
IotCloudSDK.getDataManager().unbindRegId(registrationId, new ISDKCallback() {
@Override
public void onSuccess() {
}
@Override
public void onError(ErrorMessage errorMessage) {
}
});
返回参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
errorMessage | ErrorMessage | 错误码 | 参照错误码 | 是 |
全局崩溃异常上报
全局崩溃异常上报
请求参数:
参数名 | 类型 | 说明 | 备注 | 必需 |
---|---|---|---|---|
throwable | Throwable | 抛出异常实体信息 | 发生crash时返回 | 是 |
通过调用IotCloudSDK.uploadException(throwable)将收集到的异常传入即可
例子:
public class CrashHandlerUtil implements Thread.UncaughtExceptionHandler {
private Context mContext;
/**
* 系统默认的处理类
*/
private Thread.UncaughtExceptionHandler mExceptionHandler;
public void init(Context context) {
mContext = context;
mExceptionHandler = Thread.getDefaultUncaughtExceptionHandler();
// 设置默认处理器
Thread.setDefaultUncaughtExceptionHandler(this);
}
/**
* 处理发生未捕获异常
*
* @param t
* @param e
*/
@Override
public void uncaughtException(Thread t, Throwable e) {
IotCloudSDK.uploadException(throwable);
}
}
上述例子中通过继承Android系统默认异常处理类UncaughtExceptionHandler,并通过调用Thread.setDefaultUncaughtExceptionHandler(UncaughtExceptionHandler eh);将自定义UncaughtExceptionHandler的子类传入方法中,并在重写uncaughtException方法中调用。