介紹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運營和消息告警等需求 | 初始版本 |
移動端設備網關 | 提供子設備的管理功能,如子設備添加刪除拓撲、子設備上下線、數據上下行等 | 無 |