Hue (YetAnotherHueApi 1.1.0 API)

java.lang.Object
- io.github.zeroone3010.yahueapi.Hue

```
public final class Hue
extends Object
```

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class Hue.HueBridgeConnectionBuilder

Nested Classes
Modifier and Type	Class	Description
`static class`	`Hue.HueBridgeConnectionBuilder`

Constructor Summary

Constructors
Constructor	Description
`Hue(HueBridgeProtocol protocol, String bridgeIp, String apiKey)`	A basic constructor for initializing the Hue Bridge connection for this library.
`Hue(String bridgeIp, String apiKey)`	The basic constructor for initializing the Hue Bridge connection for this library.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`Collection<DaylightSensor>`	`getDaylightSensors()`	Returns all the daylight sensors configured into the Bridge.
`Optional<DimmerSwitch>`	`getDimmerSwitchByName(String switchName)`	Returns a specific dimmer switch by its name.
`Collection<DimmerSwitch>`	`getDimmerSwitches()`	Returns all the dimmer switches configured into the Bridge.
`Optional<MotionSensor>`	`getMotionSensorByName(String sensorName)`	Returns a specific motion sensor by its name.
`Collection<MotionSensor>`	`getMotionSensors()`	Returns all the motion sensors configured into the Bridge.
`Root`	`getRaw()`	Returns the raw root node information of the REST API.
`Optional<Room>`	`getRoomByName(String roomName)`	Returns a specific room by its name.
`Collection<Room>`	`getRooms()`	Returns all the rooms configured into the Bridge.
`Optional<TemperatureSensor>`	`getTemperatureSensorByName(String sensorName)`	Returns a specific temperature sensor by its name.
`Collection<TemperatureSensor>`	`getTemperatureSensors()`	Returns all the temperature sensors configured into the Bridge.
`Collection<Sensor>`	`getUnknownSensors()`	Returns all the sensors configured into the Bridge.
`Optional<Room>`	`getZoneByName(String zoneName)`	Returns a specific zone by its name.
`Collection<Room>`	`getZones()`	Returns all the zones configured into the Bridge.
`static Hue.HueBridgeConnectionBuilder`	`hueBridgeConnectionBuilder(String bridgeIp)`	The method to be used if you do not have an API key for your application yet.
`void`	`refresh()`	Refreshes the room, lamp, etc.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - Hue
```
public Hue(String bridgeIp,
           String apiKey)
```
    The basic constructor for initializing the Hue Bridge connection for this library. Use the hueBridgeConnectionBuilder method if you do not have an API key yet.
    
    Parameters:
    
    bridgeIp - The IP address of the Hue Bridge.
    
    apiKey - The API key of your application.
    
    Since:
    
    1.0.0
  - Hue
```
public Hue(HueBridgeProtocol protocol,
           String bridgeIp,
           String apiKey)
```
    A basic constructor for initializing the Hue Bridge connection for this library. Use the hueBridgeConnectionBuilder method if you do not have an API key yet.
    
    Parameters:
    
    protocol - The desired protocol for the Bridge connection. HTTP or UNVERIFIED_HTTPS, as the certificate that the Bridge uses cannot be verified. Defaults to HTTP when using the other constructor.
    
    bridgeIp - The IP address of the Hue Bridge.
    
    apiKey - The API key of your application.
    
    Since:
    
    1.0.0
- Method Detail
  - refresh
```
public void refresh()
```
    Refreshes the room, lamp, etc. data from the Hue Bridge, in case it has been updated since the application was started.
    
    Since:
    
    1.0.0
  - getRooms
```
public Collection<Room> getRooms()
```
    Returns all the rooms configured into the Bridge.
    
    Returns:
    
    A Collection of rooms.
    
    Since:
    
    1.0.0
  - getZones
```
public Collection<Room> getZones()
```
    Returns all the zones configured into the Bridge.
    
    Returns:
    
    A Collection of zones as Room objects.
    
    Since:
    
    1.1.0
  - getRoomByName
```
public Optional<Room> getRoomByName(String roomName)
```
    Returns a specific room by its name.
    
    Parameters:
    
    roomName - The name of a room
    
    Returns:
    
    A room or Optional.empty() if a room with the given name does not exist.
    
    Since:
    
    1.0.0
  - getZoneByName
```
public Optional<Room> getZoneByName(String zoneName)
```
    Returns a specific zone by its name.
    
    Parameters:
    
    zoneName - The name of a zone
    
    Returns:
    
    A zone or Optional.empty() if a zone with the given name does not exist.
    
    Since:
    
    1.1.0
  - getRaw
```
public Root getRaw()
```
    Returns the raw root node information of the REST API. Not required for anything but querying the most technical details of the Bridge setup.
    
    Returns:
    
    A Root element, as received from the Bridge REST API.
    
    Since:
    
    1.0.0
  - getUnknownSensors
```
public Collection<Sensor> getUnknownSensors()
```
    Returns all the sensors configured into the Bridge.
    
    Returns:
    
    A Collection of sensors.
    
    Since:
    
    1.0.0
  - getTemperatureSensors
```
public Collection<TemperatureSensor> getTemperatureSensors()
```
    Returns all the temperature sensors configured into the Bridge.
    
    Returns:
    
    A Collection of temperature sensors.
    
    Since:
    
    1.0.0
  - getDimmerSwitches
```
public Collection<DimmerSwitch> getDimmerSwitches()
```
    Returns all the dimmer switches configured into the Bridge.
    
    Returns:
    
    A Collection of dimmer switches.
    
    Since:
    
    1.0.0
  - getMotionSensors
```
public Collection<MotionSensor> getMotionSensors()
```
    Returns all the motion sensors configured into the Bridge.
    
    Returns:
    
    A Collection of motion sensors.
    
    Since:
    
    1.0.0
  - getDaylightSensors
```
public Collection<DaylightSensor> getDaylightSensors()
```
    Returns all the daylight sensors configured into the Bridge.
    
    Returns:
    
    A Collection of daylight sensors.
    
    Since:
    
    1.0.0
  - getTemperatureSensorByName
```
public Optional<TemperatureSensor> getTemperatureSensorByName(String sensorName)
```
    Returns a specific temperature sensor by its name.
    
    Parameters:
    
    sensorName - The name of a sensor
    
    Returns:
    
    A sensor or Optional.empty() if a sensor with the given name does not exist.
    
    Since:
    
    1.0.0
  - getMotionSensorByName
```
public Optional<MotionSensor> getMotionSensorByName(String sensorName)
```
    Returns a specific motion sensor by its name.
    
    Parameters:
    
    sensorName - The name of a sensor
    
    Returns:
    
    A sensor or Optional.empty() if a sensor with the given name does not exist.
    
    Since:
    
    1.0.0
  - getDimmerSwitchByName
```
public Optional<DimmerSwitch> getDimmerSwitchByName(String switchName)
```
    Returns a specific dimmer switch by its name.
    
    Parameters:
    
    switchName - The name of a switch
    
    Returns:
    
    A dimmer switch or Optional.empty() if a dimmer switch with the given name does not exist.
    
    Since:
    
    1.0.0
  - hueBridgeConnectionBuilder
```
public static Hue.HueBridgeConnectionBuilder hueBridgeConnectionBuilder(String bridgeIp)
```
    The method to be used if you do not have an API key for your application yet. Returns a HueBridgeConnectionBuilder that initializes the process of adding a new application to the Bridge.
    
    Parameters:
    
    bridgeIp - The IP address of the Bridge.
    
    Returns:
    
    A connection builder that initializes the application for the Bridge.
    
    Since:
    
    1.0.0

Class Hue

Nested Class Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Hue

Hue

Method Detail

refresh

getRooms

getZones

getRoomByName

getZoneByName

getRaw

getUnknownSensors

getTemperatureSensors

getDimmerSwitches

getMotionSensors

getDaylightSensors

getTemperatureSensorByName

getMotionSensorByName

getDimmerSwitchByName

hueBridgeConnectionBuilder