快速入门

更新时间:2024-06-13 09:06:32下载pdf

智能门锁采用不同协议,例如 蓝牙锁Wi-Fi 锁Wi-Fi 音视频锁Zigbee 锁。涂鸦智能门锁 SDK 是基于 智能生活 App SDK 开发而成。您可以通过本教程,在一小时内快速开发一款自己的 App,并实现如下功能:

  • 通过 App 连接一个智能门锁
  • 实现门锁设备的蓝牙连接和断开
  • 完成门锁设备控制能力:开锁和关锁

您可以单击下方按钮下载 Sample,查看本教程中的示例代码。本教程按功能模块进行分类,您可以快速找到对应的代码进行参考和学习。

前往 App 开发平台 查看 GitHub Sample

效果展示

学习完本教程,结合一定的面板开发,您可以创建一个类似以下 iOS App 的 Demo。

准备工作

在您开始本教程前,确保您已经:

  1. 在涂鸦开发者平台,注册账号并创建 App 应用,获取 SDK 的 AppKeyAppSecret。更多信息,参考 准备工作

    由于门锁 SDK 依赖于 智能生活 App SDK,您需要首先实现诸如创建账号、添加家庭的操作后,才能借助门锁 SDK 来实现门锁相关功能。更多信息,参考 智能生活 App SDK 快速入门教程

  2. 准备一个涂鸦赋能的智能门锁产品,本教程以门锁为例。关于如何获取涂鸦赋能的产品,可访问 涂鸦智选

  3. 使用 CocoaPods,将智能生活 App SDK 和门锁 SDK 集成到您的项目中。更多信息,参考 快速集成

设备配网

由涂鸦赋能的智能门锁支持智能生活 App SDK 中的所有配网方式,例如 Wi-Fi 热点配网和蓝牙配网等。更多信息,参考 涂鸦 App 配网方式

蓝牙门锁连接

在蓝牙门锁连接、开锁和关锁前,可以先判断当前门锁的蓝牙连接状态。

查询蓝牙连接状态如下:

- (BOOL)isBLEConnected;

- (BOOL)isOnline;

蓝牙门锁连接:

- (void)autoConnect;

蓝牙门锁开锁和关锁

蓝牙门锁开锁:

- (void)bleUnlock:(NSString *)lockUserId
          success:(ThingSuccessHandler)success
          failure:(ThingFailureError)failure;

蓝牙门锁关锁:

- (void)bleManualLock:(ThingSuccessHandler)success
              failure:(ThingFailureError)failure;

Wi-Fi 门锁开锁

Wi-Fi 门锁远程开锁:

- (void)replyRemoteUnlock:(BOOL)open
                  success:(nullable ThingSuccessHandler)success
                  failure:(nullable ThingFailureError)failure;

下一步

智能门锁 SDK 还提供了更多功能,您可以根据 Sample 工程和 门锁 SDK 文档了解如何构建 App。