Skip to content

nightowlengineer/sonos-api-java

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

84 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sonos API client for Java

This library provides a simple integration with the Sonos API, allowing you to control players and content from any Java app.

Please note that this library is currently still in development. Some aspects (particularly with the SMAPI) cannot be tested due to a lack of access, others due to not owning devices with specific features.

Build Status

Prerequisites

Before using the library, it's recommended that you read the official documentation published on the Sonos Developer site. The reference documentation is also detailed and provides a good overview of the many different resources and endpoints open to you.

You'll need to register with Sonos, create a Control Integration, and finally generate client credentials to be able to connect with the Sonos API. It's also recommended that you have at least one Sonos device to be able to properly test and play with your application (plus, listening to music or watching movies with Sonos is awesome anyway!)

Maven Setup

<dependency>
  <groupId>engineer.nightowl</groupId>
  <artifactId>sonos-api-java</artifactId>
  <version><LATEST-VERSION></version>
</dependency>

Getting Started

Create a new configuration object, set your integration's properties (see further above on how to obtain these), then create a client and pass in that configuration:

final SonosApiConfiguration configuration = new SonosApiConfiguration();
configuration.setApiKey(properties.getProperty("apiKey"));
configuration.setApiSecret(properties.getProperty("apiSecret"));
configuration.setApplicationId(properties.getProperty("applicationId"));

final SonosApiClient client = new SonosApiClient(configuration);

Then use the client to view and modify the user's devices - the following types of resource are available:

  • audioClip
  • authorize
  • favorite
  • group
  • groupVolume
  • homeTheater
  • household
  • musicServiceAccounts
  • playbackMetadata
  • playback
  • playbackSession
  • playerVolume
  • playlist
  • settings

For example, to set all 'groups' (aka rooms) to use crossfade when music is playing, you could run the following:

final SonosGroups groups = client.group().getGroups("authToken", "householdId");
final SonosPlayMode playMode = new SonosPlayMode();
playMode.setCrossfade(true);

for (final SonosGroup group : groups.getGroups())
{
    client.playback().setPlayModes("authToken", group.getId(), playMode);
}

About

Unofficial Java client for the Sonos API

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages