Skip to content
This repository has been archived by the owner on Aug 11, 2021. It is now read-only.

Latest commit

 

History

History
executable file
·
115 lines (80 loc) · 6.88 KB

README.md

File metadata and controls

executable file
·
115 lines (80 loc) · 6.88 KB

This repository is deprecated.

Deprecation – Philips Hue SDK

We have decided to deprecate the hue SDK effective as of July 1st 2019. This means there will be no new SDK releases except for critical updates (e.g. security) which will be maintained for one additional year. Existing Hue SDK client applications will continue to work normally but we can no longer guarantee long term compatibility with future Hue software. We strongly recommend Hue SDK users to migrate to Hue API which remains up-to-date and supported.

FAQ

Why is this changing? Philips Hue has decided to focus its resources into improving the Hue API and building new features. The usage of the SDK has been declining as has our own dependence on it so we feel it is more beneficial to focus on building directly on the Hue API.

Who’s Impacted? Anyone who is leveraging the Philips Hue SDK.

Who’s Not Impacted? Anyone who is not utilizing the Philips Hue SDK.

What should you use instead? Philips Hue API

Next steps? Migration code samples and best practice blogs by Hue Developer Program.

Question? Contact us! https://developers.meethue.com/support/

See also: https://developers.meethue.com/deprecation-philips-hue-sdk/


The hue Apple SDK by Philips

(c) Copyright Philips 2012-2014 Introduction

The Hue SDK is a set of tools that are designed to make it easy to access the Hue system through the Hue Wi-Fi network connected bridge and control an associated set of connected lamps. The aim of the SDK is to enable you to create your own applications for the Hue system. The tools are provided with documentation for the SDK and example code. They are designed to be flexible, whilst easing the use of the more complex components of the system.

Supported platforms

The hue Apple SDK provides an Objective C API to access the hue system and is available and supported on the following platforms:

  • iOS platform SDK
  • Supported from iOS 5.0 and higher
  • OS X platform SDK
  • Supported from OS X 10.7 and higher

Get Started

To get started programming with the hue Apple SDK there are 2 main approaches you can take:

###Integrate the SDK into an existing or new project Depending on your choice of platform, use either HueSDK_iOS.framework or the HueSDK_OSX.framework folder from this repository.

After downloading, drag the framework folder to your Xcode project and add ‘-ObjC’ to your linker flags under your project Build Settings. Next download the files from the Lumberjack folder from this repository and add them to your project.

###Use our QuickStart app as your base Our QuickStart app is a bare bones application with minimal code for connecting and authenticating to a bridge and updating a lightstate. A good starting point for creating your own app. Depending on your choice of platform, use either the project available in the QuickStart iOS or the QuickStart OS X folder from this repository.

###Acknowledgements Please adhere to any third party licenses that are applicable on this SDK when building applications with our SDK or using the QuickStart applications as your base (see ACKNOWLEDGEMENTS file in this repository, for applicable licenses).

Swift Integration

To start using the hue Apple SDK in your Swift projects:

  • Add a new file to your project, an Objective-C .m file.

  • When asked about creating a bridge header file, say yes.

  • Remove the unused .m file you just added.

  • Add your Objective-C import statements to the created bridge header .h file, like for using the hue Apple SDK:

  • For iOS:

#import <HueSDK\_iOS/HueSDK.h>
  • For OS X:
#import <HueSDK\_OSX/HueSDK.h>

Once you’ve added the hue Apple SDK to your bridge header, you can start using the SDK in your Swift project.

SDK Guide

For general principles of the hue system and an overview of our SDK API with code examples please visit our Apple API Guide on our developer portal.

Repository Contents

  • ApplicationDesignNotes
  • Contains documentation that is useful when designing a hue application. Currently contains documentation for doing color conversion.
  • Documentation
  • Contains API documentation for each platform in docset and html format.
  • HueSDK_iOS.framework
  • Framework for the iOS platform
  • HueSDK_OSX.framework
  • Framework for the OS X platform
  • QuickStartApp_IOS
  • QuickStart application for the iOS platform
  • QuickStartApp_OSX
  • QuickStart application for the OS X platform
  • Lumberjack
  • Logging library that used by the HueSDK. Make sure you add the files in this folder to your project.

Help and Support

Stuck, need help or any suggestions on how to improve the hue Apple SDK? For now please raise an issue and one of your devs will reply shortly.

Disclaimer

Philips releases this SDK with friendly house rules. These friendly house rules are part of a legal framework; this to protect both the developers and hue. The friendly house rules cover e.g. the naming of Philips and of hue which can only be used as a reference (a true and honest statement) and not as a an brand or identity. Also covered is that the hue SDK and API can only be used for hue and for no other application or product. Very common sense friendly rules that are common practice amongst leading brands that have released their SDK’s.

Copyright (c) 2012- 2013, Philips Electronics N.V. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

  • Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

  • Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

  • Neither the name of Philips Electronics N.V. , nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOTLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FORA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.