介绍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级别的下行推送;支持请求响应模型,支持发布订阅模型 |
|
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级别的下行推送;支持请求响应模型,支持发布订阅模型 |
|
Bone Mobile容器 | 提供了BoneMobile插件的运行环境,开发和运行BoneMobile插件时,需要集成 | 新增支持零配置打开官方插件(不支持打开私有插件) |
移动应用推送 | 提供了可用于App生命周期外的推送服务,满足App运营和消息告警等需求 | 无 |
移动端设备网关 | 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等 | 无 |
统一身份认证 | 提供基于iotToken的用户身份认证方案,通过和账号及用户SDK、API通道SDK的集成,完成用户身份凭证的生成和管理,以及发起API请求的用户身份的鉴权 |
|
配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力,具体方案包括一键广播配网(P2P)、手机热点配网、智能路由器配网以及设备间相互配网等 |
|
蓝牙 | 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运营和消息告警等需求 | 初始版本 |
移动端设备网关 | 提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等 | 无 |