APPSDK 设备控制系统说明

API概览

名称 描述
设备配网 deviceConfig
设备AP方式配网 deviceAPConfig
设备局域网发现 startProbe
设备添加 addDevice
设备配对 pair
数据透传 dnaPassthrough
脚本版本查询 queryScriptVersion
脚本下载 downloadScript
脚本信息获取 queryProfileByPid
设备控制 - 脚本方式 dnaControl
通用定时任务 通用定时任务 updateTask
普通任务/延迟任务 普通任务/延迟任务
周期任务 周期任务
循环任务/防盗任务 循环任务/防盗任务
任务列表查询 queryTask
任务删除 delTask
任务命令查询 queryTaskData
设备状态查询 queryDeviceState
设备时间查询 queryDeviceTime
设备上报数据查询 queryDeviceData
固件升级 updateFirmware
获取 RMAC 红外码脚本信息 queryRMACIRCodeInfomation
获取 RMAC 发送红外码 Hex格式 queryRMACIRCodeData
计算日出日落时间 calulateSunriseTime
获得已添加到sdk的设备列表 queryDeviceAddedList

1. 基本功能介绍

APPSDK 设备控制系统是基于原有 DNASDK 开发,提供设备配网、设备发现、设备配对以及统一的设备控制功能。

基本概念

设备配网

SDK通过广播/组播的方式,发送UDP报文,将手机输入的Wi-Fi SSID和密码以一定的格式发送给设备端,设备接受到相应的信息后,自行向路由器发送DHCP请求,完成设备配网的功能。

设备发现

SDK通过发送广播包的方式,发现在同一个局域网内符合 BroadLink 相关设备协议的网络设备。

设备配对

SDK获取设备控制的唯一ID和key,设备远程控制必须带上这个两个值,否则会返回-7。
id和key是设备远程控制的必要参数,id和key由设备生成,且仅只会在设备复位重新配置的情况下改变,复位后需要重新配对

设备控制

按照设备网络状态可以分为: 局域网控制和远程控制。
按照命令格式可以分为: 透传控制和脚本控制。

局域网控制

SDK在局域网内,通过UDP发包给设备,直接达到控制设备的目的。设备信息里面必须包含有设备的局域网IP地址。

远程控制

SDK通过设备接入服务器,发送设备控制报文,达到远程控制设备的目的。必须使用 BLLetAccount 完成账号登录之后才能使用。

主要流程如下:

控制流程

主要流程:

  1. 账号登录,如果需要远程控制设备,必须要先登录。
  2. 设备配网,通过SDK将SSID和密码发送给设备,使设备连接WiFi路由器的过程,设备无法配置入网点击这里?
  3. 设备发现,在开启设备扫描 startProbe 之后自动发现局域网设备,通过回调的方式告诉开发者。
  4. 设备配对pair 把获取到的 idkey 设置到设备信息里面
  5. 添加设备,调用 addDevice 将设备信息添加到SDK管理。
  6. 下载脚本,脚本信息(Profile)包含有设备的相关信息,标准的控制指令等。
  7. 设备控制,APPSDK会根据添加设备的信息的不同(主要是局域网IP地址),来判断使用局域网控制,还是远程控制。

设备控制分透传控制和脚本控制:

透传控制

SDK直接将二进制数据透传给设备,设备收到之后,依旧返回二进制数据,APP需要自行解析二进制数据的含义。

脚本控制

每一个产品在 BroadLink DNAKit 创建的时候,都会生成一个控制的脚本。设备脚本包含有设备的相关信息,标准的控制指令等。 SDK可以下载脚本到指定路径,在控制设备的时候,将不同的控制指令,通过脚本转换为设备接收的二进制指令下发。同样能将设备返回二进制指令,通过脚本转换为控制指令,便于APP识别和使用。

2. API 接口介绍

设备控制系统相关接口将会在 BLLetCore 库的 BLLet 类初始化之后,就会以单例的方式实例化。

iOS 系统可以调用 BLLet 类中的 controller 属性和相应的实例方法。 Android 系统可以调用 BLLet 类中的 Controller 静态类方法。

2.1 设备配网

deviceConfig 方式进行设备网络配置采用局域网 UDP 发包的方式对设备进行 Wi-Fi 配置。

注意:

  1. 由于设备配网采用了3代不用的配网协议,虽然3代配网方式都可以互相兼容,但开发者为了提高配网的效率,需要提前清楚设备所遵循的配网协议,在接口中填入。
  2. 该接口只要有一个设备接入局域网就直接返回了,多个设备同时配置时并不能保证所有设备都可以成功接入局域网。
  3. 在部分路由器下,由于配网发包速度较快,路由器负载过高,导致设备无法从路由器获取到DHCP分配到的 IP,从而导致配网失败,返回 -4000。针对这一情况,开发者需要自行通过设备发现接口进行判断是否有新设备发现。
    public static BLDeviceConfigResult deviceConfig(BLDeviceConfigParam deviceConfigParam, int timeout);

请求参数

参数名称 参数类型 备注 是否必须
deviceConfigParam BLDeviceConfigParam 设备配网参数,具体如下
timeout int 设备配网超时时间,默认 75s

BLDeviceConfigParam 说明

参数名称 参数类型 备注 是否必须
ssid String 配网Wi-Fi的SSID
password String 配网Wi-Fi的密码
gatewayaddr String 配网Wi-Fi的网关地址
version int 配网协议版本,默认为2

返回参数

BLDeviceConfigResult 说明

参数名称 参数类型 备注 是否返回
mac String 配网设备的MAC地址 部分产品返回全为 0
did String 配网设备的did 部分产品返回全为 0
devaddr String 配网设备的局域网地址

2.2 设备AP方式配网

AP 方式进行设备网络配置,首先需要设备进入 AP 广播模式,手机端连接到该 AP 中,然后再进行后续接口调用。

通过下述接口,获取到设备能够连接到的 Wi-Fi 列表:

public static BLGetAPListResult deviceAPList(int timeOut);

请求参数

参数名称 参数类型 备注 是否必须
timeout int 扫描超时时间,建议大于 5s

返回参数

BLGetAPListResult 说明

参数名称 参数类型 备注
list List 搜索到的AP信息列表

BLAPInfo 说明

参数名称 参数类型 备注
ssid String AP 对应的SSID
rssi int AP 对应的信号强度
type int AP 对应的加密方式

然后指定上述接口获取到的某一 Wi-Fi 进行配置:

public static BLAPConfigResult deviceAPConfig(String ssid, String password, int type, BLConfigParam configParam);

配置完成之后,开发者需要自行通过设备发现接口进行判断是否有新设备发现。

2.3 设备局域网发现

SDK可以发现在同一个局域网内符合 BroadLink 相关设备协议的网络设备。 由于该扫描耗时,且单一次扫描无法做到局域网内所有设备都能扫描到,所以SDK采用开启后台线程,发现设备后通过回调的方式再上报给开发者。

2.3.1 开启/关闭设备扫描

public static void startProbe(int probeInterval);
public static void stopProbe();

请求参数

参数名称 参数类型 备注 是否必须
probeInterval int 扫描时间间隔 是,默认为 3000ms

2.3.2 扫描到设备回调

通过设置回调接口类 BLDeviceScanListener,设备每次扫描到新设备之后都会上报。

public static void setOnDeviceScanListener(BLDeviceScanListener scanListener);

public abstract class BLDeviceScanListener {
    public abstract void onDeviceUpdate(BLDNADevice device, boolean isNewDevice);
}

BLDNADevice 设备信息说明

参数名称 参数类型 备注
did String 设备的唯一 id,用于区分每个不同的设备
mac String 设备的MAC地址
pid String 设备的产品 id,用于归类同一产品的设备
name String 设备的名称
type int 设备类型
lock bool 设备是否锁定, 若为true,则不会再被扫描到
newconfig bool 设备是否是新配置设备
password int 一代设备控制密码
id int 设备控制 id — 回调无法获取,需要手动 pair,再设置到这里
key String 设备控制密钥 — 回调无法获取,需要手动 pair,再设置到这里
state int 设备在线状态
lanaddr String 设备所在局域网IP地址
freshStateTime int 设备上一次扫描到的刷新时间
pDid String 如果是子设备的话,子设备所属的父设备的ID
extend String 扩展信息
ownerId String 设备所有者,一般是familyId
deviceId String 设备id,在原来did的基础上增加ownerId信息,若ownerId未设置则等价于did,只读属性

注意:

  1. SDK每一次扫描到设备之后都会通过 onDeviceUpdate 接口上报
  2. onDeviceUpdate 接口内的参数 isNewDevice,是指设备是否被SDK添加过
  3. 可以通过查看 BLDNADevice device 的设备信息 newConfig 属性判断扫描到的设备是否是新配置的设备

2.4 设备添加

为了能够更加方便的控制设备,设备需要主动添加到SDK内一次,SDK会缓存设备的相关信息,而在后续的设备操作中,只需要传入设备的唯一 did 即可。 同时SDK会对添加SDK里的设备状态进行维护查询。 如果设备不再需要在SDK里控制了,则需要主动删除相关的设备 did 。

public static void addDevice(BLDNADevice device);
public static void addDevice(ArrayList<BLDNADevice> listDevice);

注意:

  1. 不论是Wi-Fi设备还是子设备,要使用SDK对其进行控制,都必须先 addDevice 将其添加到SDK中才可以进行后续操作。

2.5 设备配对

为了能够安全的控制设备,每一个符合 BroadLink 协议的设备都会生成一个控制的 ID 和 Key ,
在设备不重置复位的情况下,该控制的 Key 都是唯一的。如果设备复位重置,则会重新生成一个新的控制 ID 和 Key 。

public static BLPairResult pair(BLDNADevice device, BLConfigParam configParam);

注意:

  1. 注意该接口只能在与设备在同一个局域网内才能 pair 成功
  2. 如果在设备控制的时候,返回接口为 -7, 请再次调用此接口获取最新的控制的 ID 和 Key
  3. 获取到的 ID 和 key ,需要设置到 device 的信息中

2.6 设备控制 - 数据透传

该种方式下,SDK 仅将应用发送的数据原封不动的发送至设备上,且设备返回的数据也同样不做处理直接回传给应用。

public static BLPassthroughResult dnaPassthrough(String deviceId, String sDeviceId, byte[] data, BLConfigParam configParam);

请求参数

参数名称 参数类型 备注 是否必须
did String 控制设备的did
sDid String 如果是子设备的话,子设备的did, 可以为空
data byte[] 控制数据
configParam BLConfigParam 配置参数,可为空

返回参数

BLPassthroughResult 说明

参数名称 参数类型 备注
data byte[] 控制返回数据

2.7 设备控制 - 脚本方式

设备脚本包含有设备的相关信息,标准的控制指令等。 由于同一类的产品型号Pid的产品脚本都是相同的,所以同一类的产品只需要下载一份脚本即可。

2.7.1 脚本版本查询

设备脚本均包含版本信息,如果版本更新,请重新下载脚本

public static BLQueryResoureVersionResult queryScriptVersion(List<String> pidList);

请求参数

参数名称 参数类型 备注 是否必须
pidList List 查询设备的pid列表

返回参数

BLQueryResoureVersionResult 说明

参数名称 参数类型 备注
versions List 版本信息列表

BLResourceVersion 说明

参数名称 参数类型 备注
version String 版本
pid String 设备pid

2.7.2 脚本下载

public static BLDownloadScriptResult downloadScript(String pid);

请求参数

参数名称 参数类型 备注 是否必须
pid String 下载设备产品ID

返回参数

BLDownloadScriptResult 说明

参数名称 参数类型 备注
savePath String 脚本保存路径

注意:

  1. 该接口需要下载文件,耗时较长
  2. 脚本下载如果返回 403,请确认 License 里是否已经添加该设备
  3. 脚本下载如果返回 404,请确认下载平台上是否存在该脚本,确认下载平台为新平台或者老平台。查看该参数 BLConfigParam.CONTROLLER_SCRIPT_DOWNLOAD_VERSION

2.7.3 脚本信息获取

脚本信息(Profile) 包含有设备的相关信息,标准的控制指令等。 SDK会缓存读取到的Profile信息,如果脚本存在更新,Profile也会更新,则需要手动清除掉缓存的Profile信息。

public static BLProfileStringResult queryProfileByPid(String pid, String profilePath);

请求参数

参数名称 参数类型 备注 是否必须
pid String 查询设备的pid
profilePath String 脚本保存文件 否,若为空,则查找默认路径

返回参数

BLProfileStringResult 说明

参数名称 参数类型 备注
profile String Profile信息

2.7.4 设备控制 - 脚本方式

该种方式下,设备控制指令必须符合 SDK 的指令规则。 SDK 将应用层发送的指令通过脚本解析成设备识别的控制命令发送至设备, 且设备返回的数据也会通过脚本处理成符合规则的指令回传给应用。

开发者通过设置符合SDK接口的数据,将相应的 valueparam 填充到SDK接口内, SDK再重新组装成符合标准的JSON控制命令,再通过传入的控制脚本解析成指令发送给模块, 且模块返回的数据也会通过脚本处理成符合规则的指令回传给应用。

public static BLStdControlResult dnaControl(String deviceId, String sDeviceId, BLStdControlParam stdControlParam, BLConfigParam configParam);

请求参数

参数名称 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
stdControlParam BLStdControlParam 控制数据类
configParam BLConfigParam 配置参数,可为空

返回参数

BLStdControlResult 说明

参数名称 参数类型 备注
data BLStdData 控制返回数据

BLStdData 说明

参数名称 参数类型 备注
act String set / get 操作,默认为 set
params ArrayList<String> 控制变量列表
vals ArrayList<ArrayList<Value>> 控制变量对应的变量值列表

2.7.5 设备控制 - 通用命令

SDK 提供通用控制命令,由 APP 自行组织命令和内容,通过 SDK 发送给设备。

public static String dnaControl(String deviceId, String sDeviceId, String dataStr, String cmd, BLConfigParam configParam)

请求参数

参数名称 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
dataStr String 控制数据
cmd String 控制命令
configParam BLConfigParam 配置参数,可为空

返回参数

参数名称 参数类型 备注
String 控制返回数据

cmd 和 dataStr 有较多的格式,具体请参考: 设备控制Command详解

2.8 通用定时任务

注意:

插座类SP设备和红外遥控类RM设备的定时不支持此接口,需要采用上一节Demo的形式进行配置。

如果设备的 Profile 支持 dev_task 家族 相关命令,则设备支持使用此接口来设置任务。SDK支持对设备的任务的增删改查的相关功能。 新增/修改设备的任务,对设备的控制都是通过脚本实现的,所以在接口中要实现对设备的任务控制与设备脚本控制的命令 stdData 规则相同。

任务类型taskType

任务名称 任务类型值 任务参数 说明
普通任务 0 timerInfo 普通的定时任务
延迟任务 1 timerInfo 延迟执行的任务,同普通任务,延迟效果需要UI控制
周期任务 2 periodInfo 周期执行的任务
循环任务 3 cycleInfo 循环任务,单位时间里循环执行两个不同的命令
防盗任务 4 cycleInfo 随机执行两个不同的任务

2.8.1 普通任务/延迟任务

普通任务和延迟任务极其类似,分别支持16组不同的定时任务。延迟任务的效果需要UI来显示控制。

采用如下接口增加或者修改任务:

public static BLQueryTaskResult updateTask(String deviceId, String sDeviceId,  int taskType, 
        boolean isNew, BLTimerInfo task, BLStdData stdData, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
taskType int 任务类型,本接口只支持 0/1
isNew bool true - 新增任务 , false - 修改任务
task BLTimerInfo 具体参数见下表
stdData BLStdData 任务需要执行的命令,同设备控制的命令

*BLTimerInfo*:

参数名称 参数类型 说明
index int 任务索引值,添加任务时无须设置,修改任务则须指定该值
enable bool 任务是否使能
year month day int 定时执行的年份 月份 日期
hour min sec int 定时执行的时 分 秒

2.8.2 周期任务

周期任务是以周为单位,每周指定日期执行命令

public static BLQueryTaskResult updateTask(String deviceId, String sDeviceId, 
        boolean isNew, BLPeriodInfo task, BLStdData stdData, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
isNew bool true - 新增任务 , false - 修改任务
task BLPeriodInfo 具体参数见下表
stdData BLStdData 任务需要执行的命令,同设备控制的命令

*BLPeriodInfo*:

参数名称 参数类型 说明
index int 任务索引值,添加任务时无须设置,修改任务则须指定该值
enable bool 任务是否使能
repeat int[] 任务执行周几 例如 [1,3,5] 代表每周一、三、五执行
hour min sec int 任务执行的时 分 秒

2.8.3 循环任务/防盗任务

循环任务/防盗任务是以周为单位,在固定的时间段内,执行不同的两条命令

注意:

循环任务/防盗任务现只支持2组任务的设置,如果修改任务,index必须为0/1

public static BLQueryTaskResult updateTask(String deviceId, String sDeviceId,  int taskType, boolean isNew, BLCycleInfo task, BLStdData stdData1, BLStdData stdData2, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
taskType int 任务类型,本接口只支持 34
isNew bool true - 新增任务 , false - 修改任务
task BLCycleInfo 具体参数见下表
stdData1 BLStdData 任务需要执行的第一个命令
stdData2 BLStdData 任务需要执行的第二个命令

*BLCycleInfo*:

参数名称 参数类型 说明
index int 任务索引值,添加任务时无须设置,修改任务则须指定该值
enable bool 任务是否使能
repeat int[] 任务执行周几 例如 [1,3,5] 代表每周一、三、五执行
cmd1duration int 命令1 执行的时间
cmd2duration int 命令2 执行的时间
start_hour start_min start_sec int 任务执行时间段的开始的时 分 秒
en_hour end_min end_sec int 任务执行时间段的结束的时 分 秒

2.8.4 任务列表查询

public static BLQueryTaskResult queryTask(String deviceId, String sDeviceId, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空

返回值

BLQueryTaskResult

参数名 参数类型 备注
timer BLTimerInfo[] 普通任务列表, 最大值为 16 组
delay BLTimerInfo[] 延迟任务列表, 最大值为 16 组
period BLPeriodInfo[] 周期任务列表, 最大值为 16 组
cycle BLCycleInfo[] 循环任务列表, 最大值为 2 组
random BLCycleInfo[] 防盗任务列表, 最大值为 2 组

2.8.5 任务删除

任务删除需要指定任务类型和任务的索引。 具体需要从任务列表查询获取。

public static BLQueryTaskResult delTask(String deviceId, String sDeviceId, int taskType, int index, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
taskType int 任务类型,本接口支持 0/1/2/3/4
index int 任务在任务列表里的索引

2.8.6 任务命令查询

任务命令查询需要指定任务类型和任务的索引。获取实际执行的命令的值。

public static BLTaskDataResult queryTaskData(String deviceId, String sDeviceId, int taskType, int index, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 控制设备的deviceId
sDeviceId String 如果是子设备的话,子设备的deviceId, 可以为空
taskType int 任务类型,本接口支持 0/1/2/3/4
index int 任务在任务列表里的索引

2.8.7 定时显示时区设置

由于设备端使用的时区总是处于东八区,所以在定时设置喝显示时,需要根据APP设置的时区,转换相应的时差值,再下发给设备端。

​ Ps: 如果没有设置该值,SDK会自动根据手机当前时间和设备时间的差值进行换算。

iOS 端设置全局变量 BLConfigParam 里的参数:

/// 设置APP时区,用于定时设置转换
/// 如果是东八区,则设置为 8。如果是西五区,则设置为 -5 
@property (nonatomic, copy) NSNumber *utcTimeZone;

Android 端调用如下接口:

/**
 * 设置用户时区
 * 如果是东八区,则设置为 8。如果是西五区,则设置为 -5 
 */
public static void setUtcTimeZone(int timeZone);

/**
 * 获取用户时区
 */
public static int getUserTimeZone();

2.9 设备状态查询

查询单个设备状态

对于已经添加到SDK里的设备,SDK会自动查询设备的状态(本地,远程,离线),而没有添加到SDK到设备,如果使用该接口查询则会返回未知。 如果SDK开启了 Probe 线程,当 Probe 扫描到设备之后,设备状态则会置为本地. 如果SDK未开启 Porbe 线程,或者 Probe 不到设备,SDK则会向云端请求查询该设备的状态是远程在线/离线。

public static int queryDeviceState(String deviceId);

批量查询设备云端在线状态

已联网设备会和 BroadLink 云端保持心跳连接,则为设备在线; 如果长时间心跳消失,则认为是设备离线。 本接口可以批量查询设备的在线状况,使用前需要确认 lid + devinfo.ibroadlink.com 该服务是否已经部署。

public static BLQueryDeviceStatusResult queryDeviceOnServer(ArrayList<BLDNADevice> listDevice);

参数说明

参数名 参数类型 备注 是否必须
listDevice ArrayList 设备信息列表

返回值说明

[
    {
        "did":"xxxx",       // 设备唯一did
        "status": 0         // 设备在线状态。 0 - 离线, 1 - 在线
    }
]

2.10 设备时间查询

由于设备固件无法根据实时根据时区来调整时间,所以设备里面查询到的时间都是北京时间(东八区时),如果开发者需要在应用里显示或者设置设备时间相关操作,则需要先获取到设备时间,再转化为当地时间。

public static BLDeviceTimeResult queryDeviceTime(String deviceId);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 设备id

2.11 设备上报数据查询

部分设备(例如带计量功能的插座)会定时向服务端上报数据,通过该接口则可以查询到指定时间内上报的所有数据。

注意:

该接口现仅支持计量类插座查询电量统计。

public static BLBaseBodyResult queryDeviceData(String deviceId, String familyId, String startTime, String endTime, String type)

参数说明

参数名 参数类型 备注 是否必须
deviceId String 查询设备的唯一id
familyId String 查询设备所在家庭ID,可以为空
startTime String 查询起始时间 格式 “yyyy-MM-dd_HH:mm:ss”
endTime String 查询结束时间 格式 “yyyy-MM-dd_HH:mm:ss”
type String 数据上报的报表类型

type参数说明

参数值 参数说明
fw_currentstate_v1 设备属性(默认报表)
fw_energystatus_v1 通用电工历史数据
fw_energystats_v1 通用电工 电量统计
fw_spminielec_v1 SP Mini 电量统计
fw_spminiswitch_v1 SP Mini 开关记录
fw_s1push_v1 S1 推送数据

返回值说明

返回值为json格式字符串,根据字符串解析获取相关信息

2.12 固件升级

开发者如果想要升级指定设备的固件版本,需要先搭建固件下载的服务器,将该服务器域名传人到指定接口内。

public static BLBaseResult updateFirmware(String deviceId, String url, BLConfigParam configParam);

参数说明

参数名 参数类型 备注 是否必须
deviceId String 升级设备的唯一id
url String 升级固件URL地址

返回值说明

注意:

2.13 获取 RMAC 红外码脚本信息

RMAC 脚本为 Lua 格式, 需要使用该接口获取RMAC红码脚本信息

public static BLIRCodeInfoResult queryRMACIRCodeInfomation(String scriptPath)

参数说明

参数名 参数类型 备注 是否必须
scriptPath String 脚本全路径名

返回值说明

参数名 参数类型 备注
infomation String 脚本信息 JSON格式字符串

2.14 获取 RMAC 发送红外码 Hex格式

RMAC 脚本为 Lua 格式, 需要使用该接口获取 RMAC 发送红外码 Hex格式

public static BLIRCodeDataResult queryRMACIRCodeData(String scriptPath, BLQueryIRCodeParams params)

参数说明

参数名 参数类型 备注 是否必须
scriptPath String 脚本全路径名
params BLQueryIRCodeParams 空调设置参数

返回值说明

参数名 参数类型 备注
freq int 红外码发送频率
ircode String 发送红外码 Hex格式

2.15 计算日出日落时间

获取指定日期,经度和纬度,获取当天日出日落时间

public BLSunriseResult calulateSunriseTime(String date, double longitude, double latitude)

参数说明

参数名 参数类型 备注 是否必须
date String 日期,格式如: “2018-01-01”
longitude double 经度
latitude double 纬度

返回值说明

参数名 参数类型 备注
sunrise String 日出时间,格式如:01:04:11(UTC)
sunset String 日落时间,格式如:19:01:29(UTC)

2.16 设备连接服务器查询

获取设备连接到的服务器相关信息,该接口需要设备固件支持相关命令才能查询。

public BLQueryDeviceConnectServerResult queryDeviceConnectServerInfo(String deviceId)

参数说明

参数名 参数类型 备注 是否必须
deviceId String 查询设备的唯一id

返回值说明

参数名 参数类型 备注
serverlist Array 服务器信息列表

ServerBean 说明

参数名 参数类型 备注
host String 服务器域名
ip String 服务器IP地址

2.17 获得已添加到sdk的设备列表

查询已添加到sdk中的设备列表

 public ArrayList<BLDNADevice> queryDeviceAddedList()

参数说明

参数名 参数类型 备注 是否必须

返回值说明

参数名 参数类型 备注
ArrayList 设备信息列表