介绍API发展过程的Level版本,以及每个版本发布的SDK信息。

API Level的概念

  • API Level值的范围为自然数,是用于描述移动应用SDK开放给移动插件的API等级,每个API Level包含有一组SDK,每个SDK包含着一组API的集合。
  • 由于平台各个SDK版本的迭代,新功能的增加会伴随着API的增加,极少数情况下会有API的废弃。
  • 为了避免基于新API开发的插件,在老版本SDK(不包含该API)上运行导致的不兼容问题(如crash),引入了API Level的概念。
  • 随着开放给插件的API增加,开发者平台上API Level版本会增加。开发的插件会有标示最低支持的API Level。
  • 开发者在应用开发平台上选取API Level,平台会前置过滤出该API Level下的SDK列表,开发者在选定SDK列表后再新建资源变更,平台会再根据API Level和开发者选择的SDK过滤出可用的插件列表。

移动插件能够与移动应用兼容,需要满足以下条件:移动应用配置的API Level>=移动插件的API Level。

API Level 9

API Level 9发布于2020年5月,总共包含11个SDK。本次升级主要为了支持全球范围内的多点接入,初始化SDK时无需再区分地域,全球统一。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求 支持全球多接入点连接
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议 支持全球多接入点连接
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App级别的下行推送;支持请求响应模型,支持发布订阅模型 支持全球多接入点连接
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求 支持全球推送
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等
蓝牙 Breeze SDK是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用

API Level 8

API Level 8发布于2019年12月,总共包含11个SDK。本次升级主要为了支持除中国内地以外地区的多点接入,提升App网络体验,提供推送服务,同时减少接入成本,统一多个功能接口。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求 支持除中国内地以外地区的多接入点连接
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议 支持除中国内地以外地区的多接入点连接
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App级别的下行推送;支持请求响应模型,支持发布订阅模型 支持除中国内地以外地区的多接入点连接
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求 支持除中国内地以外地区的推送
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等
蓝牙 Breeze SDK是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用

API Level 7

API Level 7发布于2019年9月,总共包含11个SDK。本次升级主要是根据GooglePlay市场的要求,添加对于arm64-v8a架构的支持。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅 App 级别的下行推送;支持请求响应模型,支持发布订阅模型
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 支持arm64-v8a架构
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等
蓝牙 Breeze SDK是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用
说明 Google Play已于2019年8月1日停掉尚未支持64位体系的App,如果您App要在Google Play应用商店上架,且用到了BoneKit SDK,那需要尽快升级,以免无法上架。后续如果推出新插件或老插件升级,仅针对已升级到v0.59 BoneKit SDK的自有App。

API Level 6

API Level 6发布于2019年5月,总共包含11个SDK。本次升级主要是更新设备数据的缓存策略。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅 App 级别的下行推送;支持请求响应模型,支持发布订阅模型
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 升级API Level到6升级Router-external(路由缓存策略变更,优先本地缓存)
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等 支持二维码配网
蓝牙 Breeze SDK是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等 连接成功时返回breeze蓝牙设备激活数据
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制 新增Feature:设备影子
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用

API Level 5

API Level 5发布于2019年2月,总共包含11个SDK。本次升级主要是支持对设备热点的配网。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求
API通道SDK 提供了IoT官方服务的API通道,基于 HTTP 协议 新增Feature:API request超时时长设置功能
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App 级别的下行推送;支持请求响应模型,支持发布订阅模型
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 API Level值修改为5
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网、设备热点配网等 新增Feature:支持设备热点配网
蓝牙 Breeze SDK 是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用

API Level 4

API Level 4发布于2018年11月,总共包含11个SDK。本次升级主要是支持在插件中使用蓝牙能力,并对蓝牙相关 SDK做了升级。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App级别的下行推送;支持请求响应模型,支持发布订阅模型
  • 新增Feature:iOS Core SDK增加stopConnect API
  • BugFix:iOS Core SDK解决接收到的topic不往上抛的问题
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 BugFix:修复对于Android 8.0系统下调试插件出现Crash的问题
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网等
蓝牙 Breeze SDK是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制 新增Feature:本地通信对蓝牙设备的支持
蓝牙OTA 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙 SDK 使用 BugFix:iOS SDK解决跟其他库同类名的编译冲突

API Level 3

API Level 3发布于2018年5月,总共包含11个SDK。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求。 新增支持国际化特性(英文语言支持)
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议 新增Feature:支持国际化
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App级别的下行推送;支持请求响应模型,支持发布订阅模型
  • 新增Feature:支持服务器地址动态配置
  • BugFix:修复长连接实例引起Bone容器崩溃
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 新增支持零配置打开官方插件(不支持打开私有插件)
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权
  • 新增Feature:支持阿里云账号
  • BugFix:修复刷新Token时callback可能引发的死循环
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网等
  • 新增Feature:新增配网埋点新增
  • Feature:配网方案更新和优化
蓝牙 Breeze SDK 是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等 新增Feature:新增埋点
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制 新增Feature:本地通信新增对网关子设备的支持
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用 新增Feature:调整SDK代码结构,业务代码OTAHelper类从SDK移除

API Level 2

API Level 2发布于2018年2月,总共包含11个SDK,在API Level1的基础上,新增了统一身份认证、配网、蓝牙、物模型、蓝牙OTA5个SDK。

SDK名称 SDK介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义。同时基于Oauth2.0协议,提供快速对接自有账号的能力,满足开发者在App开发中对接自有账号体系的需求。 新增Feature:支持自有账号登录
API通道SDK 提供了IoT官方服务的API通道,基于 HTTP 协议 新增Feature:支持账号验证的扩展能力
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App级别的下行推送;支持请求响应模型,支持发布订阅模型 新增Feature:内部逻辑优化
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 新增Feature:支持alias功能,支持配置功能
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等
统一身份认证 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权 初始版本
配网 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网等 初始版本
蓝牙 Breeze SDK是按照规范实现的手机端蓝牙SDK,方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有:设备发现连接、设备通信、加密传输、大数据传输等 初始版本
物模型 物模型SDK提供了App端的物模型(属性、事件、服务),用来开发设备界面,实现手机对设备的查看和控制 初始版本
蓝牙OTA 蓝牙OTA SDK提供蓝牙OTA业务的App端解决方案,提供了蓝牙设备固件升级的能力,需要搭配蓝牙SDK使用 初始版本

API Level 1

API Level1发布于2017年12月,总共包含6个SDK。

SDK 名称 SDK 介绍 变更内容
账号及用户 提供了标准的账号服务,提供了基本的UI界面,并支持自定义 初始版本
API通道SDK 提供了IoT官方服务的API通道,基于HTTP协议 初始版本
长连接通道 提供了App生命周期内的,适用于IoT业务场景的长连接通道,默认订阅App级别的下行推送;支持请求响应模型,支持发布订阅模型 初始版本
Bone Mobile容器 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 初始版本
移动应用推送 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求 初始版本
移动端设备网关 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等