HomeKit框架详细解析（四） —— 获取Home的布局 Getting the Home Layout

版本记录

版本号	时间
V1.0	2018.01.29

前言

目前全世界都在积极投入AI领域，我国的互联网公司也是积极在AI方面进行投入布局，比如BAT以及今日头条等互联网公司都有自己的AI实验室。这里面和AI相关的目前可见的比如说智能家居，比如小米就出一款智能音响，苹果公司在这方面也不甘落后，推出框架HomeKit，接下来几篇我们就一起看一下这个框架。感兴趣的可以参考上面几篇文章。
1. HomeKit框架详细解析（一） —— 基本概览
2. HomeKit框架详细解析（二） —— HomeKit介绍 Introduction to HomeKit
3. HomeKit框架详细解析（三） —— 启用HomeKit Enabling HomeKit

Getting the Home Layout - 获取Home的布局

HomeKit允许用户为其一个或多个家庭创建布局。 一个家（HMHome）代表一个单一的住宅，有一个配件网络。 家庭数据由用户拥有，可以从任何用户的iOS设备访问。 用户还可以与访问受限的访客共享一个家。 一个家庭被指定为主家庭，并且是没有指定家庭的Siri命令的默认家庭。

每个home可能有多个room和配件添加到每个房间。 房间（HMRoom）代表家中的一个单独的房间。 它有一个有意义的名字，比如可以在Siri命令中使用的living room 或者kitchen，一个配件（HMAccessory）是一个物理的家庭自动化设备，比如一个车库门开启器，一个服务（HMService） 由配件提供的实际服务，例如打开和关闭车库门或车库门开启器上的灯。

如果您的应用缓存关于家庭布局的信息，则在家庭布局更改时需要更新该信息。 使用HMHomeManager对象从HomeKit数据库中获取HMHome和相关的对象。 在使用本章描述的API获取对象后，通过代理回调使对象与数据库保持同步，如 Observing HomeKit Database Changes中所述。

---

Getting the Home Manager Object - 获取Home管理器对象

使用home管理器（一个HMHomeManager对象）访问home，room，配件，服务和其他HomeKit对象。 在创建home管理器之后立即设置它的代理，以便在这些对象的初始获取完成时得到通知。

self.homeManager = [[HMHomeManager alloc] init];
self.homeManager.delegate = self;

当您创建一个家庭管理器对象时，HomeKit开始从HomeKit数据库获取家庭和关联的对象，例如房间和配件对象。 当HomeKit获取这些对象时，home管理器的primaryHome属性值为nil，而homes属性为空数组。 您的应用程序应该处理用户尚未创建家庭的情况，但应用程序不应该像HomeKit完成初始获取之前那样没有家庭。 当提取完成时，HomeKit将homeManagerDidUpdateHomes:消息发送到home管理器的代理。

Note: The homeManagerDidUpdateHomes: method is also invoked when the app comes to the foreground and changes occurred while it was in the background, as described in Observing Changes to the Collection of Homes. 注意：当应用程序进入前台时，homeManagerDidUpdateHomes：方法也会被调用，而在后台进行更改时也会调用该方法，如Observing Changes to the Collection of Homes中所述。

---

Getting the Primary Home and Collection of Homes - 获得主要Home和其他Homes

要获得主要home，请使用home管理器的primaryHome属性。

HMHome *home = self.homeManager.primaryHome;

使用home 管理者的homes属性，以获得所有的用户的homes，例如，主要居所，度假屋和办公室。 每个home由一个单独的home对象代表。

HMHome *home;
for (home in self.homeManager.homes){
      ...
}

---

Getting the Rooms in a Home - 获取Home中的Rooms

Rooms定义了home中配件的物理位置。 要列举home的rooms，请使用home的rooms属性。

HMHome *home = self.homeManager.primaryHome;
HMRoom *room;
for (room in home.rooms){
    …
}

---

Getting the Accessories in a Room - 获取Room中的配件

配件属于在一个home中，但分配到一个home中的room内部。 如果用户未将配件分配给room，那么配件将分配给由roomForEntireHome方法返回的默认room。 要列举一个room里的配件，使用room的accessories属性。

HMAccessory *accessory;
for (accessory in room.accessories){
    …
}

如果显示有关附件的信息或允许用户控制附件，请按照Observing Changes to Accessories中所述设置附件的代理并执行附件代理方法。

一旦你有一个附件对象，你可以访问它的服务和它们的特性，如Accessing Services and Characteristics所述。

---

Getting Accessories in a Home - 获取Home中的附件

要直接从home对象中获取所有配件，而无需列举家home中的房间rooms（如Getting the Accessories in a Room中所述），请使用HMHome类中的accessories方法。

后记

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