We’re releasing this SDK early to gain feedback from the developer community about the future of our Android SDKs. Please file feedback about missing issues or bugs over at our issue tracker, making sure you search for existing issues and adding your voice to those rather than duplicating.
Open bug tickets | Open feature requests and suggestions | All |
The Spotify App Remote SDK allows your application to interact with the Spotify app running in the background as a service. The capabilities of this SDK include getting metadata for the currently playing track and context, issuing basic playback commands and initiating playback of tracks.
The Spotify App Remote SDK is a set of lightweight objects that connect with the Spotify app and let you control it while all the heavy lifting of playback is offloaded to the Spotify app itself. The Spotify app takes care of playback, networking, offline caching and OS music integration, leaving you to focus on your user experience. Also, with the Spotify App Remote SDK, moving from your app to the Spotify app and vice versa is a streamlined experience where playback and metadata always stay in sync.
#### Key Features
Note: While certain playback controls work offline and playback can happen offline for offlined content, apps cannot connect and start communicating with Spotify unless there is an internet connection
app-remote-lib
directorydemo
directory. The demo app includes full source code and
example uses of the APIs available in the Spotify App Remote SDK (Android) to help you get started.The download package includes comprehensive Javadoc documentation of all API classes in the docs
folder.
Some of the models in the Spotify App Remote SDK are
It could answer the following questions
Get metadata like the title of the current context that is playing - such as an album or a playlist.
Think of it as an interface to the Spotify app that lets you control some aspects of the app, query for the data, and subscribe to the events. It exposes set of API like PlayerApi and ImagesApi. You should use it as en entry point to all your interactions with the Spotify app.
Is a component that lets you receive an instance of SpotifyAppRemote.
Send playback related commands such as:
You can also subscribe to the following events:
Note: A Spotify Premium account is required to play a single track uri. You should make a call to the UserApi to get the on-demand capabilities of a user before attempting to play a single track uri.
Get user-related data and perform actions such as:
Use it to download cover arts by URI
Get a list of content
Control on what device the Spotify app should be playing music
In order to use the Spotify App Remote SDK, your application will need to get user’s permission to control playback remotely first. This can be done in two ways:
app-remote-control
scope. This approach is useful if you need to request more scopes
or an access token for other purposes, for example to communicate with
Spotify Web API.
Our Android SDK Authentication Guide
provides instructions and examples for both methods.app-remote-control
scope and show the auth view if user hasn’t agreed to it yet. Currently you
won’t be able to get the token back from the Remote SDK. It’s also not possible to request
additional scopes. The Beginner’s Tutorial contains an example on
how to use this method.Note: The Spotify Android app must be installed on the user’s device in order for the Spotify App Remote SDK to work. Please see the “Installing Spotify” section of the Content Linking guide on how to direct users to download Spotify.
Note that by using Spotify developer tools, you accept our Developer Terms of Use.