简体中文
简体中文
English
联系我们
注册
登录
layout空间导航

iOS 开发指南

更新时间:2022-03-03 06:40:21下载pdf

智慧居住 iOS App SDK 提供了用户账号角色管理,空间管理,通行管理,设备配网和使用等功能,是涂鸦租住 SaaS 开发框架产品的重要组成部分。

开发者可以基于 SDK 快速实现面向终端消费者的租住生活场景功能。同时通过门锁、摄像头、传感器、温控器等智能硬件,结合租住物业管理后台实现智慧公寓租住场景功能。

功能概述

模块 功能
账号角色 账号注册登录和权限角色管理
空间管理 管理使用自有的和被授权的空间
通行管理 通行授权和密码授权
设备管理 安装管理使用智能设备
场景自动化 创建管理使用自动化场景

账号角色

智慧居住 App SDK 提供邮箱地址验证码登录能力。

  • Owner:拥有所有权限的资产所有者,包括站点和设备。
  • Admin:拥有最多权限的资产管理员。
  • Member:普通资产成员,只能使用资产,不能管理资产。

权限的高低:Owner > Admin > Member

空间管理

智慧居住 App SDK 致力于为租住业务场景的移动端开发提供各类模块和组件。因此,站点空间是抽象于全屋智能场景的概念,指用户在以家或者场所为单位的范围内所有设备、账号、权限等信息的集合。

站点管理主要包括以下能力:

  • 查询站点列表。
  • 添加、修改和移除单个站点。
  • 管理站点名称,地理位置、房间列表信息,成员信息等。
  • 站点下,设备添加、信息修改、监听移除、设备状态变化的监听等。

通行管理

主要分为以下两种通行管理方式:

  • 通行密码

    可将门锁等通行设备密码下发给指定的用户邮箱,用户即可使用收到的密码进行开门。当前只支持在线密码下发。

  • 通行成员

    如果需要长期使用通行能力,可以将指定用户设置为通行成员。通行成员只可使用通行设备。

设备管理

包括设备配网、管理和控制。

  • 设备配网

    智慧居住 App SDK 提供了把智能设备配置上路由器或网关的能力。以常见的 Wi-Fi 快连为例,SDK 从云端获取配网 Token,再经由 App 来广播配网信息(路由 ID、密码、配网 Token)。智能设备接收到后,开始快速激活,同时连接到 App 和云端,开启设备上云的第一步。

  • 设备管理

    设备管理主要提供设备相关的操作,包含设备状态变化监听、设备重命名、设备固件升级、设备移除、设备恢复出厂设置等操作。

  • 设备控制

    随着 IoT 设备的普及,如何安全、灵活地管理对设备的控制权限变得更加复杂。在以往简单的应用场景中,控制端 APP 仅仅需要对一个设备进行控制。但随着商家或用户拥有的物联网设备愈加丰富,控制端 APP 需要同时控制多个设备。

    另外,某些终端设备还需要提供给多人控制,例如家具式的智能排插能够支持被所有的家人打开或者关闭,因此就出现一个控制端 APP 能够控制多个设备端,或者多个用户能够相互控制多个设备的权限管理问题。由此出现了群组管理,智能场景等概念。