您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發基礎

HomeKit開發指南(中文版)

編輯:iOS 開發基礎

本文由CocoaChina翻譯組成員iBenjamin_Go與淺夏@舊時光翻譯自蘋果官方開發文檔:HomeKit Developer Guide,敬請指正。
本文檔內容包括:

第一部分:簡介

第二部分:啟用HomeKit

第三部分:創建Home布局

第四部分:創建Homes與添加Accessories

第五部分:觀察HomeKit數據庫的變化

第六部分:訪問服務與特性

第七部分:測試HomeKit App

第八部分:創建動作集(Action Sets)與觸發器(Triggers)

第九部分:用戶管理

第一部分:簡介

該文檔旨在幫助你編寫HomeKit app。HomeKit庫是用來溝通並控制家庭自動化配件的,這些配件都支援蘋果的HomeKit Accessory Protocol。HomeKit應用程式可讓用戶發現相容配件並對它們進行配置。用戶可以創建一些action來控制智能配件(例如恆溫器或光線強弱),對它們進行分組,並且可以透過Siri觸發。HomeKit對象被存儲在用戶iOS設備的數據庫中,並可透過iCloud同步到其他iOS設備。HomeKit支援遠程訪問智能配件,也支援多個用戶設備與多個用戶,並對用戶的安全與隱私做了完善的處理。


注意:如果你是開發設計HomeKit硬件的供應商,你可以到Hardware Developers下的HomeKit頁面了解MFi Program的相關資訊,也可以閱讀External Accessory Programming Topics。

另請參閱

以下資源提供了更多關於創建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

HomeKit應用服務僅提供給透過App Store發布的app應用程式。在你的Xcode工程中,HomeKit應用程式需要額外的配置,你的app必須具備開發證書與代碼簽名才能使用HomeKit。在Xcode的Capabilities面板啟用HomeKit,可避免代碼簽名的問題。你無需直接在Xcode或會員中心編輯授權文件(entitlements)。

設置

為了完成本文檔中的所有步驟,你需要:

  1. 一台安裝Xcode 6或Xcode 6以上版本的Mac電腦。

  2. 為了獲得最佳體驗,你的Mac電腦最好安裝最新的OS X系統與最新的Xcode版本。

  3. 加入iOS開發者計劃。

  4. 在Member Center擁有創建代碼簽名與資源配置的權限。

在你開始使用HomeKit之前,請確保你已經完成以下任務:創建你團隊的配置文件(Provisioning Profile),請參閱App Distribution Quick Start。

當你成功完成之前的任務後,General面板中Team彈出菜單裡的錯誤信息與問題修復按鈕將會消失。代碼簽名配置被成功創建後,會展示下方的General面板。

解決代碼簽名與證書配置問題,請參閱App Distribution Guide文檔中的Troubleshooting這一節。

啟用HomeKit

想要使用HomeKit,首先要啟用它。Xcode將會把HomeKit權限添加到你的工程授權文件中與會員中心的App ID授權文件中,也會把HomeKit框架添加到你的工程中。HomeKit需要一個明確的App ID,這個App ID是為了你完成這些步驟而創建的。

啟用HomeKit的步驟如下:

  1. 在Xcode中,選擇View → Navigators → Show Project Navigator。

  2. 從Project/Targets彈出菜單中選擇target(或從Project/Targets的側邊欄選擇)。

  3. 點擊Capabilities查看你可以添加的應用服務列表。

  4. 滑到HomeKit所在的列並打開開關。

下載HomeKit Accessory Simulator

無需為了開發HomeKit應用程式而購買硬件產品。你可以使用HomeKit Accessory Simulator來測試HomeKit app與模擬配件設備之間的通信。HomeKit Accessory Simulator並不是隨Xcode一起發布的。

下載HomeKit Accessory Simulator的步驟如下:

  1. 在Capabilities面板的HomeKit分區,點擊Download HomeKit Accessory Simulator按鈕。(或選擇Xcode → Open Developer Tool → More Developer Tools)

  2. 在瀏覽器中搜索並下載「Hardware IO Tools for Xcode」.dmg文件。

  3. 在Finder中雙擊~/Downloads中的.dmg文件。

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

之後,你就能使用HomeKit Accessory Simulator來測試你的HomeKit應用程式了,正如Testing Your HomeKit App(第30頁)中描述的那樣。

第三部分:創建Home布局

HomeKit允許用戶創建一個或多個Home布局。每個Home(HMHome)代表一個有網絡設備的住所。用戶擁有Home的數據,並可透過自己的任何一台iOS設備進行訪問。用戶也可以與客人共享一個Home,但客人的權限會有更多限制。被指定為primary home的home默認是Siri指令的對象,並且不能被指定為home。

每個Home一般有多個room,每個room一般又會有多個智能配件。在home(HMHome)中,每個房間都是獨立的room,並具有一個有意義的名字,例如「臥室」或「廚房」,這些名字可以在Siri命令中使用。一個accessory(HMAccessory)代表現實家庭中的自動化設備,例如車庫開門器。一個service(HMService)則是accessory提供的一種實際服務,例如打開或關閉車庫,或者車庫上的燈。

如果你的app緩存了home布局的資訊,那麼當其布局發生改變時,app就需要更新這些資訊。使用HMHomeManager對象可以從HomeKit數據庫獲取HMHome與其他相關對象。本章描述的API在獲取對象後,你應該透過代理回調函數保持獲取的對象與HomeKit數據庫同步,具體請參看「Observing HomeKit Database Changes」。

創建Home Manager對象

使用Home Manager——一個HMHomeManager對象——來訪問home、room、配件、服務以及其他HomeKit對象。在創建家庭對象管理器(home manager)之後,直接設置它的代理,以便在獲取到這些對象後及時通知到你。

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

當你創建一個home manager對象時,HomeKit就開始從HomeKit數據庫獲取這些homes與相關對象,例如room與accessory對象。當HomeKit正在獲取那些對象時,home manager的primaryHome屬性是nil,並且homes屬性是個空數組。你的app應該處理用戶還沒有完成創建home的情況,但app應該等待直到HomeKit完成初始化。當獲取對象完成之後,HomeKit會發送homeManagerDidUpdateHomes:消息給home manager的代理。
注意:當app進入前台,或在後台時home manager屬性發生改變,這個homeManagerDidUpdateHomes:方法就會被調用,詳情請參閱「Observing Changes to the Collection of Homes」。

獲取Primary Home與Homes集合
透過home manager的primaryHome屬性,可以得到primary home,代碼如下:

HMHome *home = self.homeManager.primaryHome;

使用home manager的homes屬性可以得到用戶的所有home的集合,例如自家主要居所、度假別墅以及辦公室。每個home都對應一個獨立的home對象。

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

獲取Home中的所有room
在一個home中,rooms屬性定義了accessories的物理位置。用home的rooms屬性可以枚舉home中所有的room。

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

獲取Room中的Accessories
Accessories數組屬於home,但被指定給了home中的room。假如用戶沒有給某個accessory指定room,那麼這個accessory會被指定一個默認的room,這個room是roomForEntireHome方法的返回值。用room的accessories屬性可以枚舉room中所有的accessory。代碼如下:

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

如果你要展示某個accessory的相關資訊,或允許用戶控制它,可設置accessory的代理方法並實作這個代理方法,詳情請見「Observing Changes to Accessories」。
一旦你獲取到一個accessory對象,你就可以訪問它的服務與對象,詳情請參閱「Accessing Services and Characteristics」。

獲取Home中的Accessories屬性
使用HMHome類中的accessories方法,可以直接從Home對象中獲取所有的accessory對象,而不用枚舉home中的所有room對象(詳情請見「Getting the Accessories in a Room」)。

第四部分:創建Homes與添加Accessories

HomeKit對象被保存在一個可共享的HomeKit數據庫裡,它可以透過HomeKit框架被多個應用程式訪問。所有HomeKit調用的方法都是異步寫入的,並且這些方法都包含一個完成處理後的參數。如果這個方法處理成功了,你的應用將會在完成處理函數裡更新本地對象。應用程式啟動時,HomeKit對象發生改變的並不能收到代理回調方法,只能接受處理完成後的回調函數。

想要觀察其他應用程式啟動時HomeKit對象的變化,請參閱:Observing HomeKit Database Changes。查閱異步消息完成處理後傳過來的錯誤碼資訊,請參閱:HomeKit Constants Reference。

對象命名規則

HomeKit對象的名字,例如home、room與zone對象,都可以被Siri識別,這一點已經在文檔中指出。以下幾點是HomeKit對象的命名規則:

  • 對象名字在其命名空間內必須是唯一的。

  • 屬於用戶所有的home名字都在一個命名空間內。

  • 一個home對象及其所包含的對象在另一個命名空間內。

  • 名字只能包含數字、字母、空格以及省略號字符。

  • 名字必須以數字或字母字符開始。

  • 在名字比較時,空格或省略號會被忽略(例如home1與home 1視為同一個名字)。

  • 名字沒有大小寫之分。

想了解用戶可以使用哪些語言與Siri進行交互,請參閱HomeKit User Interface Guidelines文檔中的「Siri Integration」。

創建Homes

在HMHomeManager類中使用addHomeWithName:completionHandler:異步方法可以添加一個home。作為參數傳到那個方法中的home名字,必須是唯一獨特的,並且是Siri可以識別的home名字。

[self.homeManager addHomeWithName:@"My Home" completionHandler:^(HMHome *home, NSError *error) { if (error != nil) { // Failed to add a home } else { // Successfully added a home } }];

在else語句中,寫入代碼以更新你應用程式的視圖。為了獲取home manager對象,請參閱Getting the Home Manager Object。

在Home中增加一個Room

使用addRoomWithName:completionHandler:異步方法可以在一個home中添加一個room對象。作為參數傳到那個方法中的room名字,必須是唯一獨特的,並且是Siri可識別的room名字。

NSString *roomName = @"Living Room"; [home addRoomWithName:roomName completionHandler:^(HMRoom *room, NSError *error) { if (error != nil) { // Failed to add a room to a home } else { // Successfully added a room to a home } }];

在else語句中,寫入代碼更新應用程式的視圖。

發現配件

Accessories封裝了物理配件的狀態,因此它不能被用戶創建。想要允許用戶給家添加新的配件,我們可以使用HMAccessoryBrowser對象找到一個與home沒有關聯的配件。HMAccessoryBrowser對象會在後台搜尋配件,當它找到配件時,使用委托來通知你的應用程式。只有在startSearchingForNewAccessories方法調用之後、或stopSearchingForNewAccessories方法調用之前,HMAccessoryBrowserDelegate消息才會被發送給代理對象。

發現home中的配件

1. 在你的類接口中添加配件瀏覽器委托協議,並添加一個配件瀏覽器屬性。代碼如下:

@interface EditHomeViewController () @property HMAccessoryBrowser *accessoryBrowser; @end

用你自己的類名代替EditHomeViewController

2. 創建配件瀏覽器對象,並設置它的代理

self.accessoryBrowser = [[HMAccessoryBrowser alloc] init]; self.accessoryBrowser.delegate = self;

3. 開始搜尋配件

[self.accessoryBrowser startSearchingForNewAccessories];

4. 將找到的配件添加到你的收藏裡

- (void)accessoryBrowser:(HMAccessoryBrowser *)browser didFindNewAccessory:(HMAccessory *)accessory { // Update the UI per the new accessory; for example, reload a picker view. [self.accessoryPicker reloadAllComponents]; }

用你自己的代碼實作上面的accessoryBrowser:didFindNewAccessory:方法。當然也可以實作accessoryBrowser:didRemoveNewAccessory:這個方法來移除配件,這個配件對你的視圖或收藏來說不再是新的。

5. 停止搜尋配件

如果一個視圖控制器正在開始搜尋配件,那麼可以透過重寫viewWillDisappear:方法來停止搜尋配件。代碼如下:

- (void)viewWillDisappear:(BOOL)animated { [self.accessoryBrowser stopSearchingForNewAccessories]; }

注意:在WiFi網絡環境下,為了安全地獲取新的、並且能被HomeKit發現的無線配件,請參閱External Accessory Framework Reference。

為Home和room添加配件(Accessory)

配件歸屬於home,並且它可以被隨意添加到home中的任意一個room中。使用addAccessory:completionHandler:這個異步方法可以在home中添加配件。這個配件的名字作為一個參數傳遞到上述異步方法中,並且這個名字在配件所屬的home中必須是唯一的。使用assignAccessory:toRoom:completionHandler:這個異步方法可以給home中的room添加配件。配件默認的room是roomForEntireHome這個方法返回值的room。下面的代碼演示了如何給home與room添加配件:

// Add an accesory to a home and a room // 1. Get the home and room objects for the completion handlers. __block HMHome *home = self.home; __block HMRoom *room = roomInHome; // 2. Add the accessory to the home [home addAccessory:accessory completionHandler:^(NSError *error) { if (error) { // Failed to add accessory to home } else { if (accessory.room != room) { // 3. If successfully, add the accessory to the room [home assignAccessory:accessory toRoom:room completionHandler:^(NSError *error) { if (error) { // Failed to add accessory to room } }]; } } }];

配件可提供一項或多項服務,這些服務的特性由製造商定義。想了解配件的服務與特性,請參閱Accessing Services and Characteristics。

更改配件名稱

使用updateName:completionHandler:異步方法可以改變配件的名稱,代碼如下:

[accessory updateName:@"Kid's Night Light" completionHandler:^(NSError *error) { if (error) { // Failed to change the name } else { // Successfully changed the name } }];

為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識別。代碼如下:

__block HMHome *home = self.home; NSString *zoneName = @"Upstairs"; [home addZoneWithName:zoneName completionHandler:^(HMZone *zone, NSError *error) { if (error) { // Failed to create zone } else { // Successfully created zone, now add the rooms } }];

可使用addRoom:completionHandler:異步方法給分區添加一個room,代碼如下:

__block HMRoom *room = roomInHome; [zone addRoom:room completionHandler:^(NSError *error) { if (error) { // Failed to add room to zone } else { // Successfully added room to zone } }];

第五部分:觀察HomeKit數據庫的變化

每個Home都有一個HomeKit數據庫。如下圖所示,HomeKit數據庫會安全地與home授權的用戶的iOS設備、以及潛在的客人的iOS設備進行同步。為了給用戶展示當前最新的數據,你的應用需要觀察HomeKit數據庫的變化。

HomeKit代理方法

HomeKit使用代理設計模式(delegation 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:消息,這個消息表示你的應用程式要重新加載所有的數據。

觀察Homes集合的改變

設置home manager的代理並實作HMHomeManagerDelegate協議,當primary home或home集合發生改變時,可以接收代理消息。

所有的應用都需要實作homeManagerDidUpdateHomes:方法,這個方法在完成最初獲取homes之後被調用。對新建的home manager來說,在這個方法被調用之前,primaryHome屬性的值是nil,homes數組是空數組。當應用程式開始在前台運行時也會調用homeManagerDidUpdateHomes:方法,當其在後台運行時數據發生改變。該homeManagerDidUpdateHomes:方法會重新加載與homes相關聯的所有數據。

觀察homes的變化

1.在你的類接口中添加HMHomeManagerDelegate代理與homeManager屬性。代碼如下:

@interface AppDelegate () @property (strong, nonatomic) HMHomeManager *homeManager; @end

2.創建home manager對象並設置其代理

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { self.homeManager = [[HMHomeManager alloc] init]; self.homeManager.delegate = self; return YES; }

3. 實作homes發生改變時調用的代理方法。例如:如果多個視圖控制器展示了homes相關資訊,你可以發布一個更改通知去更新所有視圖。

- (void)homeManagerDidUpdateHomes:(HMHomeManager *)manager { // Send a notification to the other objects [[NSNotificationCenter defaultCenter] postNotificationName:@"UpdateHomesNotification" object:self]; } - (void)homeManagerDidUpdatePrimaryHome:(HMHomeManager *)manager { // Send a notification to the other objects [[NSNotificationCenter defaultCenter] postNotificationName:@"UpdatePrimaryHomeNotification" object:self]; }

視圖控制器注冊更改通知並執行適當的操作。

[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(updateHomes:) name:@"UpdateHomesNotification" object:nil]; [[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(updatePrimaryHome:) name:@"UpdatePrimaryHomeNotification" object:nil];

觀察個別home的變化

展示home資訊的視圖控制器應該成為home對象的代理,並且當home發生改變時更新視圖控制器的視圖。

觀察特定home對象的改變

1.在類接口中添加home代理協議。

@interface HomeViewController () @end

2.設置配件代理

home.delegate = self;

3.實作HMHomeDelegate協議

例如:實作home:didAddAccessory:與home:didRemoveAccessory:方法來更新展示配件的視圖。用HMAccessory類的room屬性可以獲得配件所屬的room。(對配件來說,默認的room是roomForEntireHome這個方法的返回值。)

Bridge Note:當你為home添加橋接口時,橋接口底層的配件會自動被添加到home中。你的代理會接收到橋接口後每個配件的home:didAddAccessory:消息,但你的代理不會接收到橋接口的home:didAddAccessory:消息。

觀察配件的變化

配件的狀態可以在任何時間發生變化。配件可能變得無法連接、被移除,或者被關閉。請更新用戶界面以反映配件狀態的更改,尤其是如果你的app允許用戶控制配件時。

以下步驟中,我們假設你已經從HomeKit數據庫中檢索到了配件對象,正如Getting the Accessories in a Room中描述的那樣。

觀察個別配件的變化

  1. 在類接口中添加配件代理協議。

@interface AccessoryViewController ()   @end

2. 設置配件的代理

accessory.delegate = self;

3. 實作HMAccessoryDelegate協議

比如,執行accessoryDidUpdateReachability:方法以啟用或禁用配件控制。

- (void)accessoryDidUpdateReachability:(HMAccessory *)accessory {     if (accessory.reachable == YES) {         // Can communicate with the accessory     } else {         // The accessory is out of range, turned off, etc     } }

如果你展示了配件的服務狀態與特性,那麼請執行以下代理方法來相應地更新其視圖:

accessoryDidUpdateServices:

accessory:service:didUpdateValueForCharacteristic:

想了解配件的服務,請參閱Accessing Services and Their Characteristics。

第六部分:訪問服務與特性

服務(HMService)代表了一個配件(accessory)的某個功能與一些可讀寫的特性(HMCharacteristic)。一個配件可以擁有多項服務,一個服務也可以有很多特性。比如,一個車庫開門器可能擁有一個照明與開關的服務。照明服務可能擁有打開/關閉與調節亮度的特性。用戶不能制造智能家電配件與它們的服務——配件製造商會制造配件與它們的服務——但用戶可以改變服務的特性。一些擁有可讀寫屬性的特性代表著某種物理狀態,比如,一個恆溫器中的當前溫度就是一個只可讀的值,但目標溫度又是可讀寫的。蘋果預先定義了一些服務與特性的名稱,以便讓Siri能夠識別它們。

獲得配件的服務與屬性

在依照Getting the Accessories in a Room中描述,你創建了一個配件對象之後,你可以獲得配件的服務與特性。當然你也可以直接從home中按類型獲得不同的服務。

重要:不要暴露匿名服務——比如固件升級服務——給用戶。

透過HMAccessory類對象的services屬性,我們可以獲得一個配件的服務。

NSArray *services = accessroy.services;

要獲得一個home當中配件提供的特定服務,使用HMHome類對象的servicesWithTypes:方法。

// Get all lights and thermostats in a home NSArray *lightServices = [home servicesWithTypes:[HMServicesTypeLightbulb]]; NSArray *thermostatServices = [home servicesWithTypes:[HMServicesTypeThermostat]];

使用HMServices類對象的name屬性來獲得服務的名稱

NSString *name = services.name;

要獲得一個服務的特性,請使用characteristics屬性。

NSArray *characteristics = service.characteristics

使用servicesType屬性來獲得服務的類型

NSString *serviceType = service.serviceType;

蘋果定義了一些服務類型,並能被Siri識別:

  • 門鎖(Door locks)

  • 車庫開門器(Garage door openers)

  • 燈光(Lights)

  • 插座(Outlets)

  • 恆溫器(Thermostats)

改變服務名稱

使用updateName:completionHandler:異步方法來改變服務名稱。傳入此方法的服務名稱參數必須在一個home當中是唯一的,並且服務名可被Siri識別。

[service updateName:@"Garage 1 Opener" completionHandler:^(NSError *error) {     if (error) {         // Failed to change the name     } else {         // Successfully changed the name     } }];

訪問特性的值

特性代表了一個服務的一個參數,它要麼是只讀、可讀寫,要麼是只寫。它提供了這個參數可能的值的資訊,比如一個布爾值或一個范圍值。恆溫器中的溫度就是只讀的,而目標溫度又是可讀寫的。一個執行某個任務的命令、且不要求任何返回——比如播放一段聲音,或者閃爍一下燈光來確認某個配件——可能就是只寫的。

蘋果定義了一些特性的類型,並能被Siri識別:

  • 亮度(Brightness)

  • 當前溫度(Current temperature)

  • 鎖的狀態(Lock state)

  • 電源的狀態(Power state)

  • 目標狀態(Target state)

  • 目標溫度(Target temperature)

比如,對於一個車庫開門器來說,目標狀態就是打開或關閉;對於一個鎖來說,目標狀態又是上鎖與未上鎖。

在你獲得了一個HMService對象之後,如Getting Services and Their Properties所描述的,你可以獲得每個服務的特性的值。因為這些值是從配件中獲得的,這些讀寫的方法都是異步的,並可以傳入一個完成回調的block。

使用readValueWithCompletionHandler:異步方法來讀取一個特性的值。

[characteristic readValueWithCompletionHandler:^(NSError *error) {     if (error == nil) {        // Successfully read the value        id value = characteristic.value;     }    else {         // Unable to read the value } }];

在if語句塊中,加入你的代碼以更新app的視圖。

使用writeValue:completionHandler:異步方法來向一個特性寫入值。

[self.characteristic writeValue:@42 withCompletionHandler:^(NSError *error) {     if (error == nil) {        // Successfully wrote the value     }    else {         // Unable to write the value } }];

不要以為函數調用完成就意味著寫入成功,實際上只有在完成回調執行、並沒有錯誤產生時才表示寫入成功。比如,直到一個開關的特性改變之前,都不要改變這個開關的狀態。在if語句塊中,加入你的代碼,以更新app的視圖。

另外,在別的app更新了特性的值時也需要更新視圖,這在Observing Changes to Accessories中有描述。

創建服務組

一個服務組(HMServiceGroup)提供了控制不同配件的任意數量服務的快捷方式——比如,當用戶離開家之後控制家中的某些燈。

在你創建了一個HMHome對象之後,如Getting the Primary Home and Collection of Homes中描述,你也就在這個家中創建一個服務組。

為了創建一個服務組,我們使用HMHome類對象的addServiceGroupWithName:completionHandler:方法。方法中參數服務組的名稱必須在此家中唯一,並可以被Siri識別。

[self.home addServiceGroupWithName:@"Away Lights" completionHandler:^(HMServiceGroup *serviceGroup, NSError *error) {     if (error == nil) {        // Successfully created the service group } else {        // Unable to create the service group     }];

我們使用HMServiceGroup類對象的addService:completionHandler:方法來向服務組中添加一個服務。服務可以在一個或多個服務組中。

[serviceGroup addService:service completionHandler:^(NSError *error) {     if (error == nil) {        // Successfully added service to service group     }      // Unable to add the service to the service group     }];

透過HMHome類對象的serviceGroups屬性,來獲得這個家的所有服務組。

NSArray *serviceGroups = self.home.serviceGroups;

透過HMServiceGroup類對象的accessory屬性,我們獲得服務所對應的智能電器。

HMAccessory *accessory = service.accessory;

和配件類似,代理方法在別的app改變服務組時也會被調用。如果你的app使用了服務組,請閱讀HMHomeDelegate Protocol Reference文檔,獲悉你應該實作哪些方法以觀察這些變化。

第七部分:測試HomeKit App

如果你沒有智能電器(智能配件),你可以使用HomeKit Accessory Simulator來模擬home中的智能電器。每個模擬配件都擁有服務與特性,你可以從你的App當中控制它。你的App在HomeKit數據庫中創建對象與關系。它可以創建home布局,可以添加新的配件到模擬的home環境當中,最後向home中的每個房間添加智能配件。然後,你的app就能控制這些在HomeKit Accessory Simulator展示的模擬智能配件了。為了使用HomeKit Accessory Simulator,請在iOS模擬器中運行你的應用程式,或者使用Xcode在iOS設備上運行應用程式。

HomeKit Accessory Simulator是一個附加的開發者工具,不過並沒有安裝在Xcode當中。請按照Download HomeKit Accessory Simulator中所述的安裝HomeKit Accessory Simulator。

添加智能電器(配件)

使用HomeKit Accessory Simulator來添加智能電器到模擬網絡中。

向網絡中添加智能電器配件,請按照下面的步驟添加:

  1. 在HomeKit Accessory Simulator中,點擊底部左邊的「+」按鈕。

  2. 從彈出菜單中選擇添加智能電器(Add Accessory)。

  3. 輸入智能電器的名字與製造商。

4. 點擊完成

如果想刪除一個智能電器,請選擇一個智能電器然後點擊鍵盤上的Delete鍵。

向智能電器(配件)中添加服務

一個智能電器需要一項服務與特性,你可以從app控制它。從預定義了服務列表中選擇一項服務,並自定義特性。

按照下面步驟向智能電器中添加服務:

  1. 在HomeKit Accessory Simulator中,選擇Accessories列中的某個配件。

該配件的服務資訊會展示在一個詳情界面中。

注意:所有智能電器都有一個Accessory Information,顯示在所有其他服務的下方。你可以向這個Accessory Information服務添加特性,但你不能刪除默認的特性。

2. 點擊添加服務(Add Service),並從彈出視圖中選擇一個服務類型。

新添加的服務會在右邊詳細顯示。HomeKit Accessory Simulator為每種服務創建通用的特性。比如一個燈光服務的默認特性為色彩(Hue)、飽和度(Saturation)、亮度(Brightness)與開關。(開關特性和電源狀態特性是一樣的,正如Accessing Values of Characteristics中描述的那樣。)一些特性是強制性的,有一些也是可選擇的。比如,開關特性就是強制性的,而色彩、飽和度、亮度這些特性都是可選擇的。

向服務中添加特性

你可以向服務中添加預定義的特性,或者自定義的特性。每種特性你都只能添加一個。

按照下面的步驟向服務中添加特性:

  1. 在HomeKit Accessory Simulator中,於服務詳情視圖,點擊添加特性(Add Characteristic)。

  2. 在特性類型菜單中,選擇一個類型或者自定義類型。

  3. 在其他文本框中輸入此特性的其他資訊,並點擊完成(Finish)。新添加的特性會在詳細視圖展示出來。

點擊特性右邊的減號來刪除一個特性。如果特性右邊並沒有減號顯示,這說明這個特性對這個服務來說是必須的。比如,你可以刪除電燈服務中的色彩(Hue)、飽和度(Saturation)與亮度(Brightness),但是你不可以刪除開關特性。

透過你的app向家庭中添加智能電器(配件)

在你透過HomeKit Accessory Simulator創建了一個智能電器後,運行你的App然後添加一個新的智能電器到你的家庭。

如何配對家庭中的智能電器:

1. 在Xcode中,點擊Run並調用addAccessory:completionHandler:方法(如Adding Accessories to Homes and Rooms中描述的那樣)。

2. 如果彈出了一個Add HomeKit Accessory對話框,聲明這個智能電器未被信任(這在HomeKit Accessory Simulator中是被允許的),不用管它,點擊Add Anyway。

3. 在接下來顯示的Add HomeKit Accessory對話框中,輸入智能電器的setup code然後點擊Add。

在HomeKit Accessory Simulator,setup code顯示在詳情界面智能電器名稱下。

關於如何編寫代碼來添加一個智能電器到家庭與房間,請閱讀Creating Homes and Adding Accessoris。

控制智能電器(配件)

在HomeKit Accessory Simulator中,你可以獲得智能電器的服務,並在其他HomeKit App中設置服務的特性值來模擬控制這個智能電器,或者手動地模擬控制智能電器。

想要控制一個智能電器,你需要:

  1. 在HomeKit Accessory Simulator中的智能電器列表(Accessories column)中選擇一個智能電器。這個智能電器的服務與特性會被展示在詳情界面。

  2. 操作一個特性的控件來改變它的值。

比如,為了改變一個燈泡的顏色(Hue)、飽和度(Saturation)與亮度(Brightness),請滑動這個滑塊。為了打開這個燈泡,請選擇On選項。

如果你的app展示了一個服務的特性,比如燈泡的開關狀態,當你在HomeKit Accessory Simulator中改變這些特性的值時,它應當更新視圖。

為了觀察HomeKit數據庫的變化,請閱讀Observing HomeKit Database Changes。如果你想從app中透過編寫代碼來控制一個智能電器,請閱讀Accessing Services and Characteristics。

添加橋接口

為了模擬那些不支援HomeKit Accessory Protocol協議的智能電器,需要添加一個虛擬橋接口,然後將智能電器添加到這個虛擬橋接口。配置虛擬橋接口底層的智能電器和配置其他類型的智能電器差不多。

添加一個虛擬橋接口到網絡;添加一個代表這個虛擬橋接口的智能電器。

為了添加一個虛擬橋接口到網絡,你需要:

1. 在HomeKit Accessory Simulator中,點擊智能電器列表底部的「+」按鈕。

2. 在彈出框中選擇Add 虛擬橋接口。

3. 輸入一個智能電器的名稱與製造商。

4. 點擊完成

向虛擬橋接口添加智能電器配件:可向一個虛擬橋接口添加一個或多個智能電器。

為了向一個虛擬橋接口添加一個智能電器,需要:

  1. 在HomeKit Accessory Simulator左邊的列表中,選擇虛擬橋接口中的一個虛擬橋接口。

  2. 在詳情頁面選擇Add Accessory。

  3. 輸入一個智能電器名字與製造商。

  4. 點擊完成。

想要了解虛擬橋接口中的智能電器的詳細資訊,請選擇虛擬橋接口部分中的智能電器。如果需要的話,你可以點擊虛擬橋接口旁邊的查看詳情來查看這個虛擬橋接口的智能電器。在你添加了一個服務與特性到這些智能電器之後,如Adding Services to Accessories與Adding Characteristics to Services中描述,它們會在這個虛擬橋接口被選擇之後被展示出來。

在你的App中添加虛擬橋接口到home

將虛擬橋接口和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,如Distributing Your App Using Ad Hoc Provisioning in App Distribution Guide描述。

  1. 為了測試單用戶多設備環境,你應該使用同一個iCloud賬戶在多台設備登陸。

  2. 為了測試多用戶使用同一家庭的智能電器,你應該在多台設備使用不同的iCloud賬戶登陸。

你的App應該允許一個用戶邀請客人到你的家中,如Managing Users所述。

第八部分:創建動作集(Action Sets)與觸發器(Triggers)

一個動作集合HMActionSet與觸發器HMTimerTrigger允許你同時控制多個智能電器。比如,一個動作集合可能會在用戶上床休息之前執行一組動作HMAction。一個寫動作向一個特性寫入了值。動作集合中的動作是以不確定的順序執行的。一個觸發器會在一個特定的時間觸發一個動作集,並可以重復執行。每一個動作集合在一個家庭中都有唯一的名稱並可被Siri識別。

創建寫入動作

寫入動作會向一個服務的特性寫入值,並被加入到動作集合中去。HMAction類是HMCharacteristicWriteAction具體類的抽象基類。一個動作有一個相關聯的特性對象,你可以透過Accessing Services and Characteristics中描述的方式來獲取相關的服務與特性,然後創建這個HMCharacteristicWriteAction。

為了創建一個動作,我們使用HMCharacteristicWriteAction類中的initWithCharacteristic:targetValue:方法。

HMCharacteristicWriteAction *action = [[HMCharacteristicWriteAction alloc] initWithCharacteristic:characteristic targetValue:value];

在你的代碼中,你使用對應的特性的期望值來替換value參數,並使用對應的HMCharacteristic對象來替換characteristic參數。

創建並執行動作集

一個動作集就是一個共同執行的動作的集合。比如,一個夜間動作集合可能包含關閉電燈、調低恆溫水平和鎖上房門。

為了創建一個動作集,我們使用addActionSetWithName:completionHandler:異步方法。

[self.home addActionSetWithName:@"NightTime" completionHandler:^(HMActionSet *actionSet, NSError *error) {     if (error == nil) {         // 成功添加了一個動作集     } else {         // 添加一個動作集失敗     } }];

為了添加一個動作到動作集,我們使用addAction:completionHandler:異步方法。

[actionSet addAction:action completionHandler:^(NSError *error) {     if (error == nil) {         // 成功添加了一個動作到動作集     } else {        // 添加一個動作到動作集失敗     } }];

想要移除一個動作,可使用removeAction:completionHandler:方法。

想要執行一個動作集,可使用HMHome類的executeActionSet:completionHandler:方法。比如,用戶希望控制所有的節日彩燈,我們就創建一個動作集來打開所有的節日彩燈,另外一個動作集來關閉所有的節日彩燈。為了打開所有的節日彩燈,發送executeActionSet:completionHandler:消息給home對象,並傳遞「打開節日彩燈」動作集。

創建並開啟觸發器

觸發器會執行一個或多個動作集。iOS會在後台管理和運行你的觸發器。HMTrigger類是HMTimerTrigger具體類的抽象類。當你創建一個定時觸發器時,你需要指定觸發時間與觸發的周期。創建並開啟一個定時觸發器需要多個步驟來完成。

遵循下面幾步來創建並啟動一個定時觸發器:

創建一個定時觸發器

1. 創建定時觸發器。

self.trigger = [[HMTimerTrigger alloc] initWithName:name fireDate:fireDate timeZone:niL recurrence:nil recurrenceCalendar:nil];

觸發時間必須設置在將來的某個時刻,第二個參數必須為0。如果你設置了一個周期,周期的最小值是5分鐘,最大值是5周。關於如何使用NSDateComponents與NSCalendar來設置周期,請閱讀Date and Time Programming Guide。

2. 添加一個動作集到觸發器。

使用HMTrigger基類方法addActionSet:completionHandler:來添加一個動作集到觸發器。

3. 添加一個觸發器到家庭。

使用HMHome類中的addTrigger:completionHandler:方法來添加一個觸發器到家庭。

4. 啟動觸發器。

新創建的觸發器默認是未啟動的。需要使用enable:completionHandler:方法啟動觸發器。

一個定時觸發器被啟動後,會周期性地運行它的動作集。

第九部分:用戶管理

創建home的用戶是該home的管理員,可以執行所有操作,包括添加一個客人用戶到home。任何管理員添加到這個home的用戶(HMUser)都有一個有限的權限。客人不能更改家庭的布局,但是可以執行下面的動作:

  • 識別智能電器

  • 讀寫特性

  • 觀察特性值變化

  • 執行動作集

比如,一個家庭的戶主可以創建一個home布局並向其中添加家庭成員。每個家庭成員必須擁有一個iOS設備、Apple ID以及相關的iCloud賬戶。iCloud需要個人輸入的Apple ID和戶主提供的Apple ID相吻合,以便讓他們訪問這個home。考慮到隱私問題,Apple ID對你的App是不可見的。

管理員需要遵從以下步驟來添加一個客人到home中:

1. 管理員調用一個動作將客人添加到home中。

2. 你的App調用addUserWithCompletionHandler:異步方法。

3. HomeKit展示一個對話框,要求輸入客人的Apple ID。

4. 用戶輸入客人的Apple ID。

5. 在完成回調中返回一個新的用戶。

6. 你的App展示客人的名字。

添加一個客人到home,需要在客人的iOS設備上做以下操作:

1. 用戶在iCloud偏好設置中輸入iCloud憑證(Apple ID和密碼)。

2. 用戶啟動你的App。

3. 你的App透過home manager object獲得一個home集合。

4. 如果iCloud的憑證和管理員輸入的Apple ID相同,那麼管理員的home將會出現在homes屬性中。

客人執行的操作可能會失敗。如果一個異步方法中出現HMErrorCodeInsufficientPrivileges錯誤碼的話,這就意味著用戶沒有足夠的權限來執行動作——也許這個用戶只是客人,而不是管理員。

為了測試你的App是否正確處理了客人用戶,請閱讀Testing 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屬性來獲取用戶名。

轉載請注明出處和鏈接。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved