q42 / jue

Philips Hue API for Java

2014-12-06: This Library is Unmaintained

This library was created by Q42 in August of 2013, but is no longer being maintained. As of December 2014, the library is already out of date with the official Hue API.

This repository has been kept online for future reference, but it might be removed at a later date. It is provided under the MIT license, so feel free to fork and modify.

See hue-libs for a list of other Hue libraries.

---

The README from August 2013:

Jue

Jue is a Java library allowing developers to easily use the features offered by a Philips Hue bridge. All publicly documented API features have been implemented, along with group creation and deletion.

It is designed with Android compatibility in mind and we encourage you to use it in your apps!

Documentation

If this is your first time using the library, have a look at the wiki pages for tutorials to learn how to use this library. These will outline the organization and usage patterns.

If you're looking for a reference, you can find Javadoc here. Great care was taken to properly document all functions and classes and it is updated after every change.

License

Jue is licensed under MIT, of which the terms are outlined in the LICENSE file.

Also included is a copy of the GSON library, licensed under the Apache License 2.0, of which the terms can be found here.

jue's Issues

BridgeDiscovery.searchPortal() mismatched return type.

Hi!

First of all, thanks for making this library. It's far more useful and easy to follow then the offical Phillips version of the SDK.

I've been working on an android app to control Hue, when I kept getting the exception:

nl.q42.jue.PortalDiscoveryResult cannot be cast to nl.q42.jue.HueBridge 

I believe this error is caused in the PortalDiscoveryResult class at this line:
https://github.com/Q42/Jue/blob/master/jue/src/nl/q42/jue/PortalDiscoveryResult.java#L9

When I change it to:

public final static Type gsonType = new TypeToken<List<HueBridge>>(){}.getType(); 

It works as desired and I do not get the exception. Is having the gsonType return a list of PortalDiscoveryResults desired? When using the method as shown in your documentation, it causes the error, making me believe this is a bug. If it is, I would be more then happy to open a pull request with the changes.

Thank you!