iOS HomeKit详解

HomeKit库是用来沟通和控制家庭自动化配件的，这些家庭自动化配件都支持苹果的HomeKit Accessory Protocol。 HomeKit应用程序可让用户发现兼容配件并配置它们。用户可以创建一些action来控制智能配件(例如恒温或者管线强弱)，对其进行分组，并且可以通过Siri触发。

HomeKit对象被存储在用户iOS设备的数据库中，并且可以通过iClound同步到其他iOS设备。HomeKit支持远程访问智能配件，并支持多个用户设备和多个用户。HomeKit还对用户的安全和隐私做了处理。

开发HomeKit应用程序的信息可以参考的文档 HomeKit User Interface Guidelines 提供了用户界面设计指南 App Store Review Guidelines: HomeKit 提供了加快app审核的技巧 HomeKit Framework Reference 描述了HomeKit框架中的类和方法 External Accessory Framework Reference 列出了系统提供的发现和配置无线智能家居产品UI HomeKit Catalog 提供示例演示HomeKit特性 WWDC 2014: Introducing HomeKit 对HomeKit更高层次的分析 iOS Security 描述HomeKit如何处理iOS上的安全和隐私

HomeKit应用服务只提供给通过AppStore发布的app应用程序。在Xcode工程中，HomeKit需要额外的配置，你的app必须有开发者证书和代码签名才能使用HomeKit，不过可以在Xcode的Capablities面板使用HomeKit，可避免代码签名的问题。

Xocde 项目的plist文件要配置 Privacy - HomeKit Usage Description 这个key，否则会奔溃，老铁，你懂得~~

Xcode将会添加HomeKit权限到你的工程授权文件中和会员中心的App ID授权文件中，也会将HomeKit框架添加到你的工程中。HomeKit 需要一个明确的App ID, 这个App ID是为了你完成这些步奏而创建的。 创建具有HomeKit功能的证书，如下图

在创建Xcode项目的时候需要勾选好Team，否则会出错

启动HomeKitde 步骤如下：

下载HomeKit Accessory Simulator

无需为了开发Homekit 应用程序而购买硬件产品。你可以使HomeKit Accessory Simulator来测试HomeKit app和模拟配件设备之间的通信。HomeKit Accessory Simulator不是和Xcode一起发布的。

下载HomeKit Accessory Simulator步骤如下：

把HomeKit Accessory Simulator拖拽到/Application文件中。

之后，你可以使用使用HomeKit Accessory Simulator测试你的HomeKit应用程序。可参考 yourHomeKit App

HomeKit允许用户创建一个或者多个Home布局。每个Home代表一个有网络涉笔的住所。用户拥有Home的数据并可通过自己的任何一条iOS设备进行访问。用户也可以和客户共享一个Home，但客户的权限会有更多限制。被置顶为Primary home的home默认是Siri指令的对象，并且不能指定home。

每个Home一般有多个room，并且每个room一般会有多个智能配件。在home中，每个房间是独立的room，并且具有一个有意义的名字，例如“卧室”或者“厨房”,这些名字可以在Siri命令中使用。一个accessory(HMAccessory)代表实际家庭中的自动化设备，例如车库开门器。每个sevice中也会有多个特征（characteristic）， 一个sevice(HMService)是accessory提供的一种实际服务，例如打开或者关闭车库，或者车库上的灯

如果你的app缓存了home布局的信息，那么当其布局发声改变的时候，app就需要更新这些信息。使用HMHomeManager对象可以从HomeKit数据库获取HMHome和其他相关的对象。获取对象后，最应该做的就是通过代理回调函数保持获取对象和HomeKit数据库同步，可参考Observing HomeKit Database Changes

使用Home Manager一个HMHomeMagager对象的访问home，room,配件，服务以及其他HomeKit对象。在创建家庭对象管理器(home manager) 之后，直接设置它的代理，以便获取到这些对象之后及时的通知你。

当你创建一个home manager对象时，HomeKit就开始从HomeKit数据库获取这些homes和相关对象，例如room和accessory对象。当HomeKit正在获取哪些对象时，home manager 的primaryHome属性时nil，并且homes属性是个空数组。你的app应该处理用户还没有完成创建home的其概况，但是app应该等待知道HomeKit完成初始化。当获取对象完成之后，HomeKit会发送homeManagerDidUpdateHomes:消息给home manager的代理。 ps：当app进入前台或者在后台Home manager属性发生改变时，这个homeManagerDidUpdateHomes： 方法就会调用，可参考Observing Changes to the Collection of Homes

homeKit允许用户有多个home，每一个home代表一个有智能设备的住所。用户拥有Home的数据并可通过自己的任何一台iOS设备进行访问。用户也可以和客户共享一个Home，但是客户的权限会有更多限制。在用户的所有home中，会有一个常用的home，即为primary home。被指定为primary home的home默认是Siri指令的对象，并且不能指定home，就是说primary home是只读的不能去设定。

我们可以通过创建一个HMHomeManager对象去管理home。使用这个HMHomeManager对象的访问home、room、配件、服务以及其他HomeKit对象

通过home manager的primaryHome属性，可以得到peimary home，代码如下：

使用home manager的homes属性可以得到用户的所有home集合，例如自家主要居所，度假别墅以及办公室。每个home都对应一个独立的home对象

在一个home中，rooms属性定义accessories的物理位置。用home的rooms属性可以枚举home中的room

*** Accessories *** *** Accessories 数组属于home，但是被指定给了home中不同的room。假如用户没有给一个accessory指定room，那么这个accessories被指定一个默认的room ,这个room是roomForEntireHome方法的返回值。用room的accessories属性可以枚举room中所有的accessory ***

*** 比如说我的home中有一个智能灯泡，一个智能冰箱，一个智能热水器，一个智能电视。我把灯泡指定给了卧室这个room，冰箱指定给了厨房这个room，热水器指定给了卫生间room。电视没有指定room，那么就默认给它指定了一个room，这个room就是 HMRoom *defultRoom = [home roomForEntireHome]。当我需要获取到我的智能硬件对象的时候，我通过home.accessories获取到的是我家的所有智能硬件，也就是灯泡，冰箱和洗衣机以及电视。如果room是卧室，我通过room.accessories获得到的就是灯泡（我这里就举一个例子，卧室也可以有多个硬件），如果room是厨房，我通过room.accessories获得到的就是冰箱 ***

示例代码：

一旦我们获取到accessory对象，我们就可以展示一个个accessory的相关信息或者访问它的服务和对象这样就可以允许用户控制它，可设置accessory的代理方法并实现这个代理方法

Accessories 数组属于home，但是被指定给了home中的room。假如用户没有给一个accessory指定room，那么这个accessories被指定一个默认的room，这个room是roomForEntireHome方法的返回值。用room的accessores属性可以枚举room中所有的accessory

如果你要展示一个个accessory的相关信息或者允许用户控制它，可设置accessory的代理方法并实现这个代理方法， 如果一旦获取到一个accessory对象，你就可以访问它的服务的对象 具体内容可参考 Observing Changes to Accessories Accessing Services and Characteristics

使用HMHome类中的accessories的方法，可以直接从Home对象中获取所有的accessory对象，而不用枚举home中的所有room对象，详情见Getting the Accessories in a Room

-- 我们所添加或者移除的这些homeKit对象都是会保存在一个共享的homeKit数据库中的。我们在自己写的homeKitAPP中添加和移除的home，room等homekit对象，在系统自带的家庭APP中的数据都是同步的。

HomeKit对象被保存在一个可以共享的HomeKit数据库里，它可以通过HomeKit框架被多个应用程序访问，所以HomeKit调用的方法都是异步写入的，并且这些方法都包含一个完成处理后的参数。如果这个方法处理成功了，你的应用将会在完成处理函数里更新本地对象。应用程序启动时，HomeKit对象发生改变的并不能收到代理回调，只能接受处理完成后的回调函数。

想要观察其他应用程序启动的HomeKit对象的变化请参阅：Observing HomeKit Database Changes。查阅异步消息完成处理后传过来的错误码的信息，请参阅：HomeKit Constants Reference.

HomeKit对象的名字，例如home，room和zone对象都可以被Siri识别，这一点已经在文档中指出。 以下几点是HomeKit对象的命名规则：

创建Homes 在HMHomeManager类中使用addHomeWithName:completionHandler: 异步方法可以添加一个home。作为参数传到那个方法中的home的名字，必须是唯一独特的，并且是Siri 可以识别的home名字。

在else语句中，写入代码以更新应用程序的视图。为了获取home manager对象，请参阅 Getting the Home Manager Object.

-- 每个Home一般有多个room，并且每个room一般会有多个智能配件。在home中，每个房间是独立的room 使用addRoomWithName:completionHandler: 异步方法可以在一个home中添加一个room对象。作为参数传到那个方法中的room的名字，必须是唯一独特的，并且是Siri可识别的room的名字。

在else语句中，写入代码更新应用程序的视图。

Accessories封装了物理配件的状态，因此它不能被用户创建。想要允许用户给家添加新的配件，我们可以使HMAccessoryBrowser对象找到一个与home没有关联的配件。HMAccessoryBrower对象在后台搜寻配件，当它找到配件的时候，使用委托来通知你的应用程序。只有在startSearchingForNewAccessories方法调用之后或者stopSearchingForNewAccessories方法调用之前，HMAccessoryBrowserDelegate消息才被发送给代理对象。

一个accessory代表一个家庭中的自动化设备，例如一个智能插座，一个智能灯具等

用自己的类名代替EditHomeViewController

用你自己的代码实现上面的accessoryBrowser:didFindNewAccessory:方法。 当然也可以实现accessoryBrowser:didRemoveNewAccessory: 这个方法来移除配件，这个配件对你的视图或者收藏来说不再是新的。

在WIFI网络环境下，为了安全的获取新的并且能够被HomeKit发现的无线配件，可参阅External Accessory Framework Reference

配件归属于home，并且它可以被随意添加到home中的任意一个room中。使用addAccessory:completionHandler:这个异步方法可以在home中添加配件。这个配件的名字作为一个参数传递到上述异步方法中，并且这个名字在配件所属的home中必须是唯一的。使用assignAccessory:toRoom:completionHandler: 这个异步方法可以给home中的room添加配件。配件默认的room是roomForEntireHome这个方法返回值room，下面的代码演示了如何给home和room添加配件

配件可提供一项或者多项服务，这些服务的特性是由制造商定义.配件的服务和特性，可参阅Accessing Services and Characteristics.

使用updateName:completionHandler: 异步方法可以改变配件的名称，代码如下：

为Homes和Room添加Bridge (桥接口)

桥接口是配件中的一个特殊对象，它允许你和其他配件交流，但是不允许你直接和HomeKit交流，例如一个桥接口可以是控制多个灯的枢纽，它使用的是自己的通信协议，而不是HomeKit配件通信协议。想要给home添加多个桥接口，你可以安装Adding Accessories to Homes and Rooms 中描述的步骤，添加任何类型的配件到home中。当你给home添加一个桥接口时，在桥接口底层的配件也会被添加到home中。正如Observing HomeKit Database Changes 中所描述的那样，每次更改通知设计模型，home的代理不会接受到桥接口的home:didAddAccessory:代理消息，而是接收一个有关于配件的home:didAddAccessory:代理消息。在home中，要把桥接口后的配件和任何类型的配件看成一样的，例如：把他们加入配件列表的配置表中，相反的是，当你给room增添一个桥接口时，这个桥接口底层的配件并不会自动添加到room中，原因是桥接口和它的配件可以位于不同的room中。

创建分区 分区(HMZone)是任意可选的房间rooms分组，例如楼上，楼下，或者卧室。房间可以被天机到一个或者多个区域

可使用addZoneWithName:completionHandler: 异步方法创建分区。所创建的行为参数传递到这个方法中分区的名称，在home中必须是唯一的，并且应该能被Siri识别。代码如下：

可使用addRoom:completionHandler:异步方法给分区添加一个room，代码如下：

每个Home都有一个HomeKit数据库。如图，HomeKit数据库会安全地和home授权的用户的iOS设备以及潜在的客人的iOS设备进行同步。为了给用户展示当前最新的数据，你的应用需要观察HomeKit数据库的变化。

HomeKit使用代理设计模式(delegate design pattern)来通知应用程序HomeKit对象的改变。一般来讲，如果你的应用程序调用了一个带有完成处理参数的HomeKit方法，并且这个方法被成功调用了，那么相关联的代理消息就会被发送给其他HomeKit应用，无论这些应用时安装在同一台iOS设备上还是远程iOS设备上。这些应用甚至可以运行在客人的iOS设备上。如果你的应用发起了数据改变，但是代理消息并没有发送到你的应用，那么添加代码到完成代理方法和相关联的代理方法中来刷新数据和更新视图就成为必须了。如果home布局发生了显著变化，那么就重新加载关于这个home的所有信息。在完成程序处理的情况下，请在更新应用之前检查那个方法是否成功。HomeKit也会调用代理方法来通知你的应用程序home网络状态的改变。

下图演示了 使用代理方法的过程：响应用户的操作，你的应用程序调用了addRoomWithName:completionHandler:方法，并没有错误发生，完成处理程序应当更新home的所有视图。如果成功了，homekit将会发送home:didAddRoom:消息给其他应用中homes的代理。因此，你实现的这个home:didAddRoom:方法也应该更新home的所有视图

应用程序只有在前台运行的时候才能接受代理消息。当你的应用在后台时，homeKit数据库的改变并不会成批处理。也就是说，如果你的应用在后台，当其他的应用成果地添加一个room到home中的时候，你的应用程序并不会接受到home:didAddRoom: 消息。当你的应用程序到前台运行时，你的应用程序将会接受到homeManagerDidUpdateHomes:消息，这个消息是表示你的应用程序要重新加载所有的数据。

设置home manager的代理并且实现HMHomeManagerDelegate协议，当primary home或者home集合发生改变时，可以接受代理消息。

所有的应用都需要实现homeManagerDidUpdateHomes:方法，这个方法在完成最初获胜homes之后被调用。对新建的home manager来说，在这个方法被调用之前，primaryHome属性的值是nil，homes数组是空的数组。当应用程序开始在前台运行时也会调用homeManagerDidUpdateHomes: 方法，当其在后台运行时数据发生改变，改homeManagerDidUpdateHomes:方法会重新加载与homes相关联的所有数据。

视图控制器注册更改通知并且执行适当的操作

展示home信息的视图控制器应该成为home对象的代理，并且当home发生改变时更新视图控制器的视图。

Bridge Note： 当你为home添加桥接口时，桥接口底层的配件会自动被添加到home中。你的代理会接收到桥接口后每个配件的 home:didAddAccessory:消息，但是你的代理不会接收到桥接口的home:didAddAccessory:消息。

观察配件的变化 配件的状态可以在任何时间发生变化。配件可能不能被获得，可以被移除，或者被关闭。请更新用户界面以反映配件状态的更改，尤其是如果你的app允许用户控制配件时。 如果从HomeKit数据库中检索到了配件对象，可以观察个别配件的变化，具体步骤如下：

如果你展示了配件的服务状态和特性，那么请执行以下代理方法来相应地更新视图

配件的服务具体内容，请参阅Accessing Services and Their Characteristics

服务(HMService)代表了一个配件(accessory)的某个功能和一些具体可读写的特性(HMCharacteristic)。一个配件可以拥有多项服务，一个服务可以有很多特性。比如一个车库开门器可能拥有一个照明和开关的服务。照明服务可能拥有打开/关闭和调节亮度的特性。用户不能制造智能家电配件和他们的服务-配件制造商会制造配件和它们的服务-但是用户可以改变服务的特性。一些拥有可读写属性的特性代表着某种物理状态，比如，一个恒温器中的当前问题就是一个只可读的值，但是目标温度又是可读写的。苹果预先定义了一些服务和特性的名称，以便让Siri能够识别它们。

在依照Getting the Accessroties in a Room 中描述，你创建了一个配件对象之后，你可以获得配件的服务和特性。当然你也可以直接从home中按照类型获得不同的服务。

通过HMAccessory类对象的services属性，我们可以获得一个配件的服务。

要获得一个home当中配件提供的特定服务，使用HMHome类对象的servicesWithTypes:方法

使用HMServices类对象的name属性来获得服务的名称

要获得一个服务的特性，可以使用characteristics属性

使用servicesType属性来获得服务的类型

NSString *serviceType = service.serviceType

苹果定义了一些服务类型，并能被Siri识别：

使用updateName:completionHandler:异步方法来改变服务名称。传入此方法的服务名称参数必须在一个home当中是唯一的，并且服务名可被Siri识别。

特性代表了一个服务的一个参数，它可以是只读，只写或者可读写，它提供了这个参数可能的值的信息，比如，一个布尔或者一个范围值。恒温器中的温度就是只读的，而目标温度又是可续写的，一个执行某个任务命令且不要求任何返回，比如播放一段声音或者闪烁一下灯光确认某个配件，可能就是只写的。

苹果定义了一些特性的类型，并能被Siri识别：

当对于一个车库开门器来说，目标状态就是打开或者关闭。对于一个锁来说，目标状态就是上锁和未上锁。

在你获得了一个HMService对象之后，如 Getting Services and Their Properties所描述的，你可以获得每个服务的特性的值。因为这些值是从配件中获得的，这些读写的方法都是异步的，并可以传入一个完成回调的block

使用readValueWithCompletionHandler:异步方法来读取一个特性的值。

使用writeValue:completionHandler:异步方法来向一个特性写入值

不要以为函数调用完成就以为这写入成功，实际上只有在当完成回调执行并没有错误产生时才表示写入成功。比如，知道一个开关的特性改变之前都不要改变这个开关的状态。在if语句中，加入你的代码，以更新app的视图

另外，在别的app更新了特性的值时也需要更新视图，在Observing Changes to Accessories中有描述。

一个服务组(HMServiceGroup)提供了控制不同配件的任意数量服务的快捷方式-比如，当用户离开家之后控制家中的某些灯。

在你创建了一个HMHome对象之后，如Getting the Primary Home and Collection of Homes中描述，你也就在这个家中创建一个服务组。

为了创建一个服务组，我们使用HMHome类对象的addServiceGroupWithName:completionHandler:方法，方法中参数服务组的名称必须在此家中唯一，并可以被Siri识别

我们使用HMServiceGroup类对象的addService:completionHandler:方法来向服务组中添加一个服务。服务可以在一个或多个服务组中。

通过HMServiceGroup类对象的accessory属性，我们获得服务所对应的智能电器。

和配件类似，代理方法在别的app改变服务组时也会被调用。如果你的app使用了服务组，请参阅HMHomeDelegate Protocol Reference文档，获悉你应该事先哪些方法以观察这些变化。

如果你没有智能电器，你可以使用HomeKit Accessroy Simulator来模拟home中的智能电器。每个模拟配件都拥有服务和特性，你可以从你的App当中控制它。你的App在HomeKit数据库中创建对象和关系。它可以创建home布局，可以添加新的配件到模拟的home环境中，最后向home中的每个房间添加只能配件，然后，你的app就能控制这些在HomeKitAccessory Simulator展示的模拟智能配件了。为了使用HomeKit Accessory Simulator，请在iOS模拟器中运行你的应用程序，或者使用Xcode在Ios设备上运行应用程序。

HomeKitAccessory Simulator是一个附加的开发者工具，怎么安装，之前已经讲过。

使用HomeKit Accessory Simulator来添加只能电器到模拟网络中。 向网络中添加只能电器配件，请按照下面的步骤添加：

一个智能电器需要一项服务和特性，你可以从app控制它。从预定了服务列表中选择一项服务，并自定义特性。

按照下面步骤向智能电器中添加服务

该配件的服务信息会展示在一个详情界面中。

注意:所有智能电器都有一个Accessory Information，显示在所有其他服务的下方。你可以向这个Accessory Information服务添加特性，但你不能删除默认的特性。

点击添加服务(Add Service)，并从弹出视图中选择一个服务类型。 新添加的服务会在右边详细显示。HomeKit Accessory Simulator为每种服务创建通用的特性。比如一个灯光服务的默认特性为色彩(Hue)，饱和度(Saturation)，亮度(Brightness)和开关。(开关特性和电源状态特性是一样的,正如 Accessing Values of Characteristics中描述的那样。）一些特性是强制性的有一些也是可选择的。比如，开关特性就是强制性的，而色彩，饱和度，亮度这些特性都是可选择的

你可以向服务中添加预定义的特性，或者自定义的特性。每种特性你都只能添加一个 按照下面的步骤向服务中添加特性

在你通过HomeKit Accessory Simulator创建了一个智能电器后，运行你的App然后添加一个新的智能电器到你的家庭。

在HomeKit Accessory Simulator中，你可以获得智能电器的服务，并在其他HomeKit App中设置服务的特性值来模拟控制这个智能电器，或者手动地模拟控制智能电器

想要控制一个智能电器你需要:

比如，为了改变一个灯泡的颜色（Hue），饱和度（Saturation）和亮度（Brightness），请滑动这个滑块。为了打开这个灯泡请选择On选项

如果你的app展示了一个服务的特性，比如灯泡的开关状态，当你在HomeKit Accessory Simulator中改变这些特性的值时，它应当更新视图。

观察HomeKit数据库的变化,可参阅Observing HomeKit Database Changes 如果你想从app中通过编写代码来控制一个智能电器，请阅读Accessing Services and Characteristics

为了模拟哪些不支持HomeKit Accessory Protocol协议的智能电器，需要添加一个虚拟桥接口，然后将智能家电添加到这个虚拟桥接口。配置虚拟桥接口底层的智能电器和配置其他类型的智能电器差不多。

添加一个虚拟桥接口到网络 具体步骤如下：

点击完成

向虚拟桥接口添加智能电器配件 可向一个虚拟桥接口添加一个或多个智能电器。

为了向一个虚拟桥接口添加一个智能电器，需要:

在HomeKit Accessory Simulator左边的列表中，选择虚拟桥接口中的一个虚拟桥接口。 在详情页面选择Add Accessory。 输入一个智能电器名字和制造商。 点击完成

将虚拟桥接口和home匹配的过程和讲一个智能电器配置到一个home的过程是一样的，可参考Adding Accessories to a Home in Your App 在虚拟桥接口底层的智能电器配件也一样被加入到了home，可参阅 Adding Bridges to Homes and Rooms

如何控制虚拟桥接口的智能电器和直接控制智能电器的步骤一致，可参阅Controlling Accessories in HomeKit Accessory Simulator除了你直接选择虚拟桥接口下的智能电器之外。

在iOS模拟器中你不能测试分享HomeKit数据库到多个iOS设备和用户。你应该安装你的App到多台iOS设备上，在这些设备中输入iCloud证书，然后运行你的App。或者，使用ad hoc授权来在多台注册设备中测试你的app。

为了测试单用户多设备环境，你应该使用同一个iCloud账户在多台设备登陆。 为了测试多用户使用同一家庭的智能电器，你应该在多台设备使用不同的iCloud账户登陆。 你的App应该应该可以允许一个用户邀请客人到你的家中，如Managing Users所述。

一个动作集合HMActionSet和触发器HMTimerTrigger允许你同时控制多个智能电器。比如，一个动作集合可能会在用户上床休息之前执行一组动作HMAction。一个写作向一个特性写入了值。动作集合中的动作是以不确定的顺序执行的。一个触发器会在一个特定的时间触发一个动作集并可以重复执行。每一个动作集合在一个家庭中都有唯一的名称并可被Siri识别。

写入动作会想一个服务的特性写入值并被加入到动作集合中去。HMAction类是HMCharacteristicWriteAction具体类的抽象基类。一个动作有一个相关联的特性对象，你可以通过Accessing Services and Characteristics中描述的来获取相关的服务和特性，然后创建这个HMCharacteristicWriteAction

为了创建一个动作，我们使用HMCharacteristicWriteAction类中的initWithCharacteristic:targetValue:方法。

在你的代码中，你使用对应的特性的期望来替换value参数，并使用对应的HMCharacteristic对象来替换characteristic参数

一个动作集就是一个共同执行的动作的集合。比如一个夜间动作集合可能包含关闭电灯，调低恒温水平和锁上房门。

为了创建一个动作集我们使用addActionSetWithName:completionHandler:异步方法

为了添加一个动作到动作集，我们使用addAction:completionHandler:异步方法

想要移除一个动作，可使用removeAction:completionHandler:方法。 想要执行一个动作集，可使用HMHome类的executeActionSet:completionHandler:方法。比如，用户希望控制所有的节日彩灯。我们就创建一个动作集来打开所有的节日彩灯，另外一个动作集来关闭所有的节日彩灯。为了打开所有的节日彩灯，发送executeActionSet:completionHandler:消息给home对象，并传递"打开节日彩灯"动作集。

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

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

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

添加一个客人到home，需要在客人的iOS设备上做一下操作： 用户在iCloud偏好设置中输入iClound凭证(Apple ID 和密码) 用户启动你的App 你的App通过home manager object 获得一个home集合 如果iClound的凭证和管理员输入的Apple ID相同，那么管理员的home将会出现在homes属性中。 客人执行的操作可能会失败。如果一个异步方法中出现HMErrorCodeInsufficientPrivileges错误码的话，这就意味着用户没有足够的权限来执行动作-也许这个用户是客人，而不是管理员。 为了测试你的App是否正确处理了客人用户，可参阅Testting Multiple iOS Devices and Users

Xcode10， iOS12 使用下面方法：

会弹出一个页面进行添加，这个地方添加时，使用Apple ID

添加之后，你添加的用户会收到一个推送消息，同意之后会看到我共享给他的所有home的信息，界面如下：

你的app对用户名只有读写权限，并不能读写用户的Apple ID。使用HMHome对象的users属性来获取用户。使用HMUser类的name属性来获取用户名。

++++++++++++++++++++++++++++++++++++++++++++++++++++++

初始化之后我们在其回调方法中可以获取到manager.homes，这是一个数组，里边是用户的全部HMhome对象，我们可以遍历这个数组获取到全部的home，通过home.name得到home的名字。代码如下：

使用homeManager对象来调用。这两个方法同样有两个回调方法来告诉我们是否操作成功

获取到HMhome对象之后可以通过home.rooms获取到该home的全部room。同样通过遍历这个数组获取到全部的HMroom对象，然后通过room.name获取到room的名字

同添加和移除home，不过是使用HMhome对象来调用

Accessories封装了物理配件的状态，因此它不能被用户创建，也就是说我们不能去创建智能硬件对象，只能通过去搜寻它，然后添加。想要允许用户给家添加新的配件，我们可以使HMAccessoryBrowser对象在后台搜寻一个与home没有关联的配件，当它找到配件的时候，系统会调用委托方法来通知你的应用程序。 具体步骤如下：

打印结果：

当你点击cell的时候，进行读写设备的数据，可以通过HomeKit Accessory Simulator 模拟器看到界面上的控件（比如开关在变化）

------------我是分哥线------------------------ 需要思考的小问题O(∩_∩)O，路过大神如果知道请赐教~~ Question： 1.添加过的设备，无法再次添加，即便把这个设备的room删除了也不行 2.在现有Room，再添加一个其他的设备，则会无法控制设备开关

演示Demo