如何创建商用照明 App SDK 应用？

news2024/10/6 2:21:32

商用照明 App SDK 是专为照明行业的物联网应用提供的移动端开发工具。通过商用照明 SDK，大家可以形成完整的商用照明物联网控制系统，多协议兼容，完美满足绿色建筑的设备管理及能源管理要求。

什么是涂鸦商用照明？

涂鸦商用照明解决方案 是一套完整的物联网控制系统，适用于新装和存量的商用照明市场，为其提供从设备端到软件控制端以及施工端的一套完整方案服务。通过设备管理、能源管控、人因照明等实现绿色建筑与健康建筑。

涂鸦商用照明解决方案为客户后期的产品维护与运营提供数字化、可视化的管理平台，帮助客户实现商业智能化，降低管理成本。

方案优势

涂鸦商用照明解决方案的六大核心优势：

低成本的即开即用方案
丰富的物联能力
快速增长的强大生态系统
可持续的增值服务
数字化全球项目运营管理
金融级网络数据安全

业务模式

品牌商账号下只创建一个商户账号，因此又称为 单一 SaaS 商户模式，通过此账号来创建项目 (支持创建多个项目）与管理项目下设备。商户下的项目数据共享，通过权限分配来管理项目内不同成员的使用范围。

此模式适用于为单个商户落地项目的开发者。

名词解释

账号（User）
- 用户通过手机号码、邮箱注册并登录后，即可成为涂鸦商用照明体系的一个账号。
项目（Project）
- 项目为挂载在某一账号下的可独立操作的单元，区域和设备等必须要挂载在某一项目下才可进行操作。
- 一个账号下可以有不定数量的项目，新用户在注册登录后默认是没有项目的，需进行项目的创建流程后才可进行项目维度的相关操作。
区域（Area）
- 区域是挂载在某一项目下的可独立操作的单元。
- 区域可以有不定数量的子区域。
- 最小层级的区域无法创建子区域。
- 区域下可以挂载不定数量的设备或群组等。
- 未分区（Non-assigned Area）
  - 未分区是挂载在项目下的一种特殊区域类型，是一直存在且一定存在的区域类型。
  - 未分区只会在一级区域列表中存在，在子区域列表中不会出现。
  - 特定情况下，如设备配网后，未加入到指定区域下时，设备会默认存放在未分区区域下。
  - 删除某一区域时，该区域下的设备不会被删除，而是会被转移到未分区区域下。
- 公共区域（Public Area）
  - 公共区域是挂载在某一区域下的特殊子区域，一个区域下最多只存在一个（也可能是不存在）公共区域。
  - 公共区域是非人为创建的特殊区域类型，会在特定情况下产生或消失。
  - 公共区域可以理解为父区域去除人为创建的子区域后的共享区域，为父区域与子区域的差集区域。
  区域、子区域、公共区域关系如图所示：
群组（Group）
- 群组是一个或多个设备按照一定规则的聚合体，通过对群组的控制以达到群控该群组下设备的目的。
- 组合群组是指一个或多个不同类型的小群组的聚合体，通过对组合群组的控制以达到群控该组合群组内的小群组的目的，进而控制所有小群组中的设备。
- 涂鸦商用照明SDK提供组合群组的创建、编辑、控制等能力，暂不支持对单个小群组进行操作。
- 组合群组附属于区域维度下，没有区域时无法创建组合群组。

账号、项目、区域、群组之间的关系如图所示：

创建 SDK 应用

在涂鸦 IoT 平台中 App 工作台 中点击 App 边栏下的 SDK 开发，点击创建 App。
选择 App SDK 类型。
填写 App 相关信息，点击确认。
- 应用名称：填写 App 名称。
- iOS 应用包名：填写 iOS App 包名（建议格式：com.xxxxx.xxxxx)。
- 安卓应用包名：填写安卓 App 包名（两者可以保持一致，也可以不一致）。
- 渠道标识符：不是必填项，如果不填写，系统会根据包名自动生成。
可以根据实际需求选择需要的选择方案，支持多选，然后根据 Podfile 和 Gradle 进行 SDK 的集成。
获取密钥
点击获取密钥，获取 SDK 的 AppKey、AppSecret、安全图片等信息。