README.md

Hue Expression

A demo iOS app that uses ARKit's face-tracking capabilities and the Phillip's Hue SDK to recognize your facial expressions and change the color of your Hue lights according to your expression.

Requirements

In order to run this demo app you will need:

• Xcode 9.2 or above
• An iPhone X
• 1 Phillips Hue Color Ambiance bulb
• The Phillips Hue iOS app

Setup

1. Clone this repo
2. In Xcode, open ServerController.swift and replace hueBridgeIP with this IP address (see below)
3. In Xcode, open ServerController.swift and replace hueUsername with your authenticated username (see below)
4. Run the app to your iPhone X

Getting Your Bridge's IP

1. Open the Phillip's Hue iOS app
2. Go to Settings>Hue Bridges>Select your Bridge and get the IP Address

Getting an Authenticated Hue Username

Note: If you have any trouble with this part, you can find a walkthrough on the Hue Developer Site.

1. Run the following command in terminal (replacing IP_ADDRESS_HERE with the IP address of your Hue bridge)

curl -X POST \
  http://<IP_ADDRESS_HERE>/api/ \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -d '{"devicetype":"hue_expressionp#iphone user"}'

2. Press the link button on your Hue Bridge
3. Run the above command again
4. Grab the username value from the response JSON

Resources

• Apple's Face Tracking with AR Kit WWDC video
• Apple's Creating Face-Based AR Experiences
• Apple's documentation on Blend Shapes
• Phillip's Hue developer site