HueApi v1.0.0

First stable release of the new HueApi v1.0.0 NuGet package.
The HueApi package uses the Clip v2 API to communicate with the Hue bridge. All future functionality is added to this API.
HueApi replaces the old Q42.HueApi package.

Features

Some of the features that are available in the HueApi that were not available in the Q42.HueApi

• EventStream
• Gradient lightstrip / Gradient play lightstrip support
• Candle / Fire effects
• Entertainment groups with up to 20 addressable lights (up from 10)
• ZigBee / Matter APIs
• Support for all new APIs: Hue Developer API Reference

Migration

To make migration to the new API a bit easier, some extension methods are added in the namespace HueApi.Extensions. So make sure to add this namespace to your files.

Only use the old Q42.HueApi packages for legacy functionality (for example: HTTP access and the ColorLoop effect).
Q42.HueApi will keep working as long as the Clip V1 APIs are made available on the Hue bridges by Philips.

PR credits:

• Capture light levels into respective models (#281) @BonnieSoftware
• Remote hue api bug fix (#278) @jakubmartinik
• Added gradient mode and sparkle light effect. (#300) @burakomer
• Add IsInitialized to RemoteAuthenticationClient (#298) @isaacrlevin
• Added gradient mode and sparkle light effect. (#300) @burakomer
• NuGet publish fix (#275) @michielpost
• Bump Newtonsoft.Json from 13.0.1 to 13.0.2 in /src/Q42.HueApi.UniversalWindows.Sample (#295) @dependabot

v3.20.0

Changes

• Capture light levels into respective models (#281) @BonnieSoftware
• Remote hue api bug fix (#278) @jakubmartinik

🐛 Bug Fixes

• NuGet publish fix (#275) @michielpost

v3.19.3

Changes

• NuGet push fixes (#273) @michielpost

🚀 Features

• Add support for .NET 4.6.1 for clip V2 libraries (#272) @spudwebb
• Entertainment V2 (#269) @michielpost

🐛 Bug Fixes

• Fix RefreshToken request in RemoteAuthenticationClient and updated AccessTokenResponse model (#268) @teilmeier

v3.19.1

Changes

• Update RemoteAuthenticationClient.cs (#267) @teilmeier
• Fixed refresh token not used when token expires (#264) @StevenJDH

🚀 Features

• New HueApi packages for clip v2 API (#266) @michielpost

🧰 Maintenance

• Updated Hue OAuth Endpoint urls (#260) @michielpost

v3.18.1

Changes

• Use BlockingCollection for thread safe access #249 (#250) @michielpost
• Removed DataMember/added JsonIgnore attributes in Id properties in Hue models (#246) @Mephistofeles

New Gamut ColorConverter

The OriginalWithModel ColorConverter has been removed, Hue is no longer updating the list of models.
Lights now return a Capabilities.Control.ColorGamut property, this can be used as the input for the ColorConverter.

New:

• Gamut Color Converter
• Light.Capabilities.Control properties

Download from NuGet:
https://www.nuget.org/packages/Q42.HueApi/
https://www.nuget.org/packages/Q42.HueApi.ColorConverters/
https://www.nuget.org/packages/Q42.HueApi.Entertainment/

3.8.1

Changes:

• Support for Philips Hue API Bridge Firmware v1.28
• Packages now target netstandard2.0

Deprecated packages:

• Q42.HueApi.Net
• Q42.HueApi.WinRT

Download from NuGet:
https://www.nuget.org/packages/Q42.HueApi/
https://www.nuget.org/packages/Q42.HueApi.Entertainment/

3.6.0

Changes

• Support for Philips Hue API Bridge Firmware v1.20
• Support for the new Hue Entertainment API

More info about the new Hue Entertainment support: https://github.com/Q42/Q42.HueApi/blob/master/EntertainmentApi.md

Download from NuGet:
https://www.nuget.org/packages/Q42.HueApi/
https://www.nuget.org/packages/Q42.HueApi.Entertainment/

3.1.0

Changes

• Support for Philips Hue API Bridge Firmware v1.15
• Support for the new Capabilities API
• RemoteAuthenticationClient to get a token from the Remote API
• Working sample app for the Remote API V2

Download from NuGet:
https://www.nuget.org/packages/Q42.HueApi/

3.0.0

Changes

• Support for the Remote API V2
• Multiple ColorConverters in a seperate package

Breaking changes
Because the ColorConverters have been moved to the Q42.HueApi.ColorConverters package, you'll have to add a reference to that NuGet package and add a using for the specific ColorConverter you want to use. There are 3 ColorConverters available.
https://www.nuget.org/packages/Q42.HueApi.ColorConverters/

Remote API
The RemoteHueClient and IRemoteHueClient interface communicate with the Philips Remote Hue API V2.

Color Converters
The Philips Hue lights work with Brightness, Saturation, Hue and X, Y properties. More info can be found in the Philips Hue Developer documentation: http://www.developers.meethue.com/documentation/core-concepts#color_gets_more_complicated
It's not trivial to convert the light colors to a color system developers like to work with, like RGB or HEX. Q42.HueApi has 3 different color converters out of the box. They are in a seperate package and it's easy to create your own color converter.

• Original: The original converter based on a large XY array.

• OriginalWithModel: Does not use the large XY array, but should produce the same result and uses the lamp model.

• HSB: Converts based on Hue, Brightness and Saturation.

  How to use a color converter?
  Add one of the following usings:
  using Q42.HueApi.ColorConverters.Original
using Q42.HueApi.ColorConverters.OriginalWithModel
using Q42.HueApi.ColorConverters.HSB

  This will add extension methods to Light, State and LightCommand. So you can set the color using new RGBColor() and convert the State back to RGBColor

Download from NuGet:
https://www.nuget.org/packages/Q42.HueApi/