第六部分：訪問服務(wù)和特性

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

獲得配件的服務(wù)和屬性

在依照Getting the Accessroties in a Room中描述，你創(chuàng)建了一個配件對象之后,你可以獲得配件的服務(wù)和特性。當然你也可以直接從home中按照類型獲得不同的服務(wù)。

重要:不要暴露匿名服務(wù)-比如固件升級服務(wù)-給用戶

通過HMAccessory類對象的services屬性，我們可以獲得一個配件的服務(wù)。

NSArray?*services?=?accessroy.services;

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

//?Get?all?lights?and?thermostats?in?a?home

NSArray?*lightServices?=?[home?servicesWithTypes:[HMServicesTypeLightbulb]];

NSArray?*thermostatServices?=?[home?servicesWithTypes:[HMServicesTypeThermostat]];

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

NSString?*name?=?services.name;

要獲得一個服務(wù)的特性，請使用characteristics屬性。

NSArray?*characteristics?=?service.characteristics

使用servicesType屬性來獲得服務(wù)的類型

NSString *serviceType = service.serviceType;

蘋果定義了一些服務(wù)類型，并能被Siri識別:

• 門鎖(Door locks)

• 車庫開門器(Garage door openers)

• 燈光(Lights)

• 插座(Outlets)

• 恒溫器(Thermostats)

改變服務(wù)名稱

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

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

訪問特性的值

特性代表了一個服務(wù)的一個參數(shù)，它要么是只讀、可讀寫或者只寫。它提供了這個參數(shù)可能的值的信息，比如，一個布爾或者一個范圍值。恒溫器中的溫度就是只讀的，而目標溫度又是可讀寫的。一個執(zhí)行某個任務(wù)的命令且不要求任何返回-比如播放一段聲音或者閃爍一下燈光來確認某個配件-可能就是只寫的。

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

• 亮度(Brightness)

• 最近溫度(Current temperature)

• 鎖的狀態(tài)(Lock state)

• 電源的狀態(tài)(Power state)

• 目標狀態(tài)(Target state)

• 目標溫度(Target temperature)

比如，對于一個車庫開門器來說，目標狀態(tài)就是打開或者關(guān)閉。對于一個鎖來說，目標狀態(tài)又是上鎖和未上鎖。

在你獲得了一個HMService對象之后,如?Getting Services and Their Properties所描述的,你可以獲得每個服務(wù)的特性的值。因為這些值是從配件中獲得的，這些讀寫的方法都是異步的，并可以傳入一個完成回調(diào)的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
} }];

不要以為函數(shù)調(diào)用完成就意味著寫入成功，實際上只有在當完成回調(diào)執(zhí)行并沒有錯誤產(chǎn)生時才表示寫入成功。比如，直到一個開關(guān)的特性改變之前都不要改變這個開關(guān)的狀態(tài)。在if語句塊中，加入你的代碼，以更新app的視圖。

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

創(chuàng)建服務(wù)組

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

在你創(chuàng)建了一個HMHome對象之后,如Getting the Primary Home and Collection of Homes中描述,你也就在這個家中創(chuàng)建一個服務(wù)組。

為了創(chuàng)建一個服務(wù)組,我們使用HMHome類對象的addServiceGroupWithName:completionHandler:方法。方法中參數(shù)服務(wù)組的名稱必須在此家中唯一，并可以被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:方法來向服務(wù)組中添加一個服務(wù)。服務(wù)可以在一個或多個服務(wù)組中。

[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屬性，來獲得這個家的所有服務(wù)組。

NSArray?*serviceGroups?=?self.home.serviceGroups;

通過HMServiceGroup類對象的accessory屬性，我們獲得服務(wù)所對應的智能電器。

HMAccessory?*accessory?=?service.accessory;

和配件類似，代理方法在別的app改變服務(wù)組時也會被調(diào)用。如果你的app使用了服務(wù)組，請閱讀HMHomeDelegate Protocol Reference文檔，獲悉你應該實現(xiàn)哪些方法以觀察這些變化。