阿里智能开放平台

阿里智能APP

注册协议配置

完成 注册功能信息 之后,如 注册基本信息 时说明的,其中“协议解析模式”,支持“默认”和“透传”,如果选择了“透传”,则会进入注册协议配置。

  • 透传模式需要上传透传数据的解析代码,目前解析代码支持Lua语言;
  • lua代码开发说明请参考本文【lua解析脚本开发指南】小节,示例代码请下载“产品解析协议lua解析示例文件”;

    • 上传Lua脚本

注册协议配置之后

  • 注册协议配置之后,点击“保存并下一步”,开始 注册信息详情

更新协议配置(Lua脚本)

  • 首次注册需要Lua脚本,首次上传的脚本可能不完善,需要变更或更新,在完成产品注册之后,可以在“产品管理”-“产品管理列表”,选择对应的产品,点击“更新Lua脚本”按钮,上传脚本更新。

    • lua

lua解析脚本开发指南

lua必须实现的方法

  • is_increment() Para:nil Rets:true/false(Boolean) 说明:用于从云端向设备下发指令场景。如设备支持增量设置属性则返回true;否则如设备要求必须同时携带之前已上报的最新状态数据则返回false,云端将补齐已上报的最新状态数据全部下发到设备。

  • private_cmd_query(json) Para:nil Rets:“query”指令对应的设备端指令数据 说明:用于由云端发起的查询设备状态场景。云端调用该方法时,此方法应返回“query”指令对应的设备端指令数据。

  • convert_from_private(meta) Para:设备端原始数据 Rets:符合设备在云端已定义的相关属性的json格式形式数据 说明:用于设备向云端上报数据云端解析场景。透传模式设备端上报的数据云端无法直接处理,此方法需要实现将设备端原始数据解析为设备已注册属性对应的json格式数据。

  • convert_to_private(json) Para:设备在云端已定义的相关属性的json格式形式数据 Rets:设备端原始数据 说明:用于云端向设备下发数据封装为设备可识别数据格式场景。透传模式云端下发的数据设备无法直接处理,此方法需要实现将云端数据格式转换为设备可识别数据格式。

lua脚本开发注意事项

  • lua代码应简洁高效,lua脚本文件大小应小于30k。
  • 平台不支持lua代码调试,请开发者在开发环境完成对相关lua代码的测试工作,确保lua代码正确。
  • lua代码需要注意执行效率,低性能的lua代码将可能导致后续审批流程被打回。