v3.0.0

Changes

• New Fluent API
• Every resource has it's own endpoint.

Fluent API example:

var allLights = await localHueClient.Light.GetAllAsync();      
var lightById= await localHueClient.Light.GetByIdAsync(id);

var allButtons= await localHueClient.Button.GetAllAsync();
etc

This makes the library more consistent to use and it's easier to identify and match with APIs from the Philips Hue documentation.

All existing methods are still available, but marked obsolete. They will be removed in the future.

🚀 Features

• Added option to send Identify command to a Light and updated properties for Entertainment resources

🐛 Bug Fixes

• Quality improvements in setting up a streaming/entertainment connection

Getting Started

See the updated README for instructions on how to use this library.
Latest version is available on NuGet: https://www.nuget.org/packages/HueApi

v2.1.0

🚀 Features

• Added BaseHueApi-ByType.cs (#329) @michielpost
• Added SetBaseAddress and GetResourceAsync API (#328) @michielpost

v2.0.0

🚀 Features

• Added support for new Hue Bridge Pro APIs
• Added gradient mode and sparkle light effect. (#300) @burakomer
• Add IsInitialized to RemoteAuthenticationClient (#298) @isaacrlevin

🐛 Bug Fixes

• Added gradient mode and sparkle light effect. (#300) @burakomer
• NuGet publish fix (#275) @michielpost

Contributions

• Added PackageLicenseExpression with MIT license to all publishable projects (#314) @AleksandarDev
• Add ZLLRelativeRotary model properties to support Hue Tap Dial switch (#307) @BenjaminGreene
• Capture light levels into respective models (#281) @PonchoPowers
• Remote hue api bug fix (#278) @jakubmartinik

Install

Download the latest HueApi packages from NuGet:

• HueApi from NuGet
• HueApi.ColorConverters from NuGet
• HueApi.Entertainment from NuGet

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/