添加产品 打开边缘网关 http://localhost:3000依次点击 子设备管理 > 产品开发 > 添加 输入您刚刚创建的产品信息填入： PID：产品的 PID 产品名称：根据需要填写为了便于区分可以填写插座 xxx 产品描述：根据需要填写 驱动库名称：模糊搜索比如可以模糊搜索 modbus 添加产品功能点 产品添加功能点依次点击 子设备管理 > 产品开发 > 选择刚刚创建的产品 > 功能点

业务能力介绍 通过设备管理业务 SDK可以获取类似以下信息： 设备 ID 设备时区 设备 IP 地址 设备信号强度 设备连接方式 设备 MAC 地址 设备本地 IP 地址 设备 Wi-Fi 信号强度 设备信道仅支持 Zigbee 设备 设备厂商名称仅支持第三方 Matter 设备 设备 ICCIDIntegrated Circuit Card Identification Number 设备 RSRPReference Signal Received Power值仅支持 LTE

如需查看涂鸦子设备可前往 设备管理 非涂鸦子设备 指由 TuyaOS 网关接入的非涂鸦的子设备泛指没有采用涂鸦模组的子设备仅对部分客户适用 前提条件 您已经创建至少一款智能产品详情请参考 创建产品 您至少有一台已激活的产品设备 操作步骤 登录 涂鸦开发者平台 在左侧导航栏选择 产品 > 设备 > 设备列表字段说明 列表字段 含义说明 设备名称 指通过网关设备配网或注册完成后在 App 端展示的子设备名称

模块是对设备配套功能的说明配套功能指的是除对设备控制之外设备所具备的能力例如目前已经开发的设备信息设备定时和设备的群组管理 后续将持续开放更多能力包括但不限于设备评价设备配件管理设备网络检测和设备备用网络等帮助您丰富除设备控制之外的其他设备能力

本文介绍设备信息的获取和管理能力等安卓版接口信息包含设备初始化设备监听设备控制查询设备信息修改设备名称移除设备设备恢复出厂设置查询 Wi-Fi 信号强度回收设备资源等 功能说明 设备相关的返回数据都采用异步消息的方式通知接收者 同时也提供了控制指令下发设备固件升级的接口 IThingDevice 类提供了设备状态通知能力通过注册回调函数您可以方便的获取设备数据接受设备移除设备上下线手机网络变化的通知 IThingGateway 类提供了 Zigbee 网关相关的操作包括控制查询和监听子设备状态的能力 DeviceBean 数据类型： 属性 类型 说明 devId String 设备 ID name String 设备名称 iconUrl String 图标地址 schema String 设备控制数据点的类型信息 productId String 产品 ID同一个产品 ID 的设备的 schema 信息一致 timezoneId String 设备所在的时区 category String 设备类型 pv String 网关协议版本 bv String 网关通用固件版本 time Long 设备激活时间 schemaMap Map schema 的缓存数据 dps Map 设备功能点数据信息key 是 DP IDvalue 是取值详情请参考 设备功能点 章节 getIsOnline Boolean 设备是否在线指局域网或者云端在线 isLocalOnline Boolean 设备的局域网在线状态 supportGroup Boolean 设备是否支持群组如果不支持请到 涂鸦开发者平台 开启此功能 isShare Boolean 是否是分享的设备 virtual Boolean 是否是虚拟设备 isZigBeeWifi Boolean 是否是 Zigbee 网关设备 hasZigBee Boolean 是否有 Zigbee 设备 nodeId String 用于网关和子设备类型的设备属于子设备的一个属性标识其短地址 ID一个网关的子设备的 nodeId 都是唯一的 meshId String 用于网关和子设备类型的设备属于子设备的一个属性标识其网关 ID lon String 设备所在经度信息 lat String 设备所在纬度信息 注意：设备控制时如果涉及到经纬度 lon 和 lat请在配网前调用 setLatAndLong 设置经纬度： ThingSdk.setLatAndLongString latitude String longitude 初始化设备 初始化设备控制类 根据设备 ID 初始化设备控制类 IThingDevice ThingOSDevice.newDeviceInstanceString devId 参数说明 参数 说明 devId 设备 ID Java 示例 IThingDevice mDevice ThingOSDevice.newDeviceInstancedeviceBean.getDevId 监听设备 注册设备监听 IThingDevice 提供设备相关信息的监听包含： DP 数据 设备名称 设备在线状态和设备移除 void IThingDevice.registerDevListenerIDevListener listener 参数说明 参数 说明 listener 设备状态监听 IDevListener 接口 public interface IDevListener { / DP 数据更新 @param devId 设备 ID @param dpStr 设备发生变动的功能点为 JSON 字符串数据格式：{"101": true} / void onDpUpdateString devId String dpStr / 设备移除回调 @param devId 设备id / void onRemovedString devId / 设备上下线回调如果设备断电或断网服务端将会在3分钟后回调到此方法 @param devId 设备 ID @param online 是否在线在线为 true / void onStatusChangedString devId boolean online / 网络状态发生变动时的回调 @param devId 设备 ID @param status 网络状态是否可用可用为 true / void onNetworkStatusChangedString devId boolean status / 设备信息更新回调 @param devId 设备 ID / void onDevInfoUpdateString devId } 说明：其中设备功能点说明请参考 设备功能点 章节 Java 示例 mDevice.registerDevListenernew IDevListener { @Override public void onDpUpdateString devId String dpStr { } @Override public void onRemovedString devId { } @Override public void onStatusChangedString devId boolean online { } @Override public void onNetworkStatusChangedString devId boolean status { } @Override public void onDevInfoUpdateString devId { } } 注意：请勿使用 void registerDeviceListenerIDeviceListener listener 方法此方法需要配合标准设备使用该 API 暂未开放使用 取消设备监听 当不需要监听设备时取消设备监听 接口说明 void IThingDevice.unRegisterDevListener Java 示例 mDevice.unRegisterDevListener 查询设备信息 查询单个 DP 数据查询后的数据会通过 IDevListener.onDpUpdate 接口进行异步回调 注意：该接口主要是针对不主动发送数据的设备 DP例如倒计时信息查询常规查询 DP 数据值时可通过 DeviceBean 中的 getDps 获取 void IThingDevice.getDpString dpId IResultCallback callback Java 示例 mDevice.getDpdpId new IResultCallback { @Override public void onErrorString code String error { } @Override public void onSuccess { } } 修改设备名称 重命名设备并支持多设备同步 // 修改设备名称 void IThingDevice.renameDeviceString nameIResultCallback callback Java 示例 mDevice.renameDevice"设备名称" new IResultCallback { @Override public void onErrorString code String error { // 修改设备名称失败 } @Override public void onSuccess { // 修改设备名称成功 } } 后续步骤 重命名成功后IDevListener.onDevInfoUpdate 会收到通知调用以下方法可以获取最新数据然后刷新设备信息即可 ThingOSDevice.getDataInstance.getDeviceBeanString devId 移除设备 从用户设备列表中移除设备 void IThingDevice.removeDeviceIResultCallback callback Java 示例 mDevice.removeDevicenew IResultCallback { @Override public void onErrorString errorCode String errorMsg { } @Override public void onSuccess { } } 恢复出厂设置 设备恢复出厂设置后设备的相关数据会被清除掉并重新进入待配网状态如果是 Wi-Fi 设备默认进入 Wi-Fi 快连模式 void IThingDevice.resetFactoryIResultCallback callback Java 示例 mDevice.resetFactorynew IResultCallback { @Override public void onErrorString errorCode String errorMsg { } @Override public void onSuccess { } } 查询 Wi-Fi 信号强度 查询设备 Wi-Fi 的信号强度 void IThingDevice.requestWifiSignalWifiSignalListener listener Java 示例 mDevice.requestWifiSignalnew WifiSignalListener { @Override public void onSignalValueFindString signal { } @Override public void onErrorString errorCode String errorMsg { } } 回收设备资源 应用或者 Activity 关闭时可以调用此接口回收设备占用的资源 void IThingDevice.onDestroy Java 示例 mDevice.onDestroy 初始化网关设备 初始化网关控制类 根据设备 ID 初始化网关设备控制类 IThingGateway ThingOSDevice.newGatewayInstanceString devId 参数说明 参数 说明 devId 设备 ID Java 示例 IThingGateway mGateway ThingOSDevice.newGatewayInstancedeviceBean.getDevId 监听子设备 注册子设备监听 IThingGateway 提供设备相关信息的监听包含： DP 数据 子设备名称 子设备在线状态和设备移除 void IThingGateway.registerSubDevListenerISubDevListener listener 参数说明 参数 说明 listener 设备状态监听 IDevListener 接口 public interface ISubDevListener { / 子设备DP 数据更新 @param nodeId 子设备 ID @param dps 设备发生变动的功能点为 JSON 字符串数据格式：{"101": true} / void onSubDevDpUpdateString nodeId String dps / 子设备移除回调 @param devId 子设备id / void onSubDevRemovedString devId / 子设备添加回调 @param devId 子设备id / void onSubDevAddedString devId / 子设备上下线回调如果设备断电或断网服务端将会在3分钟后回调到此方法 @param onlineDeviceIds 在线子设备 ID @param offlineDeviceIds 离线子设备 ID / void onSubDevStatusChangedList<String> onlineDeviceIds List<String> offlineDeviceIds / 子设备信息更新回调 @param devId 子设备 ID / void onSubDevInfoUpdateString devId } 说明：其中设备功能点说明请参考 设备功能点 章节 Java 示例 mGateway.registerSubDevListener new ISubDevListener { void onSubDevDpUpdateString nodeId String dps { } void onSubDevRemovedString devId { } void onSubDevAddedString devId { } void onSubDevInfoUpdateString devId { } void onSubDevStatusChangedList<String> onlineDeviceIds List<String> offlineDeviceIds { } } 取消子设备监听 当不需要监听子设备时取消子设备监听 接口说明 void IThingGateway.unRegisterSubDevListener Java 示例 mGateway.unRegisterSubDevListener 查询网关子设备列表 可以获取网关下子设备的列表 接口说明 void IThingGateway.getSubDevListIThingDataCallback<List<DeviceBean>> callback Java 示例 mGateway.getSubDevListnew IThingDataCallback<List<DeviceBean>> { @Override public void onSuccessList<DeviceBean> result { } @Override public void onErrorString errorCode String errorMessage { } } 回收网关资源 应用或者 Activity 关闭时可以调用此接口回收网关设备占用的资源 void IThingGateway.onDestroy Java 示例 mGateway.onDestroy

本次实践针对一个 虚拟智慧校园通过新版 IoT Core OpenAPI 完成 设备控制 和 设备管理涂鸦 IoT Core 核心接口能够实现基于空间的设备分类基于群组的设备批量管理以及设备相关属性定时任务的设定联动场景的触发等操作适用的开发环境为 IntelliJ IDEA 和 API Explorer 场景分析 本文模拟了远程管理 虚拟智慧校园 中的一系列智能设备介绍如何基于 IoT Core 开放的 空间设备群组联动定时 五个方面的接口实现对设备的管理和操作

主要用于管理接入涂鸦开发者平台的产品设备包含设备统计在离线状态监控生产信息查看等 功能支持查询以下设备数据： 查询您自己的产品 切换到被授权的空间后可查询空间内授权的产品 前置条件 您已经创建至少一款智能产品详情请参考 创建产品 您至少有一台已激活的产品设备 操作说明 主要包含数据查看列表和相关管理操作 登录 涂鸦开发者平台 在左侧导航栏选择 产品 > 设备 > 设备列表字段说明 列表字段 含义说明 设备名称 指配网或注册完成后在 App 端展示的设备名称用户可在 App 端进行修改或者如果进行 PaaS 对接可调用 API 进行修改 设备 ID 指设备配网或注册完成后生成的云端设备唯一标识 设备状态 指包含设备的绑定状态和在离线状态其中绑定状态代表当前设备是否已被人使用在离线状态代表当前设备是否处于正常运行情况关于设备绑定模式介绍可查看 设备绑定模式 生产 UUID 指用于模组生产烧录的设备编号也是设备的唯一凭证 所属产品/产品 ID 指该设备所属的产品名称和产品 IDPID 设备类型 指进行产品开发时设备的类型包含普通设备网关设备和网关子设备 设备 SN 码 指部分设备激活上线时上报的设备码仅支持已上报数据的设备展示 首次激活时间 指设备首次配网或注册时间设备激活指设备配网或注册完成后在平台产生一条设备实例记录后则定义为激活若为子设备则一般由网关设备代理激活 最近激活时间 指设备最近的配网或注册时间 详情 单击 操作 栏的 详情可查看设备的基本信息运行状态以及绑定用户状态详情 日志 单击 操作 栏的 日志可查看设备运行中产生的数据日志用于数据查看和问题排查 绑定二维码 针对产品创建时通过 生态设备接入 方式接入的设备单击 操作 栏的 绑定二维码可查看绑定二维码主要用于智能生活 App 或智慧行业 App 绑定 若绑定失败可查看 设备绑定范围配置说明 管理子设备 针对设备类型为网关设备支持管理子设备 在 操作 栏中单击 管理子设备 查询该网关下的子设备清单 数据导出 支持导出设备数据目前因为数据安全限制仅支持一次导出最多 5000 条数据其中美国数据中心可以支持导出 10000 条 数据分区 为符合各地区数据安全规定涂鸦开发者平台部署了六大数据中心包含中国数据中心美西数据中心中欧数据中心印度数据中心美东数据中心和西欧数据中心同一个产品可以在不同数据中心进行设备配网激活切换数据中心查看对应数据中心的数据 若出现切换数据中心失败请查看当前网络是否支持访问全球外网 更多操作 可查看 设备 操作说明包含子设备调试固件 OTA 和固件管理等

IoT账号下所有产品下的设备数据都可以查询到设备管理只是设备信息如果要查设备日志包括上报下发上下线等记录请查询设备日志 相关知识：如何查看设备日志 注：如设备管理工具提醒无权限点击查看详情如何获取授权API调用权限

设备模块 获取设备详情 请求地址 action: industry.device.info  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 请求示例 { "action":"industry.device.info" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Object 返回结果失败为空 result说明 参数名 类型 说明 id String 设备 ID uuid String 设备 UUID category String 产品品类 name Integer 设备名称 product_id Integer 产品 ID product_name String 产品名称 local_key String 密钥 sub Boolean 是否为子设备 asset_id String 资产 ID ip String 设备 IP lon String 经度 lat String 纬度 model String 产品型号 time_zone String 时区 active_time Long 激活时间 update_time Long 更新时间 create_time Long 初次配网时间 online Boolean 在线状态 icon String 设备图标 修改设备信息 请求地址 action: industry.device.update  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 name String 设备名称 是 请求示例 { "action":"industry.device.update" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" "name":"香薰机" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Boolean 返回结果失败为空 删除设备 请求地址 action: industry.device.delete  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 请求示例 { "action":"industry.device.delete" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Boolean 返回结果失败为空 批量移除设备 请求地址 action: industry.device.batch.delete  params请求参数 参数名 类型 说明 是否必填 device_ids String 设备 ID 列表以半角逗号隔开 是 请求示例 { "action":"industry.device.batch.delete" "access_token": "xxxxxx" "params":{ "device_ids":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Boolean 返回结果失败为空 设备恢复出厂设置 请求地址 action: industry.device.restore.setting  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 请求示例 { "action":"industry.device.restore.setting" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Boolean 返回结果失败为空 获取设备标准状态 请求地址 action: industry.device.status  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 请求示例 { "action":"industry.device.status" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result List 返回结果失败为空 result说明 参数名 类型 说明 code Integer 状态码 value Object 状态值 批量获取设备标准状态 请求地址 action: industry.device.batch.status  params请求参数 参数名 类型 说明 是否必填 device_ids String 设备 ID 列表以半角逗号隔开 是 请求示例 { "action":"industry.device.batch.status" "access_token": "xxxxxx" "params":{ "device_ids":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Object 返回结果失败为空 result说明 参数名 类型 说明 id String 设备 ID status List 设备状态列表 status说明 参数名 类型 说明 code String 状态码 value Object 状态值 获取设备支持的指令集 请求地址 action: industry.device.functions  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 请求示例 { "action":"industry.device.functions" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Object 返回结果失败为空 result说明 参数名 类型 说明 category String 产品品类 functions List 指令集 functions说明 参数名 类型 说明 name String 指令名称 desc String 描述 code String 指令 type String 指令类型 values String 指令入参范围 获取品类支持的指令集 请求地址 action: industry.device.category.functions  params请求参数 参数名 类型 说明 是否必填 category String 产品类别 是 请求示例 { "action":"industry.device.category.functions" "access_token": "xxxxxx" "params":{ "category":"xx" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Object 返回结果失败为空 result说明 参数名 类型 说明 category String 产品品类 functions List 指令集 functions说明 参数名 类型 说明 name String 指令名称 desc String 描述 code String 指令 type String 指令类型 values String 指令入参范围 获取设备规格属性包含指令集状态集 请求地址 action: industry.device.functions.status  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 请求示例 { "action":"industry.device.functions.status" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Object 返回结果失败为空 result说明 参数名 类型 说明 category String 产品品类 functions List 指令集 status List 状态集 functions说明 参数名 类型 说明 name String 指令名称 desc String 描述 code String 指令 type String 指令类型 values String 指令入参范围 status说明 参数名 类型 说明 name String 状态名称 code String 状态码 type String 类型 values String 入参范围 设备指令下发 请求地址 action: industry.device.execute.commands  params请求参数 参数名 类型 说明 是否必填 device_id String 设备 ID 是 commands List 下发指令 是 validity Long DP 缓存时间 否 commands说明 参数名 类型 说明 是否必填 code String 下发的标准指令码 是 value Object 下发的指令值 是 请求示例 { "action":"industry.device.execute.commands" "access_token": "xxxxxx" "params":{ "device_id":"101120xxxxf3eb7da61f" "commands":[ { "code":"switch" "value":true } ] "validity":xx } } 响应参数 参数名 类型 说明 code Integer 响应码成功为空 success Boolean 是否成功：true：成功false：失败 msg String 请求失败的信息成功为空 t String 响应时间戳 result Boolean 返回结果失败为空

主要提供设备完成配网后的相关操作包含设备状态变化监听设备重命名设备固件升级设备移除设备恢复出厂设置等操作 进行设备操作之前确保已经成功 获取家庭下设备群组 功能说明 相关类： 类名 说明 ThingSmartDevice ThingSmartDeviceModel 设备数据模型 ThingSmartDeviceModel 数据模型： 属性 类型 说明 devId NSString 设备唯一 ID name NSString 设备名称 iconUrl NSString 设备图标 URL isOnline Boolean 设备在线状态此状态包含 Wi-Fi局域网或蓝牙在线状态只要其中任意一个网络在线即为在线 isCloudOnline Boolean 设备 Wi-Fi 在线状态 isLocalOnline Boolean 设备局域网在线状态 isShare Boolean 是否为分享设备 dps NSDictionary 设备功能点数据 dpCodes NSDictionary 设备功能点数据表现为键值code-value形式 schemaArray NSArray 设备 DP 规则信息 productId NSString 设备所对应的产品 ID capability NSUInteger 设备产品能力值 deviceType ThingSmartDeviceModelType 设备类型 supportGroup Boolean 是否支持创建群组 gwType NSString v 代表虚拟设备空代表真实设备 pv NSString 设备协议版本Wi-Fi 协议版本或蓝牙协议版本 lpv NSString 设备局域网协议版本默认为空该字段在设备局域网连接成功后才会有值 latitude NSString 纬度 longitude NSString 经度 localKey NSString 设备通信使用的 key uuid NSString 设备 UUID homeId LongLong 设备所在家庭 ID roomId LongLong 设备所在房间 ID upgrading Boolean 是否在升级中 timezoneId NSString 设备时区 nodeId NSString 设备短地址用于区分网关下子设备的唯一地址非子设备类型值为空 parentId NSString 父设备上一级ID非子设备类型值为空子设备用于寻找对应的网关设备 ID蓝牙 Mesh 子设备为 Mesh ID 或对应的网关设备 ID isMeshBleOnline Boolean 设备蓝牙 Mesh 本地在线状态 devKey NSString 标准蓝牙 Mesh 设备蓝牙通信 key standard Boolean 是否为标准化产品设备如果为标准设备可以使用标准设备控制功能 standSchemaModel ThingSmartStandSchemaModel 设备标准 DP 规则信息 activeTime NSTimeInterval 激活时间 homeDisplayOrder NSInteger 设备序号家庭查询设备列表时可通过该属性进行排序 sharedTime LongLong 分享时间 accessType NSInteger 区分设备的接入方式： 0：涂鸦 DP 接入 1：Matter 协议接入 2：TuyaLink 接入 thingModel ThingSmartThingModel 设备物模型当 accessType 取值为 2 时需要用到在需要使用之前通过 - getThingModelWithSuccess:failure: 或 getThingModelWithProductId:productVersion:success:failure: 查询设备物模型 category NSString 设备品类缩写例如 dj 表示灯具详见 类目 Code 列表 初始化设备 根据设备 ID初始化设备控制类 您需要通过 ThingSmartHome 初始化一个 home 实例然后调用 getHomeDetailWithSuccess:failure: 查询家庭详情只有同步过家庭的详情后初始化设备才能成功 错误的设备 ID 可能会导致初始化失败此时设备的实例返回 nil 接口说明 / 查询设备实例如果当前用户没有该设备将会返回 nil @param devId Device ID @return instance / nullable instancetypedeviceWithDeviceId:NSString devId 参数说明 参数 说明 devId 设备 ID 示例代码 ThingSmartDevice device [ThingSmartDevice deviceWithDeviceId:devId] device.delegate self 设备代理监听 实现 ThingSmartDeviceDelegate 代理协议后您可以在设备状态更变的回调中进行处理刷新 App 设备控制面板的 UI 示例代码 Objective-C： - voidinitDevice { self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] self.device.delegate self } #pragma mark - ThingSmartDeviceDelegate - voiddevice:ThingSmartDevice device dpsUpdate:NSDictionary dps { // 设备的 DP 状态发生变化刷新界面 UI } - voiddeviceInfoUpdate:ThingSmartDevice device { //当前设备信息更新例如设备名称修改设备在线离线状态等 } - voiddeviceRemoved:ThingSmartDevice device { //当前设备被移除 } - voiddevice:ThingSmartDevice device signal:NSString signal { // Wi-Fi 信号强度 } - voiddevice:ThingSmartDevice device otaUpdateStatusChanged:ThingSmartFirmwareUpgradeStatusModel statusModel { // 固件升级状态和升级进度回调 // 推荐在通过 -startFirmwareUpgrade: 升级时使用 } - voiddevice:ThingSmartDevice device firmwareUpgradeProgress:NSIntegertype progress:doubleprogress { // 固件升级进度 // 即将废弃建议在通过 -upgradeFirmware:success:failure: 升级时使用 } - voiddevice:ThingSmartDevice device firmwareUpgradeStatusModel:ThingSmartFirmwareUpgradeStatusModel upgradeStatusModel { // 设备升级状态的回调 // 即将废弃建议在通过 -upgradeFirmware:success:failure: 升级时使用 } Swift： func initDevice { device ThingSmartDevicedeviceId: "your_device_id" device.delegate self } // MARK: - ThingSmartDeviceDelegate func device_ device: ThingSmartDevice dpsUpdate dps: [AnyHashable : Any] { // 设备的 DP 状态发生变化刷新界面 UI } func deviceInfoUpdate_ device: ThingSmartDevice { //当前设备信息更新例如修改设备名称设备在线离线状态等 } func deviceRemoved_ device: ThingSmartDevice { //当前设备被移除 } func device_ device: ThingSmartDevice signal: String { // Wi-Fi 信号强度 } func device_ device: ThingSmartDevice otaUpdateStatusChanged statusModel: ThingSmartFirmwareUpgradeStatusModel { // 普通固件PID 版本升级固件的升级状态和升级进度回调包含单点和蓝牙 Mesh 子设备等 // 推荐在通过 -startFirmwareUpgrade: 升级时使用 // 关于 OTA 的可前往固件升级章节查看 } func device_ device: ThingSmartDevice firmwareUpgradeProgress type: Int progress: Double { // 普通固件的升级进度不包含单点和蓝牙 Mesh 子设备 // 即将废弃建议在通过 -upgradeFirmware:success:failure: 升级时使用 } func device_ device: ThingSmartDevice firmwareUpgradeStatusModel upgradeStatusModel: ThingSmartFirmwareUpgradeStatusModel { // 普通固件的升级状态不包含单点和蓝牙 Mesh 子设备 // 即将废弃建议在通过 -upgradeFirmware:success:failure: 升级时使用 } 查询设备信息 查询单个 DP 数据查询后会通过代理 - voiddevice:ThingSmartDevice device dpsUpdate:NSDictionary dps 回调数据 该接口主要是针对不主动发送数据的设备 DP例如倒计时信息查询常规查询 DP 数据值时可通过 ThingSmartDeviceModel.dps 获取 下发格式详见示例 示例代码 Objective-C： - voidqueryDP { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] // 查询 dpId 是 "1" 的数据 NSDictionary queryDpInfo @{ @"1": [NSNull null] } [self.device publishDps:queryDpInfo mode:ThingDevicePublishModeAuto success:{ NSLog@"query dp success" } failure:NSError error { NSLog@"query dp failure: @" error }] } Swift： func queryDP { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] // 查询 dpId 是 "1" 的数据 let queryDpInfo [ "1": NSNull ] device.publishDpsqueryDpInfo mode: ThingDevicePublishModeAuto success: { print"query dp success" } failure: { error in if let error error { print"query dp failure: error" } } } 修改设备名称 接口说明 - voidupdateName:NSString name success:nullable ThingSuccessHandlersuccess failure:nullable ThingFailureErrorfailure 参数说明 参数 说明 name 设备名称 success 成功回调 failure 失败回调 示例代码 Objective-C： - voidmodifyDeviceName:NSString mame { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] [self.device updateName:name success:{ NSLog@"updateName success" } failure:NSError error { NSLog@"updateName failure: @" error }] } Swift： func modifyDeviceName_ name: String { device.updateNamename success: { print"updateName success" } failure: { error in if let e error { print"updateName failure: e" } } } 移除设备 设备被移除后会重新进入待配网状态Wi-Fi 设备默认进入快连模式 接口说明 - voidremove:nullable ThingSuccessHandlersuccess failure:nullable ThingFailureErrorfailure 参数说明 参数 说明 success 成功回调 failure 失败回调 示例代码 Objective-C： - voidremoveDevice { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] [self.device remove:{ NSLog@"remove success" } failure:NSError error { NSLog@"remove failure: @" error }] } Swift： func removeDevice { device.remove{ print"remove success" } failure: { error in if let e error { print"remove failure: e" } } } 恢复出厂设置 设备恢复出厂设置后会重新进入待配网状态Wi-Fi 设备默认进入快连模式设备的相关数据会被清除掉 接口说明 - voidresetFactory:nullable ThingSuccessHandlersuccess failure:nullable ThingFailureErrorfailure 参数说明 参数 说明 success 成功回调 failure 失败回调 示例代码 Objective-C： - voidremoveDevice { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] [self.device resetFactory:{ NSLog@"reset success" } failure:NSError error { NSLog@"reset failure: @" error }] } Swift： func removeDevice { device.resetFactory{ print"reset success" } failure: { error in if let e error { print"reset failure: e" } } } 查询 Wi-Fi 信号强度 查询设备 Wi-Fi 信号后会通过 ThingSmartDeviceDelegate 的 device:signal: 方法回调 接口说明 - voidgetWifiSignalStrengthWithSuccess:nullable ThingSuccessHandlersuccess failure:nullable ThingFailureErrorfailure 参数说明 参数 说明 success 发送查询 Wi-Fi 强度成功回调 failure 失败回调 示例代码 Objective-C： - voidgetWifiSignalStrength { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] // self.device.delegate self [self.device getWifiSignalStrengthWithSuccess:{ NSLog@"get wifi signal strength success" } failure:NSError error { NSLog@"get wifi signal strength failure: @" error }] } #pragma mark - ThingSmartDeviceDelegate - voiddevice:ThingSmartDevice device signal:NSString signal { NSLog@" signal : @" signal } Swift： func getWifiSignalStrength { self.device.getWifiSignalStrengthsuccess: { print"get wifi signal strength success" } failure: { error in if let e error { print"get wifi signal strength failure: e" } } } // MARK: - ThingSmartDeviceDelegate func device_ device: ThingSmartDevice signal: String { print" signal : signal" } 查询网关子设备列表 如果是网关设备可以查询网关下子设备的列表 接口说明 - voidgetSubDeviceListFromCloudWithSuccess:nullable void NSArray <ThingSmartDeviceModel > subDeviceListsuccess failure:nullable ThingFailureErrorfailure 参数说明 参数 说明 success 成功回调网关下的子设备信息 failure 失败回调 示例代码 Objective-C： - voidgetSubDeviceList { // self.device [ThingSmartDevice deviceWithDeviceId:@"your_device_id"] [self.device getSubDeviceListFromCloudWithSuccess:NSArray<ThingSmartDeviceModel > subDeviceList { NSLog@"get sub device list success" } failure:NSError error { NSLog@"get sub device list failure: @" error }] } Swift： func getSubDeviceList { device.getSubDeviceListFromCloudsuccess: { subDeviceList in print"get sub device list success" } failure: { error in if let e error { print"get sub device list failure: e" } } }