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

Posted 2023-01-14 IoT砖家涂拉拉

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

什么是涂鸦商用照明？

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

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

方案优势

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

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

业务模式

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

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

名词解释

• 账号（User）

  • 用户通过手机号码、邮箱注册并登录后，即可成为涂鸦商用照明体系的一个账号。

• 项目（Project）

  • 项目为挂载在某一账号下的可独立操作的单元，区域和设备等必须要挂载在某一项目下才可进行操作。
  • 一个账号下可以有不定数量的项目，新用户在注册登录后默认是没有项目的，需进行项目的创建流程后才可进行项目维度的相关操作。

• 区域（Area）

  • 区域是挂载在某一项目下的可独立操作的单元。

  • 区域可以有不定数量的子区域。

  • 最小层级的区域无法创建子区域。

  • 区域下可以挂载不定数量的设备或群组等。

  • 未分区（Non-assigned Area）

    • 未分区是挂载在项目下的一种特殊区域类型，是一直存在且一定存在的区域类型。
    • 未分区只会在一级区域列表中存在，在子区域列表中不会出现。
    • 特定情况下，如设备配网后，未加入到指定区域下时，设备会默认存放在未分区区域下。
    • 删除某一区域时，该区域下的设备不会被删除，而是会被转移到未分区区域下。

  • 公共区域（Public Area）

    • 公共区域是挂载在某一区域下的特殊子区域，一个区域下最多只存在一个（也可能是不存在）公共区域。
    • 公共区域是非人为创建的特殊区域类型，会在特定情况下产生或消失。
    • 公共区域可以理解为父区域去除人为创建的子区域后的共享区域，为父区域与子区域的差集区域。

    区域、子区域、公共区域关系如图所示：

    

• 群组（Group）

  • 群组是一个或多个设备按照一定规则的聚合体，通过对群组的控制以达到群控该群组下设备的目的。
  • 组合群组是指一个或多个不同类型的小群组的聚合体，通过对组合群组的控制以达到群控该组合群组内的小群组的目的，进而控制所有小群组中的设备。
  • 涂鸦商用照明SDK提供组合群组的创建、编辑、控制等能力，暂不支持对单个小群组进行操作。
  • 组合群组附属于区域维度下，没有区域时无法创建组合群组。

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

创建 SDK 应用

1. 在 涂鸦 IoT 平台 中 App 工作台 中点击 App 边栏下的 SDK 开发，点击创建 App。

   

2. 选择 App SDK 类型。

   

3. 填写 App 相关信息，点击确认。

   • 应用名称：填写 App 名称。
   • iOS 应用包名：填写 ios App 包名（建议格式：com.xxxxx.xxxxx)。
   • 安卓应用包名：填写安卓 App 包名（两者可以保持一致，也可以不一致）。
   • 渠道标识符：不是必填项，如果不填写，系统会根据包名自动生成。

4. 可以根据实际需求选择需要的选择方案，支持多选，然后根据 Podfile 和 Gradle 进行 SDK 的集成。

5. 获取密钥
   点击获取密钥，获取 SDK 的 AppKey、AppSecret、安全图片等信息。

   

1. IoT后台创建 App 成功后，将创建的应用的包名提供给到涂鸦，并由商务转交相关信息给云端进行客户项目的创建等相关配套操作。
2. 安卓端从1.9.7版本开始，需要设置SHA256。

以上步骤完成后，SDK 才可正常使用。