- 产品介绍
- 价格说明
- 快速入门
- 开发指南
- 用户指南
- 最佳实践
- API参考
-
SDK参考
- SDK介绍（联通用户专用）
- 应用侧JAVA SDK API参考（联通用户专用）
- 应用侧Python SDK API参考（联通用户专用）
- 设备侧Agent Lite API参考(C)（联通用户专用）
- 设备侧Agent Lite API参考(Android)（联通用户专用）
- 设备侧Agent Lite API参考(Java)（联通用户专用）
-
常见问题
- 热门问题（联通用户专用）
-
方案咨询（联通用户专用）
- 开发中心、设备接入和设备管理的差异是什么？
- IAM子用户或子项目是否可以开通物联网平台服务？
- 物联网平台支持在华为云的哪些区域开通？
- 如何成为华为IoT生态合作伙伴？
- 物联网平台支持哪些接入方式和协议？
- 华为是否提供模组/硬件终端/应用软件等？
- 设备接入模拟器HubSimulator是否能在设备管理使用？
- 设备接入服务如何获取设备数据？
- 物联网平台的应用和设备可以无限创建吗？
- 物联网平台支持批量注册设备吗？
- 物联网平台对应用和设备有消息流控吗？
- 开发中心单个应用允许接入设备数是多少？
- 数据在物联网平台的保存时间是多久？
- 物联网平台支持的DTLS加密算法有哪些？
- 物联网平台支持二进制大小端模式切换吗？
- 什么是NB-IoT？
- 物联网平台支持的硬件架构和使用的相关组件有哪些？
-
设备集成（联通用户专用）
- 如何获取设备和应用对接地址？
- 如何下载LiteOS IDE/IoT Studio?
- 物联网平台允许一个IMEI号注册多个设备吗？
- 如何设置设备名称？
- IoT设备如何激活？
- 物联网平台如何切换设备的在线/离线状态？
- 通过网关接入的子设备，平台如何识别是哪一个设备？
- deviceId、nodeId和IMEI有什么对应关系？
- Agent Lite和Agent Tiny有什么区别？
- 使用Agent Lite接入的网关设备gwbindinfo.json文件丢失如何处理？
- 运行Agent Lite Java Demo报UnsatisfiedLinkError错误怎么处理？
- 设备如何发送文件至物联网平台？
- 开发中心模拟设备如何上报负数？
- 开发中心支持哪几种省电模式？
- 开发中心支持数据转发吗？
- 开发中心没有设备分组和批量添加设备，怎么办？
- 如何检测NB网络信号？
- NB模组附着网络失败如何处理？
- NB模组绑定设备失败怎么办？
- NB模组无法正常上报数据怎么办？
- NB设备上报数据为字符串时如何转换为二进制编码？
- NB设备接入时，出现513错误？
- 为什么执行AT+CUFN=1会返回error？
- 平台向NB-IoT设备缓存下发命令，为什么设备一直收到同一条控制命令？
- AT+CGDCONT=1, CTNB是什么？
- NB-IoT设备如何选择PSM、DRX、eDRX模式？
- 应用集成（联通用户专用）
-
订阅推送（联通用户专用）
- 调用订阅接口时，回调地址如何获取？
- 应用服务器如何收到命令状态变化的通知？
- 如何获取证书？
- 回调地址可以使用域名吗？
- 订阅后消息推送失败，例如提示503如何处理？
- 应用服务器收到数据，但是平台显示推送失败？
- 应用服务器只有内网地址，能否订阅成功？
- 调用订阅接口时，提示回调地址不合法？
- 物联网平台只支持HTTPS的回调地址吗？
- 回调地址可以修改吗？
- 推送证书失效怎么处理？
- 调用删除单个订阅接口时，subscriptionId如何获取？
- 设备数据变化通知和批量设备数据变化通知的区别是什么？
- 应用服务器如何获取物联网平台推送消息时使用的地址？
- 物联网平台订阅推送是否具有重推机制？
- 为什么设备上报一条数据后应用服务器会收到多条推送？
- 在同一个应用下，平台可以将不同设备上报的数据，推送到两个服务器吗？
- NB-IoT设备已订阅消息确认和命令响应通知，为何应用服务器收不到推送消息？
- 数据上报（联通用户专用）
- 命令下发（联通用户专用）
- 产品模型/Profile（联通用户专用）
- 编解码插件（联通用户专用）
- 软/固件升级（联通用户专用）
- 文档下载
- 通用参考
链接复制成功！
消息结构体说明
转发设备上报的属性
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
device_id |
String |
设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 |
|
services |
services[] |
设备物模型的属性定义。 |
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
service_id |
String |
设备的服务ID，在设备关联的产品模型中定义。 |
|
properties |
ObjectNode[] |
设备按照物模型上报的具体数据。 |
|
event_time |
String |
设备数据上报的时间，格式：yyyymmddThhmmssZ，例如：20151212T121212Z。 |
属性上报转发结构体示例：
{
"device_id":"String",
"services":[
{
"service_id":"String",
"properties":{
"property1":"String"
},
"event_time":"yyyyMMddTHHmmssZ"
},
{
"service_id":"String",
"properties":{
"property2":"String"
},
"event_time":"yyyyMMddTHHmmssZ"
}
]
}转发设备上报的消息
设备上报给平台的消息，不解析消息体中的数据具体含义，直接透传给华为云其他服务。
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
deviceId |
String |
设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 |
|
productId |
String |
产品ID，用于唯一标识一个产品，在物联网平台创建产品后由平台分配获得。 |
|
topic |
String |
mqtt设备消息上报时的订阅主题topic |
|
data |
String |
消息上报的具体内容，平台会将设备消息上报的结构体当成字符串放在data的value域。 |
{
"deviceId":"string",
"data":"string",
"productId":"string",
"topic":"string"
}转发下行消息结果
应用服务器在物联网平台创建下行信息结果的规则后，当消息状态变更时，平台将消息结果推送给华为云其他服务。
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
resource |
String |
订阅的资源名称，取值为device.message.status。 |
|
event |
String |
订阅的资源事件，取值为update。 |
|
notify_data |
ObjectNode |
设备的自定义字段列表。 |
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
message_id |
String |
消息的序列号，唯一标识一条消息。 |
|
name |
String |
消息名称。 |
|
device_id |
String |
设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 |
|
status |
String |
设备消息状态，包含：DELIVERED,TIMEOUT,FAILED。 |
|
timestamp |
String |
消息更新时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。 |
下行消息结果转发结构体示例：
{
"resource":"string",
"event":"string",
"notify_data":{
"message_id":"string",
"name":"string",
"device_id":"string",
"status":"string",
"timestamp":"string"
}
}转发设备状态
当直连设备的状态变更后，平台将变更状态的设备转发至华为云其他服务。
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
resource |
String |
订阅的资源名称，取值为device.status。 |
|
event |
String |
订阅的资源事件，取值为update。 |
|
notify_data |
ObjectNode |
设备的自定义字段列表。 |
|
参数名称 |
类型 |
描述 |
|---|---|---|
|
app_id |
String |
资源空间ID |
|
device_id |
String |
设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 |
|
status |
String |
设备状态。 |
|
timestamp |
String |
设备状态变化时间,格式：yyyyMMdd'T'HHmmss'Z' UTC字符串，如：20151212T121212Z。 |
设备状态变更转发结构体示例：
{
"resource":"string",
"event":"string",
"notify_data":{
"device_id":"string",
"app_id":"string",
"status":"string",
"timestamp":"string"
}
}
