API Level版本介绍

更新时间：2019-01-03 15:35:39

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列表。

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

API Level 4

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

请参见如下表格：

API Level 3

API Level 3 发布于 2018 年 5 月，总共包含 11 个 SDK，请参见如下表格：

| 新增Feature:新增建联接口 |
| 统一身份认证 | 提供基于 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 Level 1 的基础上，新增了统一身份认证、配网、蓝牙、设备模型、蓝牙 OTA 5个 SDK 请参见如下表格：

| 新增Feature:OTA等Topic规则的支持 |
| 统一身份认证 | 提供基于 iotToken 的用户身份认证方案，通过和账号及用户SDK、API通道SDK的集成，完成用户身份凭证的生成和管理，以及发起API请求的用户身份的鉴权 | 初始版本 |
| 配网 | 提供了把WiFi设备配置上家庭路由器以及局域网内已联网设备的发现能力，具体方案包括一键广播配网（P2P）、手机热点配网、智能路由器配网以及设备间相互配网等。 | 初始版本 |
| 蓝牙 | Breeze SDK 是按照规范实现的手机端蓝牙SDK，方便合作厂商在手机端快速接入蓝牙功能。Breeze SDK包含的主要功能有：设备发现连接，设备通信，加密传输，大数据传输等 | 初始版本 |
| 设备模型 | 设备模型 SDK 提供了 App 端的设备模型（属性，事件，服务），用来开发设备界面，实现手机对设备的查看和控制 | 初始版本 |
| 蓝牙 OTA | 蓝牙 OTA SDK 提供蓝牙 OTA 业务的 APP 端解决方案，提供了蓝牙设备固件升级的能力。需要搭配蓝牙 SDK 使用。 | 初始版本 |

API Level 1

API Level 1 发布于 2017 年 12 月，总共包含 6 个 SDK，请参见如下表格：

| 初始版本 |