什么是物模型
物模型是产品数字化的描述,定义了产品的功能,物模型将不同品牌不同品类的产品功能抽象归纳,形成“标准物模型”,便于各方用统一的语言描述、控制、理解产品功能。
物模型由若干条“参数”组成,参数按描述的功能类型不同,又分为属性、方法和事件。
参数 | 说明 |
属性 | 一般用于描述设备状态,支持读取和设置 |
方法 | 设备可被外部调用的能力或方法,可设置输入参数和输出参数,参数必须是某个“属性”。相比于属性,服务可通过一条指令实现更复杂的业务逻辑 |
事件 | 用于描述设备上报云端的事件,可包含多个输入参数,参数必须是某个“属性” |
为了实现设备功能的统一理解,对于每个品类会定义一套“标准参数”,标准参数包含了某个品类可能用到的所有参数,开发者在定义产品物模型时优先从标准参数中选择,如果标准参数未包含的功能,可以定义“自定义参数”。
文章图片
标准参数的意义
标准参数是以品类为维度,综合各品类设备功能,统一抽象的一组参数定义。
每个品类有一套标准参数,如“灯”品类的标准参数,定义了所有品牌的灯可能有的所有功能。各品类之间同样的功能保持参数一致,例如在“灯”品类的开关,“插座”品类的开关,乃至所有品类的开关都用同样的参数定义(“power”)。
这样高度抽象的物模型定义,是为了统一不同功能在不同设备上的表示方式,方便做通用功能时理解不同设备功能。例如在做语音控制设备开关时,只需要将“打开”这样的意图与“power”参数对应,即可实现所有设备的开关控制。
物模型字段详细说明 物模型的每个属性包含以下字段
文章图片
字段名称 | 字段说明 | 约束条件 |
名称 | 参数中文名 | “仅支持中文、英文大小写、数字、部分常用符号(下划线,减号,括弧,空格),必须以中文、英文或数字开头,长度不超过40个字符。” |
标识符 | 参数唯一英文标识 | 支持大小写字母、数字和下划线、不超过50个字符。 |
数据类型 | 必选,可选整数型、浮点型、枚举型、字符串。 | |
枚举项 | 枚举值和解释 | 仅枚举值参数。 分为参数值和参数描述,参数值支持整形,不超过2个字符,参数描述支持中文、英文、数字、下划线,不超过20个字符,枚举项数量可自定义。 |
取值范围 | 数据范围 | 仅整形、浮点数。 可自定义,输入的数值范围不超过各类型数据所能表示的范围。 |
步长 | 取值间隔 | 仅整形、浮点数。 步长是指设备上报或下发数值时,递增或递减的间隔。步长只能是一个正数;整数型最小步长为1;浮点数最小步长为10^(-7);最大步长不能超出取值范围的差值。 |
数据长度 | 字符串长度 | 仅字符串参数。 整数,表示字符串最大长度,取值1-2048 |
单位 | 数据单位 | |
读写权限 | 读写权限 | 可选“读”“写”“读写” 表示参数的读写权限 |
描述 | 参数描述 | 100字以内 |
文章图片
字段名称 | 字段说明 | 约束条件 |
名称 | 参数中文名 | 仅支持中文、英文大小写、数字、部分常用符号(下划线,减号,括弧,空格),必须以中文、英文或数字开头,长度不超过40个字符。 |
标识符 | 参数唯一英文标识 | 支持大小写字母、数字和下划线、不超过50个字符。 |
调用方式 | 异步调用是指云端执行调用后直接返回,不会关心设备的回复消息,如果服务为同步调用,云端会等待设备回复,否则会调用超时。 | 异步调用或同步调用任选其一。 |
输入参数 | 输入参数只可选择当前设备的属性,可多选,可为空。 | |
输出参数 | 输出参数只可选择当前设备的属性,可多选,可为空。 | |
描述 | 参数描述 | 100字以内 |
文章图片
字段名称 | 字段说明 | 约束条件 |
名称 | 参数中文名 | 仅支持中文、英文大小写、数字、部分常用符号(下划线,减号,括弧,空格),必须以中文、英文或数字开头,长度不超过40个字符。 |
标识符 | 参数唯一英文标识 | 支持大小写字母、数字和下划线、不超过50个字符。 |
输出参数 | 输出参数只可选择当前设备的属性,可多选,可为空。 | |
描述 | 参数描述 | 100字以内 |
阿里
阿里的ICA联盟发布的物模型和上面介绍的很相似,分为属性、方法、事件。只是在支持的数据类型、单位上有所不同。
小米
小米的物模型称作spec定义,由服务、属性、方法、事件组成,服务由若干属性、方法、事件组成,产品由若干服务组成,这样的架构更加灵活,它将具有某些功能组合的部件抽象成服务,例如空调就是由风扇服务、空气调节服务、指示灯服务组成,增加“服务”层级的意义在于,只要定义了少量的服务,就可以通过不同组合描述不同产品的功能。
京东
京东的模型定义比较简单,只有属性,属性变化时会上报,但由于没有“方法”参数,设备无法实现一些需要多个输入参数的复杂功能。
【IoT|什么是物模型(阿里小米京东物模型规则对比)】原文地址:http://process-z.com/model_compare/