- 最新动态
- 功能总览
- 服务公告
- 计费说明
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- 开发指南
-
API参考
- 应用侧API参考
- 设备侧MQTT/MQTTS接口参考
- 设备侧HTTPS接口参考
- 设备侧LwM2M接口参考
- 安全隧道WebSocket接口参考
- 模组AT指令参考
- 修订记录
- SDK参考
- 场景代码示例
-
常见问题
- 热门问题
-
方案咨询
- 连接IoT平台的业务场景有哪些?
- 设备管理服务和设备接入服务合一后的差异点是什么?
- IAM子用户或子项目是否可以开通物联网平台服务?
- 物联网平台支持在华为云的哪些区域开通?
- 华为是否提供模组/硬件终端/应用软件等?
- IAM用户访问API提示没有权限?(是否区分版本?)
- 创建规则或者设置资源文件存储时候提示赋予Security Administrator权限
- 物联网平台设置默认资源空间的规则是什么?
- 设备接入服务如何获取设备数据?
- 物联网平台的资源空间和设备可以无限创建吗?
- 物联网平台支持批量注册设备吗?
- 物联网平台对应用侧和设备侧在开发或使用时有限制吗?
- 物联网平台支持的DTLS加密算法有哪些?
- 物联网平台支持二进制大小端模式切换吗?
- 什么是NB-IoT?
- 物联网平台支持的硬件架构和使用的相关组件有哪些?
- 如何获取平台接入地址?
- 设备集成相关问题
- 设备侧SDK相关问题
- 设备发放相关问题
- LWM2M/CoAP接入相关问题
- MQTT接入相关问题
- 泛协议接入相关问题
- 物模型相关问题
- 消息通信相关问题
- 订阅推送相关问题
- 编解码插件相关问题
- OTA升级相关问题
- 应用集成相关问题
- 实例管理相关问题
- 视频帮助
- 文档下载
- 通用参考
链接复制成功!
在线开发产品模型
概述
在线开发产品模型前需要创建产品。创建产品需要输入产品名称、协议类型、数据格式、所属行业和设备类型等信息,产品模型会使用这些信息作为设备能力字段取值。物联网平台提供了标准模型和厂商模型,这些模型涉及多个领域,模型中提供了已经编辑好的产品模型文件,您可以根据自己的需要对产品模型中的字段进行修改和增删;如果选择自定义产品模型,则需要完整定义产品模型。
本节定义包含一个服务的产品模型为示例,该产品模型包含设备上报数据、下发命令、下发命令响应等场景的服务和字段。
操作步骤
- 访问设备接入服务,单击“管理控制台”进入“设备接入”控制台。选择您的实例,单击实例卡片进入。
- 单击左侧导航栏的“产品”,在产品列表中,找到对应的产品,单击产品进入产品详情页。
- 在产品详情基本信息页面,单击“自定义模型”,添加服务。
- 输入“服务ID”、“服务类型”和“服务描述”,然后单击“确定”。
- “服务ID”:采用首字母大写的命名方式。比如:WaterMeter、StreetLight。
- “服务类型”:建议和服务ID保持一致。
- “服务描述”:比如路灯上报的环境光强度和路灯开关状态的属性。
添加服务后,在“添加服务”区域,对属性和命令进行定义。每个服务下,可以包含属性和命令,也可以只包含其中之一,请根据此类设备的实际情况进行配置。
- 单击步骤4新增的服务ID,在展开的页面单击“新增属性”,在弹出窗口中配置属性的各项参数,然后单击“确定”。
参数
说明
属性名称
建议采用驼峰形式,如batteryLevel、internalTemperature。
数据类型
- int:当上报的数据为整数时,可配置为此类型。
- long: 当上报的数据为长整型时,可配置为此类型。
- decimal:当上报的数据为小数时,可配置为此类型。配置“经纬度”属性时,数据类型建议使用“decimal”。
- string:当上报的数据为字符串、枚举值时,可以配置为此类型。如果为枚举值,值之间需要用英文逗号(“,”)分隔。
- dateTime:当上报的数据为日期时,可以配置为此类型。
此类型属性上报格式推荐样例:2020-09-01T18:50:20Z或者2020-09-01T18:50:20.200Z
- jsonObject:当上报的数据为JSON结构体时,可以配置为此类型。
- enum: 当上报的数据为枚举值时,可配置为此类型。
搭配参数enumList格式填写,比如状态属性的enumList填写为OPEN,CLOSE,那么属性上报格式样例为"OPEN"或者"CLOSE"
- boolean: 当上报的数据为布尔值时,可配置为此类型。
此类型属性上报推荐格式样例:true/false 或者 0/1
- stringList: 当上报的数据为字符串数组时,可配置为此类型。
此类型属性上报推荐格式样例:["str1","str2","str3"]
访问权限
- 可读:通过接口可以查询该属性。
- 可写:通过接口可以修改该属性值。
取值范围
请根据此类设备的实际情况进行配置。
步长
单位
图1 新增属性-batteryLevel - 单击“添加命令”,在弹出窗口中配置命令。
- “命令名称”:建议采用全大写形式,单词间用下划线连接的命名方式,如DISCOVERY,CHANGE_STATUS。
- “下发参数”:单击“新增输入参数”,在弹出窗口中配置下发命令字段的各项参数,然后“确定”。
参数
说明
参数名称
建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueChange
数据类型
请根据此类设备的实际情况进行配置。
取值范围
步长
单位
图2 新增命令CHANGE_STATUS - 如果要添加命令响应,单击“新增响应参数”,在弹出窗口中配置响应命令字段的各项参数,然后单击“确定”。
参数
说明
参数名称
建议采用第一个单词首字母小写,其余单词的首字母大写的命名方式,比如valueResult
数据类型
请根据此类设备的实际情况进行配置。
取值范围
步长
单位
图3 新增命令响应参数-valueAResult