前序系列文章>>>

【涂鸦物联网足迹】涂鸦云平台接口列表

我们系列文章,都会围绕如何完成一款智能“隔空接吻机”的开发。希望能帮到各异地恋or异国恋的情侣们!

本文我们会大概讲解API接口列表中的垂直品类之一的万能红外遥控器~

目前涂鸦云开发平台除了提供了共12个基础的接口列表(见上一篇文章), 还提供5个垂直品类的接口。所谓的“垂直品类”,就是基于场景化的接口啦~我们接下来一一介绍一下吧~

一、万能红外整体介绍:

万能红外:万能红外遥控器,也称万能红外网关,可替代国内外 99% 主流品牌红外遥控器,支持 DIY 学习功能。可以让家里的传统家电快速接入互联网,支持手机端控制,场景联动等各种丰富的功能。有关产品介绍和相关参数,请访问 万能红外遥控器。

其中场景类型包括:普通遥控器控制、机顶盒遥控器控制、空调遥控器,另外还有通用接口、红外码学习、红外码智能匹配、红外定时任务等等。

二、场景类接口列表:

普通遥控器控制

用于控制电视和风扇的遥控器类型。此场景只是推荐的红外流程,可以根据各自不同的需要,基于已开放的接口开发并丰富各自的业务流程场景。

操作流程如下:

  • 首先可以获取当前云云对接支持的红外设备类型;当前支持电视、机顶盒、空调和风扇类型;API(1):API文档——获取红外支持的设备类型
  • 根据想要控制的设备类型,选择一个类型获取支持的设备类型的品牌;API(2):API文档——获取指定类型品牌列表
  • 选择指定的品牌获取云云对接中预设的公版遥控器红外码库索引;API(3):API文档——获取品牌支持遥控器索引列表
  • 一个品牌可能会有多个不同的遥控器红外码库索引,这时需要试用是否合适需要控制的红外设备,一般建议至少测试三个按键有效后再确认添加遥控器;API(4):API文档——控制遥控器:测试场景按键(基于通用标准按键)
  • 确认可用的遥控器红外码库索引后,使用此索引绑定普通遥控器到万能红外遥控器设备上;API(7):API文档——添加普通遥控器
  • 使用普通遥控器,基于标准红外指令控制设备,标准指令参考;API(8):API文档——控制遥控器:已添加遥控器(基于通用标准按键)

API列表:

  • 获取红外支持的设备类型:获取红外设备支持的设备类型,目前支持电视,机顶盒,空调,风扇等。
  • 获取指定类型品牌列表:按遥控器类型获取品牌列表,支持电视和空调。
  • 获取品牌支持遥控器索引列表:根据品牌 id获取指定品牌下所有型号的遥控器索引列表。
  • 添加普通遥控器:添加一款指定型号的遥控器,形成一个实例化的虚拟遥控器。

机顶盒遥控器控制

机顶盒设备支持 IPTV 和非 IPTV 。此场景只是推荐的红外流程,可以根据各自不同的需要,基于已开放的接口开发并丰富各自的业务流程场景。

操作流程:

  • 首先获取支持的红外设备类型;API(1):API文档——获取红外支持的设备类型
  • 选择相应的地址;

API(2):API文档——获取省份列表

API(3):API文档——获取城市列表

API(4):API文档——获取区域列表

  • 根据所在的区域,获取指定区域支持的运营商信息列表;API(5):API文档——获取运营商列表:根据区域
  • 根据选择的运营商,获取支持的设备品牌;API(6):API文档——获取品牌列表:根据运营商
  • 选择指定的品牌获取云云对接中预设的公版遥控器红外码库索引;

API(7):API文档——获取遥控器索引列表:根据品牌

API(8):API文档——获取遥控器索引列表:根据区域

  • 一个品牌可能会有多个不同的遥控器红外码库索引,这时需要试用是否合适需要控制的红外设备,一般建议至少测试三个按键有效后再确认添加遥控器;API(9):API文档——控制遥控器:测试场景按键(基于通用标准按键)
  • 确认可用的遥控器红外码库索引后(即某型号遥控器可用),使用此索引绑定机顶盒遥控器到万能红外遥控器设备上;API(12):API文档——添加机顶盒遥控器
  • 使用刚才添加的遥控器,基于标准红外指令控制设备,标准指令参考;API(13):API文档——控制遥控器:已添加遥控器(基于通用标准按键)

API列表:

  • 获取省份列表:获取省份列表。
  • 获取城市列表:根据省份ID获取城市列表。
  • 获取区域列表:根据省份ID和城市ID获取区域列表。
  • 根据区域获取运营商列表:针对于机顶盒类型设备,可获取指定区域支持的 IPTV s列表。
  • 根据运营商获取品牌列表:针对机顶盒设备,根据运营商支持的品牌列表。
  • 根据品牌/区域获取遥控器索引列表:根据类型 ID/区域ID 获取支持IPTV运营商的遥控器索引。
  • 添加机顶盒遥控器:添加机顶盒遥控器。
  • 查询电视频道列表:根据遥控器ID查询频道列表。
  • 切换电视频道:切换电视片频道

空调遥控器控制

此场景只是推荐的红外流程,可以根据各自不同的需要,基于已开放的接口开发并丰富各自的业务流程场景。。

操作流程:

  • 获取支持的红外空调设备的品牌;API(1):API文档——获取指定类型品牌列表
  • 选择指定的品牌获取遥控器红外码库索引;API(2):API文档——获取品牌支持遥控器索引列表
  • 一个品牌可能会有多个不同的遥控器红外码库索引,这时需要试用是否合适需要控制的红外设备,一般建议至少测试三个按键有效后再确认添加遥控器;API(3):API文档——测试空调遥控器
  • 确认可用的遥控器红外码库索引后,使用此索引绑定空调遥控器到万能红外遥控器设备上;API(4):API文档——添加普通遥控器
  • 使用普通遥控器,基于标准红外指令控制设备;标准指令参考:API文档——控制遥控器:已添加遥控器(基于通用标准按键)

或者空调专有指令控制设备;API(5):API文档——控制空调遥控器

  • 部分业务场景存在直接控制空调相关参数的情况,调用多条件的空调指令直接控制空调的相关参数,但请注意并不是所有的组合条件都可以支持直接下发红外码;API(6):API文档——多条件控制空调

空调类遥控器只支持API文档中描述的标准指令,不支持非标准指令。

API列表

  • 测试空调遥控器:用于在测试空调遥控器是否匹配空调设备时,根据遥控器索引下发单个的空调遥控器按键指令。
  • 控制空调遥控器:下发单个的空调遥控器按键指令。
  • 多条件控制空调:多条件的空调指令下发,用于在部分联动场景下对空调的控制。
  • 查询空调状态:查询空调状态。

三、其他接口列表:

通用接口API列表:

  • 获取红外设备下面绑定的遥控器列表:根据红外设备 ID 来获取红外设备下面绑定的遥控器列表。
  • 添加/删除/设置遥控器:此接口可以兼容机顶盒、电视、空调等类型设备的遥控器添加/删除/设置。
  • 获取遥控器配对规则:根据遥控器 ID 获取配对规则,获取到key用于红外码下发。
  • 控制遥控器:测试场景按键(基于通用标准按键):在测试遥控器是否匹配设备时使用。使用通用标准key控制,标准key见附录。支持空调的标准指令下发。
  • 控制遥控器:测试场景按键(基于配对规则):在测试遥控器是否匹配设备时使用。根据key来下发红外码,请求参数中的key是从获取配对规则中获得key。非标准指令不支持空调,空调使用专有的指令下发。
  • 控制遥控器:已添加遥控器(基于配对规则):控制已绑定的遥控器下发指令,根据raw_key来下发红外码,请求参数中的raw_key是从获取配对规则中获得key,目前这个接口只支持电视和机顶盒,空调使用专有的指令下发。
  • 获取遥控器支持的按键列表:可查询指定遥控器支持的按键列表,同时返回可支持的标准key和非标准key。
  • 获取空调遥控器支持的按键规则列表:仅查询指定空调类的遥控器支持的按键列表,同时返回可支持的标准key和非标准key,同时返回支持的按键范围。

红外码学习API列表

开启学习状态后,再使用真实的遥控器对准万能红外设备按下需要学习的按键,然后再使用查询学习到的学习码的API获取学习到的学习码。

  • 更新学习状态:进入学习状态
  • 查询学习到的红外码:获取学习到的红外码。传入的参数建议直接使用更新学习状态时返回的时间戳t。
  • 下发/更新/删除学习到的红外码:下发/更新/删除学习到的红外码。
  • 保存学习到的红外码:保存学习到的红外码,生成遥控器id
  • 获取保存的学习红外码:获取保存的学习红外码

红外码智能匹配API列表

部分品牌下的预设的遥控器红外码库索引可能比较多,有时候为了尝试出某个索引是否支持需要控制的设备,可能需要测试多次,造成匹配成功一个遥控器需要耗费大量的时间和精力。​ 因此提供红外码智能匹配功能,可以根据学习到的红外码来快速匹配遥控器红外码库索引。

前提是需要提供真实的遥控器进行学习匹配。

操作流程:

  1. 开启红外网关学习状态;API文档——更新学习状态
  2. 用户使用遥控器对准红外网关发送红外码;
  3. 获取红外网关学习到的学习码; API文档——查询学习到的红外码
  4. 使用学习到的 学习码 请求智能匹配,返回 智能匹配token; API文档——生成智能匹配令牌
  5. 使用 智能匹配token 请求匹配列表;API文档——获取智能匹配遥控器列表
  6. 用户在返回的匹配列表中依次查看遥控器索引信息; API文档——获取遥控器索引支持的品牌信息
  7. 循环尝试匹配列表的遥控器索引中的按键;

API文档——控制遥控器:测试场景按键(基于通用标准按键)

API文档——测试空调遥控器

  1. 如果找到合适的,则确认遥控器,结束此次智能匹配动作;否则继续后续步骤;API文档——添加遥控器
  2. 如果未找到合适的,则继续使用 智能匹配token 请求匹配列表,进行步骤5的操作,这里就是在有多个匹配结果的时候,进行的分页处理,如果只有1页,则不需要再进行步骤5的操作;
  3. 如果接口返回无数据,则匹配列表结束;
  4. 如果需要进一步缩小匹配范围,则可以再次开启红外网关学习状态,下发新的学习码,然后获取新的 智能匹配token (步骤1、2、3、4);
  5. 然后使用新的 智能匹配token 同时带上步骤5中的旧的 智能匹配token 一起请求匹配列表,系统则会在使用步骤3学习到的红外码匹配的基础上,再使用步骤11获取的红外码进一步缩小匹配范围;
  6. 然后再重复步骤6、7、8、9、10、11,直到找到合适的遥控器索引,或者未匹配到。

API列表:

  • 生产智能匹配令牌:使用红外网关学习到的红外码,生成智能匹配令牌token,用于后续分页查询智能匹配结果。
  • 获取智能匹配遥控器列表:使用生成的智能匹配令牌token,分页查询智能匹配结果列表。
  • 获取遥控器索引支持的品牌信息:查询指定遥控器索引支持的品牌的信息。

红外定时任务API列表

  • 添加红外定时任务:添加一个红外定时任务。
  • 获取/更新/删除红外定时任务:查询/更新/删除红外定时任务。
  • 删除所有定时任务:删除所有定时任务。
  • 更新红外分组定时状态:更新红外分组定时状态。

以上所有所有接口地址可在此处查询>>>涂鸦云平台接口列表

【涂鸦物联网足迹】涂鸦云平台接口列表—万能红外遥控器相关推荐

  1. 【涂鸦物联网足迹】涂鸦云平台接口列表—智能门锁

    前序系列文章>>> [涂鸦物联网足迹]涂鸦云平台接口列表-万能红外遥控器 一.智能门锁整体介绍: 智能门锁区别于传统机械锁,在用户安全性.识别.管理性方面更加智能化简便化的锁具.智能 ...

  2. 【涂鸦物联网足迹】API及SDK介绍

    前序系列文章>>>[涂鸦物联网足迹]物联网主流通信方式 我们系列文章,都会围绕如何完成一款智能"隔空接吻机"的开发.希望能帮到各异地恋or异国恋的情侣们! 本文我 ...

  3. 物联网iot私有云平台搭建

    物联网iot私有云平台搭建 物联网的平台有多种,把其中的一些列出一个开源平台比照表. IoT 软件平台 设备管理? 集成 安全 数据收集协议 分析 支持可视化? 数据库 Kaa IoT Platfor ...

  4. 【毕业设计】基于云平台的火灾报警器 - stm32 物联网 单片机 OneNET云平台

    文章目录 0 简介 1 项目简介 2 开发环境 3 火焰传感器 4 连接OneNET云平台 5 演示效果 6 最后 0 简介 Hi,大家好,这里是丹成学长,今天向大家介绍一个 单片机项目 基于云平台的 ...

  5. 毕业设计 基于云平台的火灾报警系统设计与实现 - stm32 物联网 单片机 OneNET云平台

    文章目录 0 简介 1 项目简介 2 开发环境 3 火焰传感器 4 连接OneNET云平台 5 演示效果 6 最后 0 简介 Hi,大家好,学长今天向大家介绍一个 单片机项目 基于云平台的火灾报警器 ...

  6. 天创与阿里云合作 推出“易联”物联网设备运营管理云平台

    日前,天创集团与阿里云签署合作协议,并携手推出新一代的智能管控系统--易联物联网设备运营管理云平台,针对专业音视频行业云服务应用场景展开创新探索. 7月20日香港发布会 天创集团是国内专业音视频领域的 ...

  7. Python通过云平台接口读取温度湿度传感器的实时监控数据

    开学第一课:一定不要这样问老师Python问题 董付国老师Python系列教材推荐与选用参考 ============= 版权声明:由于公众号后台规则问题,本文暂时无法设置原创标记,但仍属原创内容,微 ...

  8. 【开源】物联网智慧消防云平台系统,前后端分离,微服务框架带文档,源码分享

    [开源]IoT-智慧消防云平台系统,前后端分离微服务框架源码带文档 基于微服务的物联网消防云平台 开发环境:java+mysql+redis+rabbitmq+elasticsearch 源码类型:全 ...

  9. 一文了解,从RS485传感器到物联网关到云平台过程

    一.概述 工业现场有需要设备支持RS485通信,可以采集各种PLC.流量计.温湿度.液位等.应用特别广泛,这里尽量以更简单的方式,让大家了解整个数据采集过程,更详细可以阅读相关说明书. 钡铼技术:专注 ...

最新文章

  1. php作为文本进行处理,PHP处理文本和爬虫技巧
  2. JavaScript最全编码规范
  3. Python实现多进程的4种方式
  4. java 字符串 面试_Java 字符串面试题
  5. vim使用帮助命令的方法
  6. Centos 7.5安装配置MongoDB 4.0.4
  7. 在C#中调用一个dll函数,其中有个参数为 hdc,如何在C#中得到这个值并传给这个参数呢?
  8. Factory Method(工厂方法)--对象创建型模式
  9. azure 入门_Azure数据目录入门
  10. Start Developing iOS Apps Today系列(二)
  11. Redhat linux AS4 环境下iSCSI协议配置
  12. Servlet(四):转发与重定向、路径问题
  13. 【原创】 ES5高效封装WIN10系统教程2020系列(六)ES5封装
  14. uds 诊断协议的bootloader开发
  15. honeywell Xenon TM 1900二维码扫描枪扫描不显示中文
  16. 2020超星android测试,2020知到《现代物流学》免费答案超星尔雅《测试作业导入》答案公众号...
  17. leapftp 软件,leapftp 软件的5大功能
  18. 2021-07-05C#/CAD二次开发创建圆弧(4)
  19. php判断是否连续出现数字,php通过gbk编码判断 含有连续数字 可用于判断QQ号,手机号等。...
  20. 中南大学杰出校友_杰出客户服务的10个要点。

热门文章

  1. 此文让你至少走三年弯路
  2. luogu4188 [USACO18JAN]Lifeguards S
  3. 时光飞逝,思考,实践,伴我一生的经验
  4. 计算机毕业设计开题报告怎么写?【详细说明】
  5. php代码纵向排列文字怎么写,css里怎么文字纵向排列?
  6. 入手python难不难_Python难不难?容易学吗?
  7. SQL Server获取姓名拼音
  8. 某程序员发现 CSDN官方“漏洞”,立省¥10000+,抓紧薅吧
  9. Python_argparse.Argumentparser()
  10. vue复选框选中一个全选中了