检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备服务能力增加通知 接口说明 应用服务器在物联网平台订阅了设备服务能力增加通知后（订阅的通知类型为deviceCapabilitiesAdded），在物联网平台上新增设备Profile文件时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 def createBatchTask(self, btcInDTO
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后（订阅的通知类型为deviceCapabilitiesChanged），在物联网平台上设备Profile文件中的服务和属性被修改时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码
使用Java API Demo调测（联通用户专用） 本文档基于调用API接口的代码样例（Java）进行指导，接口信息详见API参考文档。 准备Java开发环境 本小节以Windows操作系统为例，介绍安装JDK1.8以及安装Eclipse的方法，如果您使用其它类型的开发环境，请根据自己的需要完成部署
什么是Profile（联通用户专用） 非联通用户请查看设备接入服务。 Profile（即产品模型）是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile，因为Profile里面定义了设备上报的数据和应用服务器下发的命令包含了哪些字段
在线开发Profile（联通用户专用） 非联通用户请查看设备接入服务。 在线创建Profile前需要先创建项目并定义产品。创建产品需要输入manufactureId、manufactureName、deviceType、Model等信息，Profile会使用这些信息作为设备能力字段取值
设备接收命令 接口说明 设备接收物联网平台下发的控制命令。 Topic Topic /huawei/v1/devices/{deviceId}/command/{codecMode} 消息发送方 物联网平台 消息接收方 设备 参数说明 参数 必选/可选 类型 描述 msgType
在线开发插件（联通用户专用） 非联通用户请查看设备接入服务。 借助开发中心，我们可以通过可视化的方式快速开发一款产品的编解码插件。在自定义新建产品时，如果选择使用系统模板，部分模板会包含编解码插件，您可以直接使用或在此基础上进行修改；如果选择自定义产品模板，则需要完成编解码插件的开发
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅，以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息，可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId
创建设备组 典型场景 第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组
创建设备组 典型场景 第三方应用可调用此接口在物联网平台上创建设备组，并把设备归类到不同的设备组内，进行分组管理。一个设备可以归属到多个设备组内。 在对设备进行某些操作时（如升级设备软固件、批量下发命令等），可通过设备组来指定要进行操作的设备。 接口功能 支持第三方应用在物联网平台创建设备组
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备属性变化通知后（订阅的资源为device.data，事件为update），当设备上属性数据时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅设备属性变化通知的
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
温度过高时自动关闭设备（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量
离线开发的插件包通过了工具检测，上传到平台时，提示找不到插件？ 使用反编译工具打开preload文件夹下jar包，检查OSGI-INF->CodecProvideHandler.xml是否为xml格式，且不存在乱码。 图1 CodecProvideHandler.xml样例 检查name
在开发中心上传Profile，无法点击上传按钮？ 检查Profile文件的名称是否符合“deviceType_manufacturerId_model.zip”格式，并检查“deviceType”、“manufacturerId”、“model”三个字段是否和“devicetype-capability.json
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
