HomeKit框架详细解析(十) —— 管理用户

版本记录

版本号 时间
V1.0 2018.01.30

前言

目前全世界都在积极投入AI领域,我国的互联网公司也是积极在AI方面进行投入布局,比如BAT以及今日头条等互联网公司都有自己的AI实验室。这里面和AI相关的目前可见的比如说智能家居,比如小米就出一款智能音响,苹果公司在这方面也不甘落后,推出框架HomeKit,接下来几篇我们就一起看一下这个框架。感兴趣的可以参考上面几篇文章。
1. HomeKit框架详细解析(一) —— 基本概览
2. HomeKit框架详细解析(二) —— HomeKit介绍 Introduction to HomeKit
3. HomeKit框架详细解析(三) —— 启用HomeKit Enabling HomeKit
4. HomeKit框架详细解析(四) —— 获取Home的布局 Getting the Home Layout
5. HomeKit框架详细解析(五) —— 创建Homes并添加配件 Creating Homes and Adding Accessories
6. HomeKit框架详细解析(六) —— 观察HomeKit数据库更改 Observing HomeKit Database Changes
7. HomeKit框架详细解析(七) —— 访问服务和特征 Accessing Services and Characteristics
8. HomeKit框架详细解析(八) —— 测试你的HomeKit APP Testing Your HomeKit App
9. HomeKit框架详细解析(九) —— 创建动作集和触发器

Managing Users - 管理用户

创建家庭的用户是家庭的管理员,并且可以执行包括将访客用户添加到家庭的所有操作。 任何管理员添加到家中的用户(HMUser)都具有受限制的权限。 客人不能以任何方式修改主页布局,但可以执行以下类型的操作:

  • 识别配件
  • 读取和写入特征值
  • 观察特征值的变化
  • 执行操作集

例如,一个家庭的负责人创建一个家庭布局,并将家庭成员添加到家中。 每个家庭成员必须拥有个人iOS设备和带有相关iCloud帐户的Apple ID。 家庭成员在其iOS设备上输入的iCloud凭据必须与负责人提供的Apple ID匹配,才能访问家庭。 出于隐私的原因,Apple ID对您的应用程序是隐藏的。

将访客添加到家庭需要在管理员的iOS设备上执行以下操作:

    1. 管理员用户调用一个动作来添加一个客人到home里。
    1. 您的应用程序调用addUserWithCompletionHandler:异步方法。
    1. HomeKit显示一个请求客人的Apple ID的对话框。
    1. 用户在对话框中输入客人的Apple ID。
    1. 完成处理程序返回新的用户对象。
    1. 你的应用显示客人的名字。

将客人添加到家中需要在客人的iOS设备上执行以下操作:

    1. 用户在iCloud首选项中输入用户的iCloud凭据(Apple ID和密码)。
    1. 用户启动您的应用程序。
    1. 您的应用程序从家庭管理器对象获取家庭的集合。
    1. 如果iCloud凭据与管理员输入的Apple ID相匹配,则管理员的主页将出现在homes属性中。

客人执行的某些操作可能会失败。如果发送到HomeKit的异步消息失败,错误代码为HMErrorCodeInsufficientPrivileges,则不允许用户执行操作 - 用户可能是来宾,而不是管理员。

要测试您的应用程序是否正确处理访客用户,请阅读Testing Multiple iOS Devices and Users。


Adding and Removing Users - 添加和移除用户

要将来宾用户添加到家庭,请使用addUserWithCompletionHandler:异步方法。

[self.home addUserWithCompletionHandler:^(HMUser *user, NSError *error) {
    if (error == nil) {
        // Successfully added a user
    }
    else {
       // Unable to add a user
    }
}];

要从家庭中删除用户,请使用 HMHome类中的removeUser:completionHandler:方法。

在其他应用程序添加和删除用户时,实现home:didAddUser:和home:didRemoveUser:的HMHomeDelegate协议中的委托方法来更新视图。 要创建家庭代理,请阅读 Observing Changes to Individual Homes。


Getting User Names - 获取用户的名字

出于隐私原因,您的应用程序对用户的名称具有只读权限,而不能读取或写入用户的Apple ID。 使用 HMHome类中的users属性来获取家庭的用户。 使用HMUser类的name属性来获取用户的名称。

后记

本篇已结束,后面更精彩~~~

你可能感兴趣的:(HomeKit框架详细解析(十) —— 管理用户)