用户管理

创建 home 的用户是该 home 的管理员，可以执行所有操作，包括添加一个客人用户到 home。任何管理员添加到这个 home 的用户(HMUser)都有一个有限的权限。客人不能更改家庭的布局，但是可以执行下面的动作：

识别智能电器
读写特性
观察特性值变化
执行动作集

比如，一个家庭的户主可以创建一个 home 布局并向其中添加家庭成员。每个家庭成员必须拥有一个 iOS 设备和 Apple ID 以及相关的 iCloud 账户。iCloud 需要个人输入的 Apple ID 和户主提供的 Apple ID 相吻合，以便让他们访问这个 home。考虑到隐私问题，Apple ID 对你的 App 是不可见的。

管理员需要遵从以下步骤来添加一个客人到 home 中：

管理员调用一个动作将客人添加到home中。
你的App调用addUserWithCompletionHandler:异步方法。
HomeKit展示一个对话框，要求输入客人的Apple ID。
用户输入客人的Apple ID。
在完成回调中返回一个新的用户。
你的App展示客人的名字。

添加一个客人到home，需要在客人的iOS设备上做以下操作：

用户在iCloud偏好设置中输入iCloud凭证(Apple ID和密码)。
用户启动你的App。
你的App通过home manager object获得一个home集合。
如果iCloud的凭证和管理员输入的Apple ID相同，那么管理员的home将会出现在homes属性中。

客人执行的操作可能会失败。如果一个异步方法中出现 HMErrorCodeInsufficientPrivileges 错误码的话，这就意味着用户没有足够的权限来执行动作-也许这个用户只是客人，而不是管理员。

为了测试你的 App 是否正确处理了客人用户，请阅读Testting Multiple iOS Devices and Users。

添加和移除用户

为了添加一个客人用户到home，请使用addUserWithCompletionHandler:异步方法。

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

想要移除 home 中的用户，请使用 HMHome 类的 removeUser:completionHandler:方法。

通过实现 HMHomeDelegate 协议中的 home:didAddUser:和 home:didRemoveUser:协议方法检查新添加和移除的用户并更新视图。关于如何创建一个delegate，请阅读Observing Changes to Individual Homes。

获得用户名

出于隐私的考虑，你的 App 对用户名只有读得权限，并不能读写用户的 Apple ID。使用 HMHome 对象的 users 属性来获取用户。使用 HMUser 类的 name 属性来获取用户名。