Android 开发指南

智慧居住安卓 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 能够控制多个设备端，或者多个用户能够相互控制多个设备的权限管理问题。由此出现了群组管理，智能场景等概念。