文档

App Level 版本介绍

更新时间:
一键部署

介绍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 10

API Level 10发布于2024年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 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运营和消息告警等需求

初始版本

移动端设备网关

提供子设备的管理功能,如子设备添加删除拓扑、子设备上下线、数据上下行等