检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备接收命令 接口说明 设备接收物联网平台下发的控制命令。 Topic Topic /huawei/v1/devices/{deviceId}/command/{codecMode} 消息发送方 物联网平台 消息接收方 设备 参数说明 参数 必选/可选 类型 描述 msgType
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
产品模型（联通用户专用） 概述 产品模型（也称Profile）用于描述设备具备的能力和特性。开发者通过定义Profile，在物联网平台构建一款设备的抽象模型，使平台理解该款设备支持的服务、属性、命令等信息，如颜色、开关等。当定义完一款产品模型后，在进行设备注册时，就可以选择已在控制台上导入的产品模型
温度过高时自动关闭设备（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量
离线开发的插件包通过了工具检测，上传到平台时，提示找不到插件？ 使用反编译工具打开preload文件夹下jar包，检查OSGI-INF->CodecProvideHandler.xml是否为xml格式，且不存在乱码。 图1 CodecProvideHandler.xml样例 检查name
使用模组接入 集成NB-IoT模组的设备，可以通过NB-IoT网络接入物联网平台。 特点 覆盖广，相比LTE提升20dB以上的增益 低功耗，聚焦小数据量、小速率应用 海量连接，单扇区支持5万个连接 低成本，低速率、低功耗、低带宽等特点使NB-IoT芯片或模组具备低成本优势 应用场景
在开发中心上传Profile，无法点击上传按钮？ 检查Profile文件的名称是否符合“deviceType_manufacturerId_model.zip”格式，并检查“deviceType”、“manufacturerId”、“model”三个字段是否和“devicetype-capability.json
在开发中心上传Profile，弹窗提示“文件输入格式有误”？ 检查每个json文件的格式是否正确，可以使用W3Cschool的在线JSON校验格式化工具。 检查servicetype-capability.json中commands/properties的值是否为数组格式（值是否包含在中括号之内
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
常见的软/固件升级错误有哪些？ 在软/固件升级时，可以在“执行详情”的任务列表中查看错误描述，常见错误描述如下： 失败原因 原因解释 处理建议 Device Abnormal is not online 设备未在线 请检查设备侧是否在线。 Task Conflict 任务冲突 请检查当前设备是否有软件升级
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制
设备触发告警并邮件或短信通知（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 很多物联网设备24小时运行，设备管理者并不需要知道设备每一刻的状态，只需要设备在上报某些特定状态时能通知到管理者。 设备管理服务提供规则引擎功能可以满足该诉求，您可以通过设置规则简单实现当设备上报的数据满足某个条件时
查询单个订阅 典型场景 第三方应用可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。第三方应用若需要查看某个订阅的配置信息，可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台根据订阅ID查询指定订阅的配置信息。 接口描述 1 def querySingleSubscription
查询单个订阅 典型场景 第三方应用可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。第三方应用若需要查看某个订阅的配置信息，可调用此接口进行查询。 接口功能 支持第三方应用在物联网平台根据订阅ID查询指定订阅的配置信息。 接口描述 1 SubscriptionDTO querySingleSubscription
更新设备状态 接口功能 通过该接口更新设备的状态信息，包括直连设备与所管理的非直连设备。设备离线、上线均可通过该接口刷新设备状态信息。 直连设备状态通过设备的登录状态进行管理，当直连设备连接断开则表示设备离线，当直连设备连接或重连成功，则表示设备上线，无需通过该接口进行刷新。故建议开发者使用该接口刷新非直连设备的状态
产品模型/Profile（联通用户专用） 如何进行Profile开发？ 在开发中心上传Profile，无法点击上传按钮？ 在开发中心上传Profile，弹窗提示文件输入格式有误？ 在开发中心上传Profile，弹窗提示厂商ID和设备型号已存在？ 在线开发Profile时，如何选择数据类型
广播机制 Agent Lite提供了一套广播机制给第三方开发者，用来接收Agent Lite上报的消息。 订阅广播 1 HW_BroadCastReg(HW_CHAR *pcTopic ,PFN_HW_BROADCAST_RECV pfnReceiver); 广播接收处理函数原型
登录参数配置 接口功能 在登录前配置登录所需要的参数。 接口描述 1 public static boolean setConfig(int key, String value); 接口所属类 LoginConfig 参数说明 字段 必选/可选 类型 描述 key 必选 int
设备集成（联通用户专用） 非联通用户请查看设备接入服务。 如何获取设备和应用对接地址？ 如何下载LiteOS IDE/IoT Studio? 物联网平台允许一个IMEI号注册多个设备吗？ 如何设置设备名称？ IoT设备如何激活？ 物联网平台如何切换设备的在线/离线状态？ 通过网关接入的子设备
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
