检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
SDK介绍（联通用户专用） SDK分类 非联通用户请查看设备接入服务。 为了帮助设备快速连接到物联网平台，华为提供了Agent Lite SDK、Agent Tiny SDK和LiteOS SDK。如下图所示，支持TCP/IP协议栈的设备集成Agent Lite SDK或Agent
设备快速接入（联通用户专用） 非联通用户请查看设备接入服务。 本文档以MQTT.fx为例，介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端，可以快速验证是否可以与物联网平台服务交互发布或订阅消息。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册。
接收设备命令 接口功能 注册设备命令接收广播来接收处理平台下发的控制命令。 接口描述 1 DataTransService.TOPIC_COMMAND_RECEIVE; 返回结果 广播名称 广播参数 成员 描述 TOPIC_COMMAND_RECEIVE IotaMessage
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后，才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台提供了Agent Lite SDK，帮助设备快速连接到物联网平台。支持TCP/IP协议栈的设备在集成Agent Lite SDK后，可以直接与物联网平台通信。不支持TCP/IP协议栈的设备例如蓝牙设备、ZigBee设备等，可以通过集成了Agent
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
设备登录 接口功能 设备在第一次绑定后，或者在设备重启后需要进行登录的流程。 接口描述 1 HW_INT IOTA_Login(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功，并不说明登录成功，登录成功需要收到IOTA_TOP
设备服务能力增加通知 接口说明 应用服务器在物联网平台订阅了设备服务能力增加通知后（订阅的通知类型为deviceCapabilitiesAdded），在物联网平台上新增设备Profile文件时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后（订阅的通知类型为deviceCapabilitiesChanged），在物联网平台上设备Profile文件中的服务和属性被修改时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
创建订阅 接口说明 应用服务器可调用此接口订阅物联网平台资源的变化事件，当资源发生变化时（如设备激活，设备数据更新等），平台会向应用服务器发送通知消息。 URI 请求方法 POST URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS
在线开发插件（联通用户专用） 非联通用户请查看设备接入服务。 借助开发中心，我们可以通过可视化的方式快速开发一款产品的编解码插件。在自定义新建产品时，如果选择使用系统模板，部分模板会包含编解码插件，您可以直接使用或在此基础上进行修改；如果选择自定义产品模板，则需要完成编解码插件的开发。
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后（订阅的通知类型为deviceCapabilitiesDeleted），在物联网平台上删除设备Profile文件时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI
设备影子（联通用户专用） 非联通用户请查看设备接入服务。 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性
软件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
什么是Profile（联通用户专用） 非联通用户请查看设备接入服务。 Profile（即产品模型）是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile，因为Profile里面定义了设备上报的数据和应用服务器
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备
设备接收命令 接口说明 设备接收物联网平台下发的控制命令。 Topic Topic /huawei/v1/devices/{deviceId}/command/{codecMode} 消息发送方 物联网平台 消息接收方 设备 参数说明 参数 必选/可选 类型 描述 msgType
在开发中心上传Profile，弹窗提示“文件输入格式有误”？ 检查每个json文件的格式是否正确，可以使用W3Cschool的在线JSON校验格式化工具。 检查servicetype-capability.json中commands/properties的值是否为数组格式（值是否包含在中括号之内）。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
