213 Introducing Homekit PDF

Frameworks
HomeKit
Session 213
Kevin McLaughlin
Wireless Software Engineering
2014 Apple Inc. All rights reserved. Redistribution or public display not permitted without written permission from Apple.
#WWDC14
Agenda
Features
Core Concepts
Advanced Topics
Features
Common Database
Common Database
Common Database
Common Database
Light bulb
Garage door
Custom
Door lock
Remote Access
Remote Access
Remote Access
Core Concepts
Home Manager
Entry point
Common database
Manages homes
Primary home
Add or remove homes
Notifies of changes
HMHomeManager
self.homeManager = [[HMHomeManager alloc] init];
self.homeManager.delegate = self;
Retrieving Homes
- (void)homeManagerDidUpdateHomes:(HMHomeManager *)manager {
self.homes = manager.homes;
self.primaryHome = manager.primaryHome;
}
Creating a Home
[self.homeManager addHomeWithName:@Secret Lair #13
completionHandler:^(HMHome *home, NSError *error) {
if (error != nil) {
// adding the home failed; check error for why
} else {
// success!
}
}];
Home
Contains rooms, accessories, etc.
Notifies of changes
Uniquely named
Recognized by Siri
HMHome
NSString *homeName = self.home.name;
!
NSArray *allRooms = self.home.rooms;

!
NSArray *allAccessories = self.home.accessories;
Creating a Room
[self.home addRoomWithName:@Command Center completionHandler:^(HMRoom
*room, NSError *error) {
if (error != nil) {
// unable to add room. check error for why
} else {
// success!
}
}];
Room
Contains accessories
Notifies of changes
Uniquely named with a home
Recognized by Siri
HMRoom
NSArray *accessoriesInRoom = self.room.accessories;
Accessory
Corresponds to physical device(s)
Assigned to a room
Accesses device state
Notifies of changes
Recognized by Siri
Accessory
Corresponds to physical device(s)
Assigned to a room
Accesses device state
Notifies of changes
Recognized by Siri
HMAccessory
HMRoom *room = self.accessory.room;
!
NSArray *services = self.accessory.services;
HMAccessory
- (void)accessoryDidUpdateReachability:(HMAccessory *)accessory {
if (accessory.reachable == YES) {
// we can communicate with the accessory
} else {
// the accessory is out of range, turned off, etc
}
}
Services
Represents a function of an accessory
Contains characteristics of the service
May have a name
A light bulb service has a name
A firmware update service does not
Dont expose unnamed services
Names must be unique within a home
Recognized by Siri
Named and Apple-defined
HMService
NSString *name = self.service.name;
!
NSArray *characteristics = self.service.characteristics;

!
NSString *serviceType = self.service.serviceType;

!
HMAccessory *accessory = self.service.accessory;
Characteristics
Parameter of a service that allows
interaction
ON
Provides information to describe the

characteristic
Uses completion handler blocks for results
Recognized by Siri
Apple-defined
OFF
Characteristics
Parameter of a service that allows
interaction
ON
Provides information to describe the

characteristic
Uses completion handler blocks for results
Recognized by Siri
Apple-defined
OFF
Characteristics
Read-only
e.g. Current temperature
Read-write
e.g. Target temperature
Write-only
e.g. Identify
HMCharacteristic
[self.characteristic readValueWithCompletionHandler:^(NSError *error) {
if (error == nil) {
id value = self.characteristic.value;
}
}];
!
[self.characteristic writeValue:@42 withCompletionHandler:^(NSError *error) {

if (error != nil) {
// unable to write value. check error for why
}
}];
Adding New Accessories

Accessory Browser
Finds new accessories
HMAccessoryBrowser
self.accessoryBrowser = [[HMAccessoryBrowser alloc] init];
self.accessoryBrowser.delegate = self;
!
[self.accessoryBrowser startSearchingForNewAccessories];
!
later
!
[self.accessoryBrowser stopSearchingForNewAccessories];
Finding New Accessories

HMAccessoryBrowser
- (void)accessoryBrowser:(HMAccessoryBrowser *)browser didFindNewAccessory:
(HMAccessory *)accessory {
// a new accessory has been found
}
Adding New Accessories to a Home

HMHome
[self.home addAccessory:newAccessory completionHandler:^(NSError *error) {
if (error == nil) {
// success!
// assign the accessory to a room and give it a name
} else {
// adding accessory failed; check error for why
}
}];
Removing New Accessories from View

HMAccessoryBrowser
- (void)accessoryBrowser:(HMAccessoryBrowser *)browser didRemoveNewAccessory:
(HMAccessory *)accessory {
// a new accessory has been added to a home
// or has gone out of range or has been turned off
}
Testing Your App
Testing Your App

How do you test?
Testing Your App

How do you test?
HomeKit Accessory Simulator!
Demo
HomeKit Accessory Simulator

Available in Xcode 6
Acts like real accessories
Great for developing and testing HomeKit apps
Initial Setup Review

Recommended flow

Recommended flow
Create a home
User provides name

Recommended flow
Create a home
User provides name
Add rooms to the home

User provides names

Recommended flow
Create a home
User provides name
Add rooms to the home

User provides names
Add accessories
Use an accessory browser
Add accessory to home
User provides name update name for accessory
User chooses room assign accessory to room
Advanced Topics
Home Kit Accessory Profiles

Services
Characteristics
Garage door openers
Power state
Lights
Lock state
Door locks
Target state
Thermostats
Brightness
IP camera controls
Model number
Switches
Current temperature
Custom
Custom
Home Kit Accessory Profiles

Services
Characteristics
Garage door openers
Power state
Lights
Lock state
Door locks
Target state
Thermostats
Brightness
IP camera controls
Model number
Switches
Current temperature
Custom
Custom
Zones
HMZone
Rooms
Rooms
Arbitrary grouping of rooms

Example: upstairs
Rooms can be in any number of zones
Rooms
Rooms
Zone
Recognized by Siri
Rooms
Rooms
Rooms
Zones
HMZone
Arbitrary grouping of rooms
Example: upstairs
Rooms can be in any number of zones

Recognized by Siri
Rooms
Rooms
Rooms
Rooms
Zone
Rooms
Rooms
Rooms
Service Groups
HMServiceGroup
Service
Service
Arbitrary grouping of services

Example: nightlights
Services can be in any number of groups
Service
Convenient way to control services

across accessories
Service
Service Group
Service
Service
Recognized by Siri
Service
Service Groups
HMServiceGroup
Arbitrary grouping of services
Example: nightlights
Services can be in any number of groups

Convenient way to control services
across accessories
Recognized by Siri
Service
Service
Service
Service
Service Group
Service
Service
Service
Action Sets
HMActionSet
Light
off
Collection of actions that are executed

together
Example: night
Lock
doors
Light
off
Temp
down
Actions executed in undefined order
Action Set

Recognized by Siri
Switch
off
Close
garage
Close
gates
Action Sets
HMActionSet
Collection of actions that are executed
together
Example: night
Actions executed in undefined order

Recognized by Siri
Light
off
Temp
down
Lock
doors
Action Set
Switch
off
Light
off
Close
garage
Close
gates
Actions
HMCharacteristicWriteAction
Added to action sets
Light
off
Writes a value to a characteristic

Temp
down
Lock
doors
Action Set
Switch
off
Light
off
Close
garage
Close
gates
Actions
Light
off

Temp
down
Lock
doors
Action Set
Switch
off
Light
off
Close
garage
Close
gates
Actions
Light
off

Temp
down
Lock
doors
Action
Action
Set
Switch
off
Light
off
Close
garage
Close
gates
Triggers
HMTimerTrigger
On/Off
Every
Executes an action set

Fires on a specified date
Can repeat
Repeat
Date
Trigger

System executes in background
Time
Action
Delay
Triggers
HMTimerTrigger
On/Off
Every

Can repeat
Repeat
Date
Trigger

Time
Action
Delay
Triggers
HMTimerTrigger
On/Off
On
Night
Every

Can repeat
Week
Date
days
Repeat
Repeat
once
Trigger

Lock
Action
doors
Time
9PM
1Delay
hour
Demo
Action Sets and Triggers
Action Sets and Triggers

Script complex behavior
Quickly control many accessories
Why So Many Delegate Methods?
Why So Many Delegate Methods?

Shared database
Other apps can cause changes
System updates database
Accessories come and go, change state,
Wrap Up
Consistent experience through HomeKit
Easy-to-use Framework
HomeKit
http://developer.apple.com/homekit
Labs
HomeKit Lab
Services Lab A
Thursday 12:45PM
More Information
Dave DeLong
App Frameworks Evangelist
delong@apple.com
Craig Keithley
MFi and I/O Technologies Evangelist
keithley@apple.com
Documentation
http://developer.apple.com
http://developer.apple.com/mfi/
Apple Developer Forums
http://devforums.apple.com

213 Introducing Homekit PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

213 Introducing Homekit PDF

Uploaded by

Copyright:

Available Formats

Frameworks

NSArray *allRooms = self.home.rooms;

NSArray *allAccessories = self.home.accessories;

NSArray *services = self.accessory.services;

NSArray *characteristics = self.service.characteristics;

NSString *serviceType = self.service.serviceType;

HMAccessory *accessory = self.service.accessory;

Provides information to describe the

Provides information to describe the

[self.characteristic writeValue:@42 withCompletionHandler:^(NSError *error) {

Adding New Accessories

Finding New Accessories

Adding New Accessories to a Home

Removing New Accessories from View

Testing Your App

Testing Your App

Testing Your App

HomeKit Accessory Simulator

Initial Setup Review

Initial Setup Review

Initial Setup Review

Add rooms to the home

Initial Setup Review

Add rooms to the home

Home Kit Accessory Profiles

Garage door openers

Home Kit Accessory Profiles

Garage door openers

Arbitrary grouping of rooms

Rooms can be in any number of zones

Uniquely named with a home

Rooms can be in any number of zones

Arbitrary grouping of services

Services can be in any number of groups

Convenient way to control services

Services can be in any number of groups

Collection of actions that are executed

Actions executed in undefined order

Uniquely named with a home

Actions executed in undefined order

Writes a value to a characteristic

Writes a value to a characteristic

Writes a value to a characteristic

Executes an action set

Uniquely named with a home

Executes an action set

Uniquely named with a home

Executes an action set

Uniquely named with a home

Action Sets and Triggers

Why So Many Delegate Methods?

Why So Many Delegate Methods?

Accessories come and go, change state,

You might also like