命令设计
命令是移动客户端为了远程触发物端功能,而共同约定的标识。在开放平台命令设计中所选用的命令,均会默认显示在移动端的命令管理中。
当移动端用户使用命令时,可触发相关的物端功能。例如:用户向插座发送 “打开” 命令时,插座则执行打开功能,并回复 “已经打开”。
对于那些根据成品方案创建的产品,所有命令均不可编辑。
对于那些根据自定义方案创建的产品,可引用命令或创建自定义命令。
命令类型
引用命令
引用命令是指方案预置的命令。
开发者可在引用命令列表中选择需要在本产品使用的命令。
自定义命令
通过创建自定义命令,可以为产品创建具有特殊性的非标准命令。
前提条件
已根据自定义方案创建至少一款智能产品,更多关于创建产品的信息,请参考:创建产品。
操作步骤
登录物栖开放平台管理中心。
找到一款基于自定义方案的开发中的产品,单击 “继续开发” 链接。
单击导航按钮 “控制设计”,选择 “命令设计”,进入命令设计页面。
单击【引用命令】按钮,可打开 “引用命令” 页面。在页面中选择需要引入的命令,单击【引用命令】按钮完成引用。可根据实际需要,切换 “通用命令” 和 “品类命令”页签,选择适用的命令。
单击【创建命令】按钮,可打开 “创建命令” 页面。
“ 创建命令” 支持开发者最大化自定义命令。在 “创建命令” 页面,开发者可进行以下定制设计:
- 支持命令类型定义:可选择控制命令或者查询命令,主要用来标识使用场景,以确定回复消息的配置原则。
- 支持参数设置:参数可广泛用于配置服务属性值、自然语言内容、回复消息标识和回复消息内容,从而实现相关内容的灵活配置。物栖提供常用的参数,例如:国家、城市等,开发者也可根据实际需要增加自定义参数。
- 支持下发命令的功能配置:可根据命令的操作目标选取对应的功能。
- 支持为下发命令配置对应的多个自然语言:自然语言可在移动客户端的人与设备进行聊天时使用,一旦移动端使用者发送对应的自然语言即可触发命令下发。
- 支持为命令配置回复消息:当命令执行完毕,设备可发送回复消息给操作用户。命令的回复消息针对两种场景。当查询命令的功能属性为布尔型或枚举型,可按照参数值逐个配置操作成功的回复消息。
设置命令名称和描述。
命令的名称用于在开放平台和移动端的命令管理列表中展示,以便使用者可以快速识别命令。
选择命令类型。
命令类型分为控制命令(例如:打开、关闭等)和查询命令(例如:查询最近 1 小时的电量消耗)
设置参数表。
参数有效范围为当前命令。
配置功能服务。
可为命令配置本产品的功能。
配置回复内容。
当命令执行完毕,设备可发送回复消息给操作用户。回复内容可使用参数。
配置自然语言。
自然语言可在移动客户端的人与设备进行聊天时使用。自然语言内容可使用参数。